TransMilenio

A TransMilenio S.A. opera o sistema integrado de transporte público de Bogotá: os corredores do TransMilenio, suas rotas alimentadoras, os ônibus zonais do SITP e o TransMiCable. Publica todo o quadro de horários a cada manhã e a posição de cada veículo a cada poucos segundos. Cerca de 8.300 paradas e estações, 1.080 rotas e 9,4 milhões de paradas programadas por semana. Encontre uma parada pelo nome ou perto de um ponto, veja quais rotas passam por ela e quando saem as próximas, siga uma rota parada por parada no mapa e veja onde estão os ônibus agora. Os endpoints de horário respondem com dados atualizados diariamente; os endpoints ao vivo leem a rede enquanto ela opera, a cada cerca de 20 segundos.

Buscar paradas

POST /co/transmilenio/stops-search/v1 Dataset Encontra paradas e estações pelo nome, pela rota ou ao redor de um ponto. Comece aqui para obter o stop_id que os demais endpoints usam.

Campo	Tipo	Notas
`query`	string	Opcional. Palavras do nome, ou o código, p. ex. `Portal Norte`, `Calle 72`.
`route`	string	Opcional. Um `route_id`, ou o código impresso no ônibus (`B10`, `C25`, `T25`); um código cobre todos os sentidos da rota.
`kind`	enum	Opcional. `station` ou `stop` (uma plataforma ou uma parada de rua). Ambos por padrão.
`latitude`	number,null	Opcional. Latitude de um ponto, p. ex. `4.6486`. Com `longitude`, só o que está a menos de `radius_m`, o mais próximo primeiro. Por padrão `null`.
`longitude`	number,null	Opcional. Longitude do ponto, p. ex. `-74.0633`. Por padrão `null`.
`radius_m`	integer	Opcional. Metros ao redor do ponto, 50-5000. Padrão `500`. Por padrão `500`.
`page`	integer	Opcional. Página, começa em 1. Por padrão `1`.
`per_page`	integer	Opcional. Resultados por página, 1-100. Por padrão `20`.

curl https://api.croma.run/co/transmilenio/stops-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "Portal Norte" }'

Retorna as_of, total, total_is_exact, page, per_page, total_pages, count e stops[]; cada parada traz distance_m quando a busca é ao redor de um ponto. Cada parada é

{ stop_id, code, name, kind, parent_station, latitude, longitude, wheelchair_boarding, zone_id, route_ids[], route_codes[], routes[], systems[], platforms[] }

kind: station (uma estação do TransMilenio ou do TransMiCable, que tem plataformas) ou stop (uma plataforma dentro de uma estação, ou uma parada de rua do SITP).
routes[]: cada rota que para ali, { route_id, short_name, long_name, system }. Uma estação reúne as rotas de todas as suas plataformas.
platforms[]: para uma estação, o stop_id de cada plataforma.
systems[]: troncal, alimentador, dual, zonal_urbano, zonal_complementario, zonal_especial, transmicable.

Uma parada

POST /co/transmilenio/stop/v1 Dataset Retorna uma parada ou estação pelo id.

Campo	Tipo	Notas
`stop_id`	string	Obrigatório. O `stop_id` da busca de paradas, p. ex. `10000`. Uma estação cobre todas as plataformas dela.

curl https://api.croma.run/co/transmilenio/stop/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "stop_id": "10000" }'

Retorna as_of, found, stop e, para uma plataforma, station. Um id desconhecido responde found: false.

Partidas de uma parada

POST /co/transmilenio/stop-departures/v1 Dataset O quadro de horários de uma parada: as próximas partidas a partir de agora, ou de qualquer horário em qualquer dia.

Campo	Tipo	Notas
`stop_id`	string	Obrigatório. O `stop_id` da busca de paradas, p. ex. `10000`. Uma estação cobre todas as plataformas dela.
`date`	string	Opcional. `yyyy-mm-dd` em Bogotá. Hoje por padrão.
`from_time`	string	Opcional. `HH:MM`, 24 horas. Agora por padrão (o início do dia para outra data).
`route`	string	Opcional. Um `route_id`, ou o código impresso no ônibus (`B10`, `C25`, `T25`); um código cobre todos os sentidos da rota.
`limit`	integer	Opcional. Quantos retornar, 1-200. Padrão `20`. Por padrão `20`.

curl https://api.croma.run/co/transmilenio/stop-departures/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "stop_id": "10000" }'

Retorna as_of, found, stop_name, date, from_time, services (os quadros de horários vigentes no dia), count e departures[]: { time, at, minutes_from_now, route_id, route_code, route_name, system, stop_id }. at é ISO 8601 no horário de Bogotá (-05:00); stop_id é a plataforma de onde o ônibus sai. Rotas que terminam na parada ficam de fora: elas chegam, não saem.

Buscar rotas

POST /co/transmilenio/routes-search/v1 Dataset Encontra rotas por código, destino, sistema ou uma parada em que param.

Campo	Tipo	Notas
`query`	string	Opcional. O código da rota ou palavras do destino, p. ex. `B10`, `Portal Suba`.
`system`	enum	Opcional. `troncal`, `alimentador`, `dual`, `zonal_urbano`, `zonal_complementario`, `zonal_especial` ou `transmicable`.
`stop_id`	string	Opcional. Só as rotas que param neste `stop_id` (em uma estação, em qualquer plataforma).
`page`	integer	Opcional. Página, começa em 1. Por padrão `1`.
`per_page`	integer	Opcional. Resultados por página, 1-100. Por padrão `20`.

curl https://api.croma.run/co/transmilenio/routes-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "B10" }'

