EN DE ES FR IT NL

Bienvenido a Trakkit.org

Trakkit.org es el front-end de un motor de renderizado de tracks para navegación a vela de recreo y oceánica.

Te permite:

  • Crear, ver y compartir tracks de navegación.
  • Integrarlos en aplicaciones o sitios web.
  • Compartir tracks mediante un enlace web simple o directamente desde la página de inicio del sitio web.
  • Habilitar el seguimiento en tiempo real mediante cargas automáticas de datos NMEA, GPX o TEXT vía email o SFTP.
  • Actualizar automáticamente tu posición en NoForeignLand.

Trakkit.org no recopila ningún dato personal.

🚀 Inicio rápido

Para ayudarte a empezar y familiarizarte rápidamente, sigue estos pasos:

  1. Crea una cuenta (gratis)
  2. Crea un Boat
  3. Se han creado automáticamente un conjunto de datos de ejemplo y un Track de prueba.
  4. Prueba el Track de ejemplo visitando: https://<boatname>.trakkit.org
  5. Sube tus propios datos usando un archivo .GPX normal: DATA > Upload
  6. Crea un track: TRACK > Add Track para elegir qué parte de los datos quieres mostrar
  7. Se asigna un TTR ID, y el track puede compartirse en: https://trakkit.org/ttr/<TRACK-ID-TTR>

NB: El conjunto de datos de ejemplo se elimina automáticamente en cuanto empiezas a subir tus propios datos.

📚 Documentación general

Todo en Trakkit.org gira en torno a tres objetos:

  • Boat
  • Data
  • Track

Data está vinculada a un boat. Un track es un segmento de data entre dos fechas.

🔧 ¿Cómo funciona?

Es esencial entender que en Trakkit, la data no está vinculada a los tracks. La data puede enviarse continuamente. Los tracks simplemente definen rangos de fechas dentro de los cuales la data correspondiente es visible. Eliminar un track no afecta a la data. La data solo es visible si se define un track para hacerla visible. La misma data puede aparecer en varios tracks.

Estructura básica:

  • 1 User puede tener varios Boats
  • 1 Boat pertenece solo a 1 user
  • 1 Boat puede tener tantos Tracks como sea necesario
  • Varios Tracks pueden usar la misma Data
  • Eliminar un Track no afecta a la Data



🛥️ Boat


Crear un boat es el primer paso necesario para importar data y asociar tracks.


📝 Campos disponibles


  • Name (obligatorio): Identifica el boat.
  • Maxspeed: En nudos. Se usa para detectar posibles anomalías de puntos GPS (p. ej., velocidades poco realistas).
  • Info: Un campo opcional, puramente informativo. Pon lo que quieras.
  • Active LiveTrack: El track que se mostrará en el seguimiento en tiempo real. Debe crearse previamente un track dedicado mediante el menú Track y luego seleccionarse aquí. Para ser elegible para LiveTrack, el track debe tener una fecha de fin en el futuro (p. ej., 1/1/2050). Si el campo se deja vacío, en el seguimiento en tiempo real solo se mostrará el icono de la última posición conocida.
  • Direct URL: Una dirección web pública que proporciona acceso directo a la posición actual del boat (y a su LiveTrack si está definido). Por lo general, se recomienda usar el nombre del boat. <boatname>.trakkit.org
  • Email: Dirección desde la que se enviarán los emails de tracking. Esto se anula si se incluye un TAG válido en el asunto del email.
  • Noforeignland Email: Si tienes una cuenta de NoForeignLand, añade esta dirección de email como remitente de tracking en la configuración de tu cuenta NFL, y tu posición en NFL se actualizará automáticamente desde Trakkit.org.
  • Tags: Los tags son alias para tu boat. Puedes usarlos para enviar data, acceder al servidor SFTP o crear tu propio emisor de data. Para enviar data a través de nuestro servidor SFTP, crea una contraseña de Tag (Boat > Tags & Mails > Edit Tag > Create Password).

Test Track: Al crear un boat por primera vez, se generan automáticamente un track de prueba y un conjunto de data de ejemplo. Esto te permite familiarizarte rápidamente con los parámetros del boat y la visualización del track. Este track de prueba y sus datos se eliminarán automáticamente en la primera importación de data real.


🏷️ Tags


Los Tags son alias alternativos usados para identificar un boat. El propósito principal de un tag es otorgar acceso a un grupo específico de personas. Eliminar un tag eliminará el acceso para ese grupo, pero cualquiera que use un tag diferente seguirá teniendo acceso.

