1. Histórico
Estarter
  • Documentación
  • Endpoints Estarter [external]
    • Servicios
      • Obtener opciones de filtros disponibles
      • Listar servicios con filtros
    • Microservicios
      • Almacenar archivo PDF
    • Vehiculos
      • vehiculos GPS
        • Lista la última posición GPS de toda la flota activa
        • Última posición GPS de un vehículo específico
      • Catálogo de Vehículos
        • Crear vehículo en catálogo
        • Listar vehículos del catálogo
        • Editar vehículo del catálogo
      • Documentos
        • Obtener datos de preoperacional con paginación y filtros
      • Crear vehículo desde RUNT
      • Obtener vehiculos
      • Vehículos filtros
    • Usuarios
      • Auth Admin
    • Proveedores
      • Agregar o remover proveedor
    • Reservas
      • Obtener reservas por EID y fechas
    • Ultra
      • Listar catálogo de vehículos Ultra
      • Crear solicitud de servicio VIP
    • Date server
      GET
    • Invalidar cache
      GET
    • Auth External
      POST
  • Polaris
    • Posición en vivo
      • Estado completo de una placa
      • Estado lite de varias placas (lote)
      • Snapshot de toda la flota (lite)
    • Geoespacial
      • Vehículos dentro de un radio
      • Vehículos dentro de un bounding box
    • Histórico
      • Trazado (readings) por placa y rango
        GET
    • Tiempo real
      • Stream SSE de posición en vivo (push)
  • Schemas
    • Sample Schemas
      • Pet
      • Category
    • Schemas
      • CrearVehiculoRequest
      • EditarVehiculoRequest
      • VehiculoResponse
      • ListarVehiculosResponse
    • Raíz
      • PreoperacionalRequest
      • CatalogoVehiculosResponse
      • SolicitudVipRequest
      • ListarServiciosRequest
      • PreoperacionalResponse
      • DatosSolicitante
      • ListarServiciosResponse
      • Tag
      • Vehiculo
      • PreoperacionalData
      • TarifaServicio
      • SolicitudVipResponse
      • Servicio
      • Paginacion
      • SolicitudVipData
      • FiltrosServiciosRequest
      • FiltrosServiciosResponse
      • ErrorResponse
      • UnauthorizedResponse
      • RateLimitResponse
    • GpsVehiculo
    • SourceKind
    • RangoBusqueda
    • Mode
    • GpsListaMetadata
    • CanonLite
    • GpsListaResponse
    • SourceSnapshot
    • GpsPlacaResponse
    • PlacaState
    • ErrorAuth
    • Reading
    • Error
  1. Histórico

Trazado (readings) por placa y rango

GET
/v1/readings
Devuelve el trazado GPS persistido de una placa en un rango de tiempo.
Los puntos están downsampled (se persiste si se movió ≥~15 m, ≥~30 s,
o cambió el rumbo) para un trazado eficiente. Sin from/to devuelve
las últimas 24 h. Máximo 5000 puntos por llamada.

Solicitud

Autorización
Proporciona tu token bearer en el encabezado
Authorization
al realizar solicitudes a recursos protegidos.
Ejemplo:
Authorization: Bearer ********************
Parámetros de consulta

Ejemplos de solicitud

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location '/v1/readings?placa=SIT767&from=2026-06-09T10%3A00%3A00Z&to=2026-06-09T13%3A00%3A00Z&limit=5000' \
--header 'Authorization: Bearer <token>'

Respuestas

🟢200OK
application/json
Trazado de la placa, ordenado por tiempo.
Encabezados

Bodyapplication/json

Ejemplo
{
    "placa": "SIT767",
    "count": 2,
    "readings": [
        {
            "latitude": 3.4402983,
            "longitude": -76.5008084,
            "speed": 31,
            "heading": 64,
            "unit_time": "2026-06-09T11:25:56.766Z",
            "unit_time_bogota": "2026-06-09 06:25:56",
            "formatted_address": null,
            "ignition_status": null
        },
        {
            "latitude": 3.5167167,
            "longitude": -76.5018429,
            "speed": 0,
            "heading": 0,
            "unit_time": "2026-06-09T12:15:43.521Z",
            "unit_time_bogota": "2026-06-09 07:15:43",
            "formatted_address": null,
            "ignition_status": null
        }
    ]
}
🟠400Petición incorrecta
🟠401No autorizado
Modificado en 2026-06-09 20:26:25
Anterior
Vehículos dentro de un bounding box
Siguiente
Stream SSE de posición en vivo (push)
Built with