❓ Trakkit.org – FAQ

⚠️ Este FAQ es una traducción automática generada a partir de la documentación oficial de Trakkit.
Se proporciona únicamente con fines informativos.

🌍 Preguntas generales

¿Qué es Trakkit.org?

Trakkit.org es una interfaz web para un motor de renderizado de tracks dedicado a la navegación a vela de recreo y offshore.
Te permite crear, visualizar y compartir tracks de navegación de tu Boat.


¿Trakkit recopila datos personales?

⚠️ No. Trakkit.org no recopila ningún dato personal.
Eres totalmente responsable de lo que decidas publicar en línea.


¿Trakkit es gratuito?

Sí. Crear una cuenta y gestionar boats, Data y tracks es gratuito.


🚀 Primeros pasos

¿Cómo empiezo a usar Trakkit?

  1. Crea una cuenta gratuita
  2. Crea un Boat (solo se requiere el nombre del Boat)
  3. Se crean automáticamente un conjunto de Data de ejemplo y un track de prueba
  4. Visita: https://.trakkit.org
  5. Sube tu propio archivo .gpx mediante DATA > Upload
  6. Crea un track mediante TRACK > Add Track

¿Qué ocurre con los Data de ejemplo?

El conjunto de Data de ejemplo y el track de prueba se eliminan automáticamente cuando subes tus primeros Data reales.


¿Qué es un enlace TTR?

Cada track recibe un ID único llamado TTR ID (o TRACK ID).
Puedes compartir tu track usando:

https://trakkit.org/ttr/

Nota:
Dependiendo del motor de renderizado, Trakkit puede ajustar dinámicamente la URL mostrada en tu navegador.

Para acceder de forma fiable a un track, usa siempre el formato canónico:

https://trakkit.org/ttr/<TRACK-ID>


🛥️ Boats

¿Qué es un Boat en Trakkit?

Un Boat es el contenedor principal de tus Data de navegación y tracks.
Debes crear un Boat antes de enviar Data.


¿Qué ocurre cuando creo un Boat?

  • Se genera automáticamente un track de prueba
  • Se asocian Data de ejemplo
  • Puedes probar la visualización inmediatamente

¿Qué es la Direct URL?

La Direct URL proporciona acceso público a:

  • La posición actual del Boat
  • Su track en vivo (si está habilitado)

Ejemplo:

https://boatname.trakkit.org


¿Qué es Active LiveTrack?

Active LiveTrack permite la visualización en tiempo real del movimiento de tu Boat.
Para habilitarlo:

  • Crea un track
  • Establece su fecha de fin en el futuro (p. ej., 01/01/2050)
  • Selecciónalo en Boat > Edit > Active LiveTrack

📈 Data

¿Qué es Data?

Data es una colección de puntos GPS e información de navegación opcional (AWA, AWS, COG, SOG, etc.).


¿Qué formatos de archivo se admiten?

  • .gpx
  • .nmea
  • .txt
  • Posiciones en texto por email
  • Formatos comprimidos: .zip, .gzip, .z, .xz, .7z, .tar, .tgz

¿Puedo subir Data manualmente?

Sí.
Ve a DATA > Upload y sube tus archivos .gpx, .nmea o .txt.


¿Puedo enviar Data automáticamente?

Sí. Puedes enviar Data mediante:

  • Email a spool@trakkit.org
  • SFTP (recomendado para automatización)
  • Aplicaciones companion
  • Sistemas satelitales (p. ej., Iridium Go)

¿Puedo combinar diferentes fuentes de Data?

Sí. Los Data pueden proceder de múltiples fuentes en distintos momentos:

  • Emails satelitales en tiempo real en el mar
  • Subida completa de GPX en puerto
  • Registros NMEA desde software de navegación

¿Eliminar un Track elimina Data?

No.
Eliminar un track no elimina los Data.

Para eliminar Data, usa:

  • DATA > Delete
  • Eliminar por rango de fechas o BatchID

✉️ Data por email

¿Cómo envío Data por email?

Envíalo a:

spool@trakkit.org

Debes hacer una de estas dos cosas:

  • Incluir un Tag en el asunto del email

O

  • Vincular tu dirección de email a tu Boat

¿Qué tiene prioridad: Tag o email del remitente?

El Tag tiene prioridad sobre la dirección de email del remitente.


¿Qué formato deben seguir los Data de posición?

Un punto por línea:

Latitud Longitud AAAA-MM-DD HH:MM[:SS] [Zona horaria] [Campos opcionales]

Ejemplo:

