Get Nearby Sections / Obtener Tramos Cercanos

GET

/external/tramos-cercanos

const url = 'https://api-dev.zonaparqueo.com/external/tramos-cercanos?latitud=1&longitud=1&metros=1';
const options = {method: 'GET', headers: {Authorization: '<Authorization>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api-dev.zonaparqueo.com/external/tramos-cercanos?latitud=1&longitud=1&metros=1' \
  --header 'Authorization: <Authorization>'

Obtiene los tramos cercanos a una ubicacion dada, incluyendo distancia, tarifa y horario.

Es la forma recomendada de resolver «que tramos tengo cerca»: filtrar el catalogo completo por distancia del lado del consumidor cuesta unos 10 s por consulta.

Nota historica: este endpoint estuvo caido entre junio y septiembre de 2026, devolviendo HTTP 500 en todas las consultas. Ya opera con normalidad. Verificado el 26/09/2026: responde 200 y sus distancias coinciden al metro con un calculo de haversine independiente sobre las coordenadas del propio catalogo (13 de 13), sin omitir ningun tramo activo dentro del radio.

Rendimiento: entre 2,6 s (mediana de 5 muestras, 26/09/2026) y 5,13 s (medicion del proveedor, 28/09/2026).

Horarios: la respuesta de este endpoint no aplica el filtro de horario de operacion. Si se requiere mostrar solo tramos operativos, filtrar por inicio_garantizado / fin_garantizado y activo_domingo (hora local de Bogota, UTC-5) del lado del consumidor. Estos campos pueden venir ausentes aqui y hay que completarlos desde GET /external/tramos.

Authorizations

ApiToken

Parameters

Query Parameters

latitud

required

number format: float

Latitud de la ubicacion

longitud

required

number format: float

Longitud de la ubicacion

metros

required

number format: float

Radio de busqueda en metros

Responses

200

Lista de tramos cercanos con distancia, tarifa y horario

application/json

object

estado

string

Allowed values: ok

data

Array<object>

object

integer

nombre

string

direccion

string

latitud

number format: float

longitud

number format: float

distancia

Distancia en metros desde la ubicacion dada

number format: float

tarifa

Informacion de tarifa del tramo

object

horario

Informacion de horario del tramo

object

Examples

success

{
  "estado": "ok",
  "data": [
    {
      "id": 1,
      "nombre": "Tramo Calle 72",
      "direccion": "Calle 72 # 10-30",
      "latitud": 4.6565,
      "longitud": -74.0595,
      "distancia": 150.5,
      "tarifa": {},
      "horario": {}
    }
  ]
}

400

Solicitud invalida

application/json

object

estado

string

Allowed values: fail

error

Mensaje de error

string

errores

Detalle de errores por campo

object

Example

{
  "estado": "fail"
}