Gravital Cloud

Acceso anticipado

GeoStream

Infraestructura de ubicación en tiempo real, privada por defecto y multiinquilino, para integrar en apps móviles y backends.

  • Streaming InmediatoTransmisión en vivo con orden garantizado
  • Opt-in estrictoUbicación apagada por defecto y revocable al instante
  • 1:1 · 1:N · N:NSesiones en vivo para cualquier topología
  • MultiinquilinoAislamiento por cliente y cero coordenadas en logs

Estado del servicio

Consultado desde nuestro servidor. Documentación, contratos y consola de desarrolladores en el portal de GeoStream.

Operativo Última verificación: 21:54

Abrir el portal de GeoStream

Documentación

Todo lo necesario para integrar GeoStream, organizado por tema. La documentación completa, los contratos y la consola de desarrolladores viven en el portal de GeoStream.

  • Empezar

    De cero a tu primera ubicación.

    • Crea tu cuenta en la consola del portal con tu correo y un código de un solo uso.
    • GeoStream está en acceso anticipado: el registro en la consola puede estar limitado por ahora.
    • Crea una organización y un proyecto.
    • Genera una API key con los permisos mínimos que necesites; se muestra una sola vez.

  • Cómo se consume

    El recorrido de una ubicación, de punta a punta.

    • Tu servidor crea una sesión de seguimiento con la API key.
    • Tu servidor emite un token de dispositivo para la persona o el equipo que comparte su ubicación.
    • El dispositivo activa el uso compartido y envía hasta 50 muestras por lote; cada muestra recibe su propio resultado: aceptada, duplicada, vencida o rechazada.
    • Tu servidor lee la última posición de cada miembro cuando la necesita y cierra la sesión al terminar.

  • Autenticación y seguridad

    Dos credenciales con funciones distintas.

    • La API key es de servidor a servidor: crea sesiones, emite tokens y lee posiciones. Nunca va en una app.
    • El token de dispositivo es el único que puede enviar ubicaciones; la ingesta con una API key se rechaza.
    • Las operaciones que crean recursos aceptan una clave de idempotencia: reintentar devuelve el mismo resultado.
    • Los errores siguen el formato problem+json con un código estable. No hay CORS: la API se usa desde servidores.

  • Configuración por organización

    Políticas que ajusta cada cliente.

    • Rechazo opcional de posiciones simuladas, apagado por defecto.
    • Historial de posiciones opcional y con plazo de conservación configurable. Sin activarlo, las posiciones en vivo son efímeras y no se guardan.
    • Varias API keys activas a la vez: puedes crear una nueva y retirar la anterior sin cortar el servicio.

  • Despliegue y operación

    Cómo se ofrece hoy.

    • GeoStream se ofrece como servicio alojado de Gravital Cloud, en acceso anticipado.
    • Su estado de salud es público: aparece arriba y lo puedes consultar en el portal.
    • Todavía no hay paquetes ni instaladores para alojarlo por tu cuenta.

  • Versiones y descargas

    Qué hay publicado hoy.

    • Contrato de la API: OpenAPI v1, todavía en borrador, publicado en el portal.
    • Versión del servicio: todavía sin versión pública.
    • Paquetes, compilados e instaladores: todavía no publicados.
    • SDK para apps: todavía no publicados.
Leer la documentación completa en el portal

Qué hace

  • Sesiones en vivo de uno a uno, de uno a muchos y de muchos a muchos.
  • Privacidad por defecto: compartir la ubicación empieza apagado y solo la persona lo enciende.
  • Transmisión continua de alta eficiencia con sincronización de orden garantizada y bajo consumo de datos móviles.
  • Revocación inmediata: quien pierde el permiso deja de recibir al instante.
  • Aislamiento estricto por cliente, sin coordenadas ni tokens en los registros.
  • Listo para mapas abiertos: las posiciones se muestran sobre OpenStreetMap, sin depender de proveedores de mapas propietarios.

Cómo funciona por dentro

Conoce cómo GeoStream procesa y distribuye coordenadas en vivo protegiendo la privacidad de cada persona.

1. Consentimiento explícito y creación de sesiónPrivacidad por defecto Ningún dispositivo transmite su posición hasta que la persona activa voluntariamente la sesión.
  1. Tu backend crea una sesión aislada dentro de su espacio de inquilino mediante la API REST de control.
  2. El dispositivo móvil recibe el token de alcance limitado, pero el envío de coordenadas permanece apagado hasta que la persona lo enciende.
  3. Se define quién puede emitir y quién puede observar (uno a uno, uno a muchos o grupo completo).
2. Distribución y streaming en tiempo realSincronización · Optimización Móvil Distribución en tiempo real con orden garantizado y bajo consumo de datos móviles.
  1. Las posiciones entran a la red de forma optimizada y comprimida para cuidar el plan de datos móviles.
  2. El motor valida la secuencia, descarta duplicados y ordena las actualizaciones en tiempo real.
  3. Los suscriptores autorizados reciben la posición actualizada al instante, sin que las coordenadas se escriban jamás en los archivos de log.
3. Revocación en caliente y cierre limpioCorte inmediato El control sobre quién ve la ubicación se aplica en tiempo real sobre las conexiones abiertas.
  1. Cuando una entrega termina o el usuario apaga el uso compartido, el permiso se revoca en el servidor.
  2. El motor corta de inmediato la emisión hacia cualquier suscriptor que haya perdido autorización, sin esperar a que reconecte.
  3. Los recursos de la sesión se liberan respetando el aislamiento estricto entre clientes.

Escenarios de uso

  • Seguimiento de entregas y última milla

    En GravitalPay, el comprador ve al repartidor en vivo sobre OpenStreetMap únicamente mientras su pedido va en camino, con la posición redondeada para cuidar su privacidad.

  • Coordinación de flotas y personal en campo

    Visualiza en un tablero central la ubicación activa de cuadrillas técnicas o repartidores con sesiones uno a muchos.

  • Compartir ubicación temporal entre personas

    Integra sesiones en vivo de tiempo limitado en aplicaciones móviles sin construir la infraestructura de streaming desde cero.

Estado

  • El estado en vivo, la documentación, los contratos y la consola de desarrolladores están en el portal de GeoStream.

Explora el resto del ecosistema Gravital Cloud

Ver todos los productos