Rastrear y guardar mi ubicación (tracking)

COLECCIONES: son los grupos de puntos que rastreas (conductores, repartidores, zonas…). Las creas tú en el menú «Geolocalización» y aquí escribes su nombre (o eliges una de las sugeridas). Sigue la ubicación del dispositivo y GUARDA cada movimiento como un punto de la colección (así los demás te ven en un mapa o te encuentran por radio). Es «Escuchar mi ubicación» + «Guardar punto» en un solo paso. Entradas: • Nombre — para detenerlo después con «Dejar de escuchar / rastrear». • Colección — dónde se guarda (conductores, repartidores…). • Mi clave — la que te identifica en la colección (el id del conductor, del pedido…). Se reemplaza el mismo punto en cada movimiento; no se crea uno nuevo cada vez. • Datos extra — JSON con lo que quieras guardar (ej. {"tipo":"moto","estado":"libre"}). • Guardar cada… metros y Espera mínima — para no gastar batería ni datos (ej. 25 m y 5 s). • Precisión. Cada punto tiene: clave (id), latitud, longitud y datos extra (JSON: tipo de vehículo, nombre, lo que quieras). Es asíncrona y NO bloquea. SALIDAS: «Cada vez que se guarda», «Sin permiso» y «Error». Al detenerlo, tu punto se queda guardado donde estaba; bórralo con «Borrar punto» si quieres que desaparezca. SEGUNDO PLANO: con «También en segundo plano» sigue funcionando cuando la persona minimiza la app o apaga la pantalla (ideal para un conductor en ruta). En el celular pide el permiso de ubicación «Permitir todo el tiempo» y, en Android, muestra un aviso fijo «usando tu ubicación» mientras esté activo (el sistema lo exige). Se apaga con «Dejar de escuchar / rastrear» o al cerrar la app. Si la app se cierra deslizándola (forzar cierre), se detiene. En el navegador (Vista previa del editor) no existe: sigue solo con la página abierta. Al publicar en Google Play y App Store, el uso de ubicación en segundo plano se declara en la ficha de la tienda. Requiere la Supabase conectada al proyecto y correr una vez el script del menú «Geolocalización». Para guardar hay que haber iniciado sesión (paso «Iniciar sesión»).

Entradas

• Nombre de este rastreo (para poder detenerlo) (text)
• Colección (la creas en «Geolocalización») (text)
• Mi clave en la colección (por ejemplo el id del conductor) (text)
• Datos extra (JSON, opcional) (text)
• Guardar cada… metros (0 = en cada lectura) (text)
• Espera mínima entre guardados, en segundos (0 = sin espera) (text)
• Precisión (select)
• Con la app en segundo plano (select)

Salidas (callbacks)

• Cada vez que se guarda — Corre cada vez que tu punto se guardó en la colección. Dato del evento: latitud, longitud, metros desde el aviso anterior y recorrido total.
• Sin permiso — Corre cuando no hay permiso de ubicación.
• Error — Corre cuando falló el GPS o el guardado (sin sesión, sin internet, falta el script…). Dato del evento: el motivo.