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 recreativa y de altura.

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.
  • 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 ha 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 comienzas a subir tus propios datos.

📚 Documentación general

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

  • Boat
  • Data
  • Track

Los datos están vinculados a un Boat. Un track es un segmento de datos entre dos fechas.

🔧 ¿Cómo funciona?

Es esencial entender que en Trakkit, los datos no están ligados a los tracks. Los datos pueden enviarse de forma continua. Los tracks simplemente definen rangos de fechas dentro de los cuales los datos correspondientes son visibles. Eliminar un track no afecta a los datos. Los datos solo son visibles si existe un track definido para hacerlos visibles. Los mismos datos pueden 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 los mismos Data
  • Eliminar un Track no afecta a los Data



🛥️ Boat


Crear un boat es el primer paso necesario para importar datos 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 irreales).
  • Info: Un campo opcional, meramente 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). En general, se recomienda usar el nombre del boat. <boatname>.trakkit.org
  • Email: Dirección desde la cual se enviarán los emails de tracking. Esto se sobrescribe 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 tu remitente de tracking en la configuración de tu cuenta de 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 datos, acceder al servidor SFTP o crear tu propio emisor de datos. Para enviar datos 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 test track y un conjunto de datos de ejemplo. Esto te permite familiarizarte rápidamente con los parámetros del boat y la visualización de tracks. Este test track y sus datos se eliminarán automáticamente en la primera importación de datos reales.


🏷️ Tags


Los Tags son alias alternativos usados para identificar un boat. El propósito principal de un tag es conceder 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, se crea un tag separado para cada sistema que alimenta datos 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.

Campos disponibles:

  • INFO: Un campo puramente informativo para ayudarte a recordar cómo usas el Tag. Introduce lo que quieras.
  • ALLOWED TO SEND MAIL: Marca esta casilla si quieres usar el Tag para enviar datos por email.

Para alimentar datos 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 la contraseña se pierde, tendrás que crear una nueva.

  • Puedes crear tantos tags como quieras para un boat dado.
  • 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 datos 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ña pueden usarse para acceder al servidor SFTP, usando el Tag como nombre de usuario.




📈 Data


Una vez creado un Boat, puedes alimentar Trakkit.org con datos 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 CSV usando un punto y coma (;) como separador, con los nombres de campos en la primera línea.

Campos obligatorios: - Date (formato ISO 8601: los valores sin zona horaria se asumen en UTC) - LAT - LON (en grados decimales)

Campos opcionales: Se pueden proporcionar campos adicionales, como: AWA, AWS, COG, SOG, etc.

Algunos campos opcionales pueden ser ignorados por el parser dependiendo de la versión.

Campos soportados actualmente: AWS, AWA, COG, SOG, TWA, TWS, MTW, MTA, HDG, TWD, CTW, MBP, STW, DEPTH, RPM, ELEV

Velocidades en nudos, ángulos en grados, profundidad en metros, temperatura en Celsius. Cualquier campo marcado como (calc) se ignorará, ya que Trakkit está diseñado para ingerir solo datos brutos producidos directamente por sistemas de navegación a bordo.

Ejemplo de CSV DATA válido:

  Date;LAT;LON;SOG;COG;AWA;AWS;DEPTH;MTW
  2026-04-21T08:00:00Z;44.8500;-55.2167;5.2;145;32;14.5;120;12.4
  2026-04-21T08:05:00Z;44.8485;-55.2135;5.4;147;30;15.0;118;12.5
  2026-04-21T08:10:00Z;44.8470;-55.2103;5.6;149;29;15.6;115;12.5

Por razones históricas y por compatibilidad con formatos de texto heredados de Iridium GO, los formatos TEXT antiguos de Trakkit siguen siendo compatibles pero están obsoletos y no deberían usarse en nuevos desarrollos. A partir de ahora, solo debería usarse el formato CSV.


Cómo enviar DATA:


Puedes enviar Data de diferentes formas en distintos momentos. Con conexión a internet en el mar, puedes enviar datos en tiempo real. De lo contrario, simplemente guarda un archivo GPX, NMEA o TEXT desde 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 los datos no importan; solo son relevantes las marcas de tiempo contenidas en los datos. Subir los mismos datos varias veces no afecta ni corrompe tus Data. Estas son las diferentes formas de enviar tus datos:

Sea cual sea el método de subida que elijas, todos los Data pueden comprimirse en: .zip .gzip .z .xz .7z .tar .tgz


📤 Mediante carga directa de Data a Trakkit.org:

Una de las formas más sencillas 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 un dispositivo GNSS.


📡 Por SFTP:

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

Las credenciales y la 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 justo): Frecuencia máxima de subida: 1 conexión cada 3 minutos. Tamaño máximo de archivo: 50 MB por subida. No seguir estas recomendaciones puede resultar en restricciones del acceso de subida o incluso en un baneo permanente de Trakkit.org. Ten en cuenta que 50 MB de datos comprimidos pueden almacenar más de 24 horas de tráfico NMEA completo.

Una vez conectado, simplemente sube tus datos al directorio /upload.

Los archivos subidos deben seguir este formato: TAG_YYYYMMDD_HHMMSS.data

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

➡️ Al hacer una subida manual, se recomienda encarecidamente subir primero el archivo con la extensión .part (p. ej. TAG_YYYYMMDD_HHMMSS.gz.part) y luego renombrarlo a .data una vez completada la transferencia. Esto garantiza que el archivo no se procesará antes de que la subida haya finalizado por completo. 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 subidas siguiendo la configuración recomendada.


✉️ Por Mail:

Los emails deben enviarse a spool@trakkit.org

Debes incluir un Tag en el asunto de tu email o vincular tu dirección de email a tu boat en Trakkit.org antes de enviar por email. Esto permite que Trakkit.org asocie los datos al Boat correcto.

Si usas un Tag en el asunto de tu email, primero debes permitir que este Tag envíe correo (BOATS > Mails & Tags > Edit > Allowed to send mail). Los emails recibidos con un Tag que no esté permitido se ignorarán, incluso si la dirección de email del remitente ya está vinculada.

Reglas de asignación:

  • Si el email del remitente está vinculado a un BOAT en Trakkit.org, los DATA se asignarán a ese boat.
  • Si se especifica en el Asunto un alias TAG permitido para enviar correo, los DATA se asignarán al boat asociado a ese Tag.
  • En caso de información en conflicto, el Tag prevalece sobre el email.
  • Puedes enviar los datos como archivo adjunto o escribirlos en el cuerpo del mensaje

Nota: El 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 debería reservarse para datos de texto pequeños 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 datos:

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


🗂️ Batches

Cada vez que se suben datos, se asigna un Batch ID. Todos los datos subidos en una única operación comparten el mismo Batch ID.

Por ejemplo, si subes 10.000 puntos de posición de una vez, todos tendrán el mismo Batch ID.

El propósito principal del Batch ID es identificar los datos subidos juntos desde el mismo dispositivo y permitir eliminar toda la subida en una sola operación. Esto puede ser útil en casos de dispositivos defectuosos o datos corruptos.

Nota: Subir los mismos datos varias veces está soportado y no requiere eliminación manual usando el Batch ID.

Los Batch IDs se conservan durante al menos un año tras su creación. Después, los datos se consideran válidos y el Batch ID puede eliminarse.


🗺️ 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 existe.

Si no hay datos disponibles, no se mostrará nada. Más tarde, si se suben Data que coincidan 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 tus datos, normalmente subiendo frases NMEA.
  • Default Layer: La capa de primer plano del mapa a utilizar. Por defecto es OSM SRTM Topographic. Ten en cuenta que la disponibilidad de teselas 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 de altura, 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 finalizados el track y la navegación, puedes regenerar el track final con mayor precisión si es necesario.
  • Published: Marca esto si quieres listar el track en la "TRACK LIST" visible en la página de tu boat en https://.trakkit.org
  • Recordatorio: Eliminar un Track no elimina los Data.

Recomendamos encarecidamente que establezcas la fecha/hora de inicio y fin de tu track de modo que tus puntos exactos de salida y llegada no queden permanentemente mostrados

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 importan nuevos datos
  • Se pueden regenerar 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 usado 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 está habilitado un LiveTrack (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 Live Weather Map, al Track List (para tracks marcados como Public), y a la vista Full Screen. Ten en cuenta que los datos meteorológicos en vivo los proporciona un servicio de terceros, pueden no estar disponibles fuera de nuestro control y no se garantiza su exactitud.

Probablemente prefieras usar una vista a pantalla completa sin el panel de datos dentro de los frames incrustados 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 incrustar 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 incrustar 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 de envío 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 se haya registrado 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 utiliza timestamps GNSS; en su lugar, el timestamp registrado corresponde al momento de la sincronización. Las actualizaciones de posición se realizan como máximo cada 6 horas.



💻 Companion App


Una companion app es una aplicación de terceros que recopila y envía datos 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.