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>'

Gets nearby sections to a given location, including distance, rate, and schedule.

This is the recommended way to answer “which sections are near me”: filtering the full catalog by distance on the consumer side costs around 10 s per query.

Historical note: this endpoint was down between June and September 2026, returning HTTP 500 for all queries. It now works normally. Verified on 2026-09-26: it returns 200 and its distances match, to the metre, an independent haversine calculation over the catalog’s own coordinates (13 out of 13), with no active section inside the radius omitted.

Performance: between 2.6 s (median of 5 samples, 2026-09-26) and 5.13 s (provider measurement, 2026-09-28).

Operating hours: this endpoint’s response does not apply the operating-hours filter. To show only operating sections, filter by inicio_garantizado / fin_garantizado and activo_domingo (Bogota local time, UTC-5) on the consumer side. These fields may be missing here and must be completed from GET /external/tramos.

Authorizations

ApiToken

Parameters

Query Parameters

latitud

required

number format: float

Location latitude

longitud

required

number format: float

Location longitude

metros

required

number format: float

Search radius in meters

Responses

200

List of nearby sections with distance, rate, and schedule

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

Distance in meters from the given location

number format: float

tarifa

Section rate information

object

horario

Section schedule information

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

Invalid request

application/json

object

estado

string

Allowed values: fail

error

Error message

string

errores

Field-specific error details

object

Example

{
  "estado": "fail"
}