❓ Trakkit.org – FAQ

⚠️ Esta FAQ es una traducción automática generada a partir de la documentación oficial de Trakkit.
Se proporciona solo 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 ocio y de alta mar.
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 Boat, Data y Track es gratuito.

🚀 Primeros pasos

¿Cómo empiezo a usar Trakkit?

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

¿Qué ocurre con los datos de ejemplo?

El conjunto de datos de ejemplo y el track de prueba se eliminan automáticamente cuando subes tus primeros datos 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 que se muestra 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 datos de navegación y tracks.
Debes crear un Boat antes de enviar Data.

¿Qué sucede cuando creo un Boat?

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

¿Qué es la URL directa?

La URL directa proporciona acceso público a:

La posición actual del Boat
Su live track (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 por texto en 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)
Apps companion
Sistemas satelitales (p. ej., Iridium Go)

¿Puedo combinar diferentes fuentes de Data?

Sí. Data puede provenir de múltiples fuentes en distintos momentos:

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

¿Eliminar un Track elimina Data?

No.
Eliminar un track no elimina la 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:

Incluir un Tag en el asunto del email

O BIEN

Vincular tu dirección de email a tu Boat

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

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

¿Qué formato deben seguir los datos 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 la 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 del servidor SFTP y el puerto 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.

¿Puede un Tag estar vinculado a múltiples boats?

No. Un tag solo puede pertenecer a un Boat.

¿Qué sucede 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 segmento 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 la misma Data?

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

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

No se mostrará nada hasta que se suba Data que coincida.
El track se actualizará automáticamente cuando llegue la 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 naranjas de progreso

Valores recomendados de WPP:

10 segundos → Regatas
60 segundos → Navegación costera
300 segundos → Navegación de alta mar

¿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 veo 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?

Establece una URL directa
Crea un track con una fecha de fin futura
Selecciónalo como Active LiveTrack

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

Ejemplo de HTML:

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

💻 Apps companion

¿Qué es una Companion App?

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

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

¿Existe una implementación de referencia para una Companion App?

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

🔐 Data y visibilidad

¿La Data es visible automáticamente?

No.
La Data solo se hace visible cuando un Track define un intervalo temporal que la cubre.

¿Debo ocultar las marcas de tiempo de salida y llegada?

Sí.
Se recomienda encarecidamente configurar los tiempos de inicio y fin del track para que tus puntos exactos de salida y llegada no queden visibles permanentemente.

🧭 Resumen

Trakkit se basa en tres objetos principales:

Boat
Data
Track

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

Simple, flexible y diseñado para la navegación real de alta mar.