Normalmente, creas un tag separado para cada sistema que alimenta data al boat. Boat > Mails & Tag > Add Tag Si el acceso a un sistema se corrompe o deja de estar disponible, simplemente elimina el tag asociado.

Para alimentar data mediante dispositivos companion o usar el servidor SFTP, necesitas crear un tag con contraseña:
Boat > Mails & Tag > Edit > Create Password

⚠️ Asegúrate de recordar esta contraseña, ya que no se puede recuperar. Si se pierde, tendrás que crear una nueva.

  • Puedes crear tantos tags como quieras para un boat determinado.
  • Los tags pueden compartirse con grupos o individuos para conceder acceso.
  • Un tag puede eliminarse en cualquier momento sin impacto en Boats, Tracks o Data.
  • Los tags pueden usarse para enviar data por email desde cualquier dirección de email, simplemente poniendo el tag en la línea de asunto. En este caso, no compartas el tag con nadie.
  • Los tags con contraseñas pueden usarse para acceder al servidor SFTP, sirviendo el Tag como nombre de usuario.




📈 Data


Una vez que se ha creado un Boat, puedes alimentar Trakkit.org con data para este Boat.


¿Qué es DATA?


Data es una colección de puntos GPS e información opcional de sensores (AWA, AWS, etc.) para un boat.

Data puede adoptar varias formas:

  • Un archivo GPX generado por un dispositivo GPS o exportado desde apps como Navionics Boating
  • Tráfico de un archivo NMEA 0183, registrado usando apps como OpenCPN o QtVlm o una app companion.
  • Un archivo TEXT normal que contiene información de posición GPS, como los enviados por email con dispositivos como Iridium Go:

I am here Lat+28.851240 Lon-13.794377 Alt+009ft GPS Sats seen 10 2023-01-17 00:34UTC

O una línea con este patrón:

[±]Latitude [±]Longitude YYYY-MM-DD HH:MM[:SS[.sss]] [Timezone] [AWA:XXX] [AWS:XX.X] [COG:XXX] [SOG:XX.X] ...

NB: Latitude y Longitude están en grados decimales. Fecha, hora y zona horaria pueden combinarse en un único formato ISO: 2025-11-10T14:26:05Z. Se permiten múltiples líneas en el mensaje de texto o en el archivo adjunto.

Ejemplo de formato de texto aceptable:

-38.1052 -12.277 20210210 102345                                # UTC implicit
46.238 -0.5687 2021-02-10 10:23:45 UTC
-38.1052 -12.277 20210210 102345 UTC+2                          # If, for some mysterious reason, your navigation system isn’t set to UTC…
46.238 -0.5687 2021-02-10 10:23:45 UTC COG:125 SOG:9.2
-38.1052 -12.277 2021-02-10T10:23:45Z                           # ISO format UTC
46.238 -0.5687 2021-02-10T10:23:45+02:00 AWA:120 AWS:23.5       # ISO format UTC+2


Cómo enviar DATA:


Puedes enviar Data de distintas maneras en distintos momentos. Con conexión a internet en el mar, puedes enviar data en tiempo real. De lo contrario, simplemente guarda un archivo GPX, NMEA o TEXT de tu GPS o sistema de navegación y súbelo más tarde cuando vuelvas a estar online. El orden, la fecha y la hora de transmisión de la data no importan; solo son relevantes las marcas de tiempo contenidas en la data. Subir la misma data varias veces no afecta ni corrompe tu Data. Estas son las diferentes formas de enviar tu data:

Sea cual sea el método de carga que elijas, toda la Data puede comprimirse en: .zip .gzip .z .xz .7z .tar .tgz


📤 Mediante carga directa de Data a Trakkit.org:

Una de las formas más fáciles es iniciar sesión en Trakkit.org, DATA>UPLOAD y subir tu archivo GPX, NMEA o TEXT exportado desde una app de navegación o dispositivo GNSS.


📡 Por SFTP:

Puedes enviar tus archivos al servidor SFTP de Trakkit, que es el método recomendado para transferencias automatizadas de data y archivos grandes.

Credenciales y dirección del servidor se proporcionan cuando solicitas una contraseña de tag en Trakkit.org: BOATS > Mails & Tags > Create Tag Password