Retorna as_of, total, total_is_exact, page, per_page, total_pages, count e routes[]. Cada rota é

{ route_id, short_name, long_name, system, system_name, mode, color, text_color, stops_count, trips_per_week, first_departure, last_departure, services[], headways[] }

route_id: cada sentido de uma rota tem o seu; long_name costuma ser o destino.
services[]: cada quadro de horários da rota, { service_id, days[], trips, first_departure, last_departure }. Os horários são HH:MM:SS do dia de serviço; depois de 24:00:00 é após a meia-noite.
headways[]: janelas em que a rota opera por frequência e não por horário fixo (TransMiCable).

Uma rota

POST /co/transmilenio/route/v1 Dataset Retorna uma rota com suas paradas em ordem e, se pedido, seu traçado.

Campo	Tipo	Notas
`route_id`	string	Obrigatório. O `route_id` da busca de rotas, p. ex. `10075`.
`include_geometry`	boolean	Opcional. `true` adiciona o traçado de cada percurso como GeoJSON `LineString`. Padrão `false`. Por padrão `false`.

curl https://api.croma.run/co/transmilenio/route/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "route_id": "10075" }'

Retorna as_of, found e route: os campos da rota mais patterns[], cada sequência de paradas distinta que ela opera, a mais frequente primeiro: { shape_id, trips_per_week, length_m, geometry, stops[] }. Cada parada é { sequence, stop_id, name, code, latitude, longitude, offset_seconds }, onde offset_seconds é o tempo programado desde a primeira parada.

Veículos ao vivo

POST /co/transmilenio/vehicles/v1 Live Onde estão os veículos agora, em uma rota ou ao redor de um ponto.

Campo	Tipo	Notas
`route`	string	Opcional. Um `route_id`, ou o código impresso no ônibus (`B10`, `C25`, `T25`); um código cobre todos os sentidos da rota.
`latitude`	number,null	Opcional. Latitude de um ponto, p. ex. `4.6486`. Com `longitude`, só o que está a menos de `radius_m`, o mais próximo primeiro. Por padrão `null`.
`longitude`	number,null	Opcional. Longitude do ponto, p. ex. `-74.0633`. Por padrão `null`.
`radius_m`	integer	Opcional. Metros ao redor do ponto, 50-5000. Padrão `500`. Por padrão `500`.
`page`	integer	Opcional. Página, começa em 1. Por padrão `1`.
`per_page`	integer	Opcional. Veículos por página, 1-500. Padrão `100`. Por padrão `100`.

curl https://api.croma.run/co/transmilenio/vehicles/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "route": "B10" }'

Retorna as_of (quando os veículos reportaram pela última vez), total, page, per_page, total_pages, count e vehicles[]:

{ vehicle_id, label, license_plate, latitude, longitude, bearing, speed_kmh, route_id, route_code, route_name, system, trip_id, trip_start_time, stop_id, stop_name, stop_status, reported_at, distance_m }

. stop_status é incoming_at, stopped_at ou in_transit_to em relação à parada indicada.

Chegadas ao vivo em uma parada

POST /co/transmilenio/stop-arrivals/v1 Live Os veículos indo para uma parada agora, o mais próximo primeiro.

Campo	Tipo	Notas
`stop_id`	string	Obrigatório. O `stop_id` da busca de paradas, p. ex. `10000`. Uma estação cobre todas as plataformas dela.
`route`	string	Opcional. Um `route_id`, ou o código impresso no ônibus (`B10`, `C25`, `T25`); um código cobre todos os sentidos da rota.
`limit`	integer	Opcional. Quantos retornar, 1-200. Padrão `20`. Por padrão `20`.

curl https://api.croma.run/co/transmilenio/stop-arrivals/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "stop_id": "10000" }'

Retorna as_of, found, stop_name, count e arrivals[]:

{ predicted_at, minutes_away, delay_seconds, stop_id, route_id, route_code, route_name, system, trip_id, vehicle_id, vehicle_label, license_plate }

. delay_seconds é positivo quando o veículo está atrasado em relação ao horário. Cada veículo é previsto na sua próxima parada, então a lista traz os veículos cuja próxima parada é esta.

Alertas do serviço

POST /co/transmilenio/alerts/v1 Live Os alertas vigentes agora, para toda a rede, uma rota ou uma parada.

Campo	Tipo	Notas
`route`	string	Opcional. Um `route_id`, ou o código impresso no ônibus (`B10`, `C25`, `T25`); um código cobre todos os sentidos da rota.
`stop_id`	string	Opcional. Só os alertas que afetam este `stop_id` (em uma estação, qualquer plataforma).

curl https://api.croma.run/co/transmilenio/alerts/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Retorna as_of, count e alerts[]: { alert_id, cause, effect, header, description, url, active_periods[], routes[], stops[] }. effect é detour, no_service, reduced_service, significant_delays, stop_moved, …; os textos ficam em espanhol como o sistema os escreve.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.

Primeiros passos

Tipos de solicitação

Monitores

Feedback

Países

Buscar paradas

Uma parada

Partidas de uma parada

Buscar rotas

Uma rota

Veículos ao vivo

Chegadas ao vivo em uma parada

Alertas do serviço

Referência completa

​Buscar paradas

​Uma parada

​Partidas de uma parada

​Buscar rotas

​Uma rota

​Veículos ao vivo

​Chegadas ao vivo em uma parada

​Alertas do serviço

Referência completa

Buscar paradas

Uma parada

Partidas de uma parada

Buscar rotas

Uma rota

Veículos ao vivo

Chegadas ao vivo em uma parada

Alertas do serviço