41.7267 -49.9469 2024-04-15 02:40:00 UTC AWA:120 AWS:24.5 COG:145 SOG:10.5

Si no se especifica zona horaria, se asume UTC.


📡 Subida por SFTP

¿Por qué usar SFTP?

SFTP es el método recomendado para transferencias automatizadas.


¿Cuáles son las restricciones?

  • Frecuencia máxima: 1 archivo cada 3 minutos
  • Tamaño máximo de archivo: 20 MB

Cómo enviar Data mediante SFTP

  • Solicita una contraseña de Tag en: Boat > Mails & Tags > Password
  • Guarda la contraseña inmediatamente. No se puede recuperar una vez mostrada (puedes solicitar una nueva si es necesario).
  • La dirección y el puerto del servidor SFTP se muestran junto con la contraseña.
  • Puedes subir archivos manualmente usando un cliente SFTP como FileZilla, o usar los scripts de automatización proporcionados por JoliCompanion.

¿Cómo deben nombrarse los archivos?

TAG_YYYYMMDD_HHMMSS.data

Sube primero como:

TAG_YYYYMMDD_HHMMSS.part

Luego renómbralo a .data una vez que se haya subido por completo.


🏷️ Tags

¿Qué es un Tag?

Un Tag es un alias para un Boat.
Permite:

  • Asignación de Data
  • Control de acceso
  • Autenticación SFTP

¿Puedo crear múltiples Tags?

Sí. Puedes crear tantos tags como quieras para un Boat.


¿Se puede vincular un Tag a varios boats?

No. Un tag solo puede pertenecer a un Boat.


¿Qué ocurre si elimino un Tag?

El acceso mediante ese tag se revoca inmediatamente.
Los demás tags siguen siendo válidos.


¿Se pueden usar Tags para SFTP?

Sí.

  • Tag = nombre de usuario
  • Se requiere contraseña

Las contraseñas no se pueden recuperar.


🗺️ Tracks

¿Qué es un Track?

Un Track es simplemente un intervalo temporal de Data.

Define:

  • Una fecha/hora de inicio
  • Una fecha/hora de fin
  • Un nombre

No almacena Data por sí mismo.


¿Pueden varios tracks usar los mismos Data?

Sí.
Los tracks son solo vistas de Data existentes.


¿Qué ocurre si creo un track antes de subir Data?

No se mostrará nada hasta que se suban Data que coincidan.
El track se actualizará automáticamente cuando lleguen Data.


¿Qué son WPP y WPO?

  • WPP (Track precision): intervalo en segundos entre los puntos del track mostrados
  • WPO (Progress points): intervalo en minutos entre los marcadores de progreso naranjas

Valores recomendados de WPP:

  • 10 segundos → Regatas
  • 60 segundos → Navegación costera
  • 300 segundos → Navegación offshore

¿Cómo regenero un track?

Ve a:

TRACK > Regen


¿Cómo puedo hacer público un track?

Marca la opción Published al editar el track.


🗺️ Visualización de tracks

¿Cómo visualizo un track?

Enlace directo:

https://trakkit.org/ttr/

O introduce el Track ID en la página de inicio.


📡 Seguimiento en vivo

¿Cómo habilito el seguimiento en vivo?

  1. Define una Direct URL
  2. Crea un track con una fecha de fin futura
  3. Selecciónalo como Active LiveTrack

¿Cómo incrusto el seguimiento en vivo en mi sitio web?

Ejemplo HTML:

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

💻 Aplicaciones companion

¿Qué es una aplicación Companion?

Una aplicación companion es una aplicación de terceros que:

  • Recopila Data de navegación
  • Los envía automáticamente a Trakkit

¿Hay una implementación de referencia para una aplicación companion?

Sí.
El código base en Python de JoliCompanion está disponible en Trakkit.org y GitHub. Se puede adaptar a tu configuración.


🔐 Data y visibilidad

¿Los Data son visibles automáticamente?

No.
Los Data pasan a ser visibles solo cuando un Track define un intervalo temporal que los cubre.


¿Debería ocultar las marcas de tiempo de salida y llegada?

Sí.
Se recomienda encarecidamente configurar las horas de inicio y fin del track para que tus puntos exactos de salida y llegada no queden visibles de forma permanente.


🧭 Resumen

Trakkit se basa en tres objetos principales:

  • Boat
  • Data
  • Track

Los Data son continuos.
Los tracks son vistas.
Los tags controlan el acceso.
El seguimiento en vivo es opcional.

Simple, flexible y diseñado para la navegación offshore real.