Última posición GPS de un vehículo específico

Retorna la última posición GPS de la placa indicada, o datos:[] si la placa no existe,
es inválida, o no tiene datos GPS recientes.

Validación de placa: regex ^[A-Z0-9]{5,8}$ (case-insensitive, se normaliza a uppercase).

Rate limit: 1 request cada 10 segundos por placa. Si se excede, el handler
retorna HTTP 200 con los datos del cache más reciente y un campo mensaje
indicando cuántos segundos de validez quedan. Si no hay cache disponible, retorna 429.

Headers de respuesta: X-Response-Time (ms), Cache-Control: no-store.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Responses

🟢200OK

application/json

OK. Array con 0 o 1 elemento; posiblemente servida desde cache.

Body

Examples

Placa encontrada con última posiciónPlaca inválida o sin datosRate limit excedido con cache disponible

{
    "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"
        }
    ]
}

🟠401Unauthorized

🟠403Forbidden

🟠429

Última posición GPS de un vehículo específico

Request

Request Code Samples

Responses