Restricciones (política de uso razonable): Frecuencia máxima de carga: 1 conexión cada 3 minutos. Tamaño máximo de archivo: 50 MB por carga. No seguir estas recomendaciones puede resultar en restricciones de acceso de carga, o incluso un veto permanente de Trakkit.org. Ten en cuenta que 50 MB de data comprimida pueden almacenar más de 24 horas de tráfico NMEA completo.

Una vez conectado, simplemente sube tu data al directorio /upload.

Los archivos subidos deben seguir este formato: TAG_YYYYMMDD_HHMMSS.data

Nota: TAG debe coincidir con la credencial de Tag usada para la conexión.

➡️ Al hacer una carga manual, se recomienda encarecidamente primero subir el archivo con la extensión .part (p. ej. TAG_YYYYMMDD_HHMMSS.gz.part) y luego renombrarlo a .data una vez que la transferencia haya finalizado. Esto garantiza que el archivo no se procese antes de que la carga esté completamente terminada. Comprime tus archivos para ahorrar ancho de banda (p. ej., .zip, .gzip, .z, gz, .xz, .7z, .tar, .tgz).

Puedes usar el script de Python sftp_send.py, disponible en Trakkit.org en About > Downloads, que automatiza las cargas respetando la configuración recomendada.


✉️ Por Mail:

Los mails deben enviarse a spool@trakkit.org

Debes incluir un Tag en el asunto de tu email (BOATS > Mails & Tags), o vincular tu dirección de email a tu boat en Trakkit.org antes de enviar por mail. Esto permite a Trakkit.org asociar la data con el Boat correcto.

Reglas de asignación:

  • Si el email del remitente está vinculado a un BOAT en Trakkit.org, la DATA se asignará a ese boat.
  • Si se especifica un alias TAG en la línea de Subject del email, la DATA se asignará al boat asociado a ese Tag.
  • En caso de información conflictiva, el Tag prevalece sobre el email.
  • Puedes enviar la data como archivo adjunto o escribirla en el cuerpo del mensaje

Nota: Email no es el método recomendado, ya que la mayoría de los proveedores limitan estrictamente el tamaño de los mensajes y adjuntos y pueden rechazarlos sin aviso. Este método debe reservarse para data de texto pequeña o trackers de bajo ancho de banda como Iridium GO. Comprime tus archivos para ahorrar ancho de banda (p. ej., .zip, .gzip, .z, .xz, .7z, .tar, .tgz).


🗑️ Eliminación de Data

Para eliminar data:

  • Usa el menú Data > Delete
  • Elimina por rango de fechas o BatchID
  • Cada carga tiene un BatchID; eliminar un batch solo elimina ese fragmento de data
  • Eliminar un track no elimina la data.


---

🗺️ TRACKS:

A diferencia de otros sistemas de navegación, un Track en Trakkit es simplemente un intervalo de tiempo con nombre dentro de un conjunto de Data.

Defines las horas de inicio y fin y le das un nombre.

Trakkit comprobará si hay Data correspondiente disponible para ese intervalo y la mostrará si la hay.

Si no hay data disponible, no se mostrará nada. Más adelante, si se sube Data que coincida con el intervalo del track, el Track se actualizará automáticamente.

Un Track también puede actualizarse manualmente mediante TRACK > Regen.

  • BoatName: El boat al que debe asociarse el track.
  • TrackName: Nombre mostrado del track.
  • Color: Elige el color del track. Además de los colores fijos estándar, puedes elegir un modo multicolor para tu track basado en la velocidad del boat (SOG) o la velocidad del viento aparente (AWS). SOG se calcula automáticamente, pero para AWS debes haberla proporcionado en tu data, normalmente subiendo frases NMEA.
  • Default Layer: La capa de primer plano del mapa a usar. La predeterminada es OSM SRTM Topographic. Ten en cuenta que la disponibilidad de tiles puede variar, especialmente para las proporcionadas por agencias de EE. UU. (NASA, NOAA, etc.), debido a restricciones de financiación que afectan a estos servicios en Estados Unidos.
  • WPO: Intervalo en minutos para los puntos de progreso (los puntos naranjas).
  • WPP: Intervalo en segundos para los puntos del track (precisión del Track). Advertencia: establecer una precisión demasiado alta puede ralentizar drásticamente el renderizado, la carga del track y la visualización. Usa el sentido común y ajusta la precisión según el tipo de track: “60 para navegación costera, 300 para navegación oceánica y 600 para travesías largas” son buenas pautas. Para el seguimiento en tiempo real (LiveTrack), esto nunca debería configurarse por debajo de 300 segundos. Una vez que el track y la navegación hayan finalizado, puedes regenerar el track final con mayor precisión si es necesario.
  • Published: Marca esto si quieres listar el track en el "TRACK LIST" visible en la página de tu boat en https://.trakkit.org
  • Recordatorio: Eliminar un Track no elimina la Data.

Recomendamos encarecidamente que configures la fecha/hora de inicio y fin de tu track para que tus puntos exactos de salida y llegada no se muestren permanentemente

Visualización de un Track

  • Enlace directo: https://trakkit.org/ttr/<TRACK-ID>
  • Desde la página de inicio con el TRACK-ID
  • Los tracks se renderizan de forma estática y solo se actualizan automáticamente cuando se importa nueva data
  • Puede regenerarse manualmente (TRACK > Regen)

Puedes integrar un enlace responsive en tu propia página o sitio web usando la URL directa proporcionada en la sección de tu boat:

    <div class="iframe-container">
      <iframe src="https://trakkit.org/ttr/<TRACK-ID>"
              title="My Track on Trakkit"></iframe>
    </div>

Nota: Dependiendo del motor de renderizado utilizado para generar un track, la URL mostrada puede variar. Sin embargo, siempre debes usar el formato https://trakkit.org/ttr/<TRACK-ID> para acceder a un track, incluso si Trakkit más adelante lo renombra o lo redirige internamente.

Visualización del seguimiento en tiempo real

En Boat > Edit > Direct URL, elige una URL para tu boat (normalmente el nombre del boat).

Puedes ver la posición de tu boat directamente en:
https://boatname.trakkit.org

Donde 'boatname' es el nombre indicado en Direct URL.

Si un LiveTrack está habilitado (Boat > Edit > Active LiveTrack), también se mostrará el track del boat. De lo contrario, solo se mostrará la última posición conocida.

La página predeterminada de seguimiento en vivo muestra información de navegación y botones que dan acceso al Mapa Meteorológico en Vivo, a la Lista de Tracks (para tracks marcados como Public) y a la vista de Pantalla Completa. Ten en cuenta que los datos meteorológicos en vivo los proporciona un servicio de terceros, pueden no estar disponibles por causas fuera de nuestro control y no se garantiza su exactitud.

Probablemente prefieras usar una vista a pantalla completa sin el panel de data dentro de los frames integrados en tu propio sitio web o páginas web. Puedes abrir una vista a pantalla completa directamente usando la siguiente URL: https://trakkit.org/live/simple/boatname

Puedes integrar la vista de seguimiento en vivo (o cualquier otro track) directamente en un iframe en tu propio sitio web o página personal.
Por ejemplo, para integrar https://boatname.trakkit.org, usa el siguiente HTML:

<iframe
    src="https://boatname.trakkit.org"
    width="100%"
    height="600"
    style="border:0;"
    allowfullscreen>
</iframe>



NoForeignLand


Si tienes una cuenta de NoForeignLand, Trakkit puede enviar automáticamente tu posición para actualizar tu ubicación en el sitio web de NoForeignLand.

Para habilitar esta función, añade la dirección emisora de Trakkit (algo como nfl_xxxxx@trakkit.org) que se te asigna en Boat > Mails & Tag > NoForeignLand a la configuración de sincronización por email de tu cuenta de NoForeignLand.

Una vez que esta dirección haya sido registrada en NoForeignLand, haz clic en “Activate” en Trakkit. Tu posición se enviará entonces por email a intervalos regulares. La sincronización puede desactivarse aquí en cualquier momento.

⚠️ Ten en cuenta que NoForeignLand no usa marcas de tiempo GNSS; en su lugar, la marca de tiempo registrada corresponde al momento de la sincronización. Las actualizaciones de posición se realizan como máximo cada 6 horas.



💻 App companion


Una app companion es una aplicación de terceros que recopila y envía data a Trakkit.

El código basado en Python de "joli_compagnon," la aplicación companion estándar de Trakkit, está disponible libremente y puede adaptarse fácilmente a tu configuración. Puede descargarse desde Trakkit.org > About > Download Tools.

Puedes configurar una solución de tracking completa y autónoma usando una simple Raspberry Pi o cualquier otro miniordenador. El proceso completo de configuración se describe en las siguientes guías: DIY Tracker with USB GPS y DIY Tracker with NMEA Gateway.

Esta es la solución preferida para el seguimiento en tiempo real.