Lista la última posición GPS de toda la flota activa

Retorna la última posición GPS conocida de cada vehículo en estado ACTIVO.

Modos de consulta:

Por defecto (modo VENTANA): solo vehículos con lectura en las últimas 3 horas.

?todos=1 / ?full=1 / ?modo=full (modo COMPLETO): incluye todos, sin ventana temporal.

Cache: 5s en modo VENTANA, 10s en modo COMPLETO (compartido con el endpoint interno).

Rate limit: 30 requests/min por IP.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200OK

application/json

OK (incluye errores de negocio con resultado:"NO" y 429 rate-limited convertidos a 200).

Body

Examples

Modo VENTANA (default)Modo COMPLETO (?todos=1)

{
    "resultado": "OK",
    "datos": [
        {
            "placa": "ABC123",
            "lng": -74.0721,
            "lat": 4.711,
            "speed": 42.5,
            "direction": 180,
            "ubicacion_texto": "Calle 100 con Cra 15, Bogotá",
            "timestamp": "2026-04-22T15:30:00.000Z",
            "timestamp_bogota": "2026-04-22 10:30:00",
            "proveedor_gps": "zonar"
        }
    ],
    "metadata": {
        "cantidad_vehiculos_registrados": 150,
        "cantidad_vehiculos_con_datos": 128,
        "cantidad_vehiculos_sin_datos": 22,
        "porcentaje_cobertura": 85.33,
        "rango_busqueda": {
            "tipo": "VENTANA_3H",
            "desde": "2026-04-22 07:30:00",
            "hasta": "2026-04-22 10:30:00",
            "ventana_horas": 3,
            "timezone": "America/Bogota"
        },
        "modo": "VENTANA"
    }
}

🟠401Unauthorized

🟠403Forbidden

🟠429

Lista la última posición GPS de toda la flota activa

Request

Request Code Samples

Responses