Metro de Bogotá

A Empresa Metro de Bogotá S.A. constrói a primeira linha de metrô da cidade, um viaduto elevado de 16 estações do sudoeste até a Calle 72, e tem em projeto a Linha 2, 11 estações, quase todas subterrâneas, em direção a Suba e Engativá. Publica por onde tudo passa: as estações, o traçado de cada linha, o viaduto, o limite das obras e os edifícios por onde se entra em cada estação. Encontre as estações mais próximas de um ponto com a distância até cada uma, consulte uma com seus edifícios de acesso, obtenha a linha como GeoJSON e leve os shapefiles oficiais. Serve para medir a que distância um imóvel, uma agência ou um cliente fica de uma futura estação. Também publica quais imóveis a primeira linha requer, como as obras avançam a cada mês frente ao planejado e o que acontece com cada árvore do corredor. Tudo está aqui: verifique um imóvel por CHIP ou por ponto, acompanhe a série de avanço desde 2020 e busque no inventário de árvores por espécie, tratamento ou local.

A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz as_of: o quão atuais são os dados. Como funcionam os datasets.

Buscar estações

POST /co/metro-bogota/stations-search/v1 Dataset Encontra estações pelo nome, pela linha ou pela proximidade de um ponto. Comece aqui para obter o id que a consulta de uma estação usa.

Campo	Tipo	Notas
`query`	string	Opcional. Palavras do nome ou do nome de trabalho, p. ex. `Kennedy`, `Calle 72`.
`line`	integer	Opcional. `1` (Linha 1, em construção) ou `2` (Linha 2, em projeto). `0`, o padrão, retorna todas as linhas. Por padrão `0`.
`latitude`	number,null	Opcional. Latitude de um ponto, p. ex. `4.6486`. Com `longitude`, as estações vêm da mais próxima à mais distante, com `distance_m`. 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, até 50000. `0`, o padrão, mantém todas as estações seja qual for a distância. Por padrão `0`.
`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/metro-bogota/stations-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "latitude": 4.6486, "longitude": -74.0633 }'

Retorna as_of, os filtros aplicados, total, page, per_page, total_pages, count e stations[]; cada estação traz distance_m, os metros em linha reta até seu centro, quando a busca parte de um ponto. Cada estação é { id, line, number, name, common_name, station_type, status, note, latitude, longitude, area_m2, geometry }.

id: a linha e o número da estação, p. ex. l1-13.
name: o nome que a Metro de Bogotá publica, p. ex. Estación 13- Central. As estações da Linha 2 ainda têm nomes provisórios numerados (ESTACIÓN 4).
common_name: o nome de trabalho do projeto, quase sempre a via onde fica a estação, p. ex. Calle 26-13.
status: a etapa como publicada, em espanhol: Construcción (Linha 1) ou Diseño (Linha 2).
latitude, longitude: o centro da estação.
geometry: a área da estação, um polígono GeoJSON em WGS84.

Uma estação

POST /co/metro-bogota/station/v1 Dataset Retorna uma estação pelo id, com os edifícios por onde se entra nela.

Campo	Tipo	Notas
`station_id`	string	Obrigatório. O `id` da estação, obtido na busca, p. ex. `l1-13`.

curl https://api.croma.run/co/metro-bogota/station/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "station_id": "l1-13" }'

Retorna as_of, found, station_id, station (null quando não existe) e access_buildings[], cada um com seu polígono. Cada estação é { id, line, number, name, common_name, station_type, status, note, latitude, longitude, area_m2, geometry }.

id: a linha e o número da estação, p. ex. l1-13.
name: o nome que a Metro de Bogotá publica, p. ex. Estación 13- Central. As estações da Linha 2 ainda têm nomes provisórios numerados (ESTACIÓN 4).
common_name: o nome de trabalho do projeto, quase sempre a via onde fica a estação, p. ex. Calle 26-13.
status: a etapa como publicada, em espanhol: Construcción (Linha 1) ou Diseño (Linha 2).
latitude, longitude: o centro da estação.
geometry: a área da estação, um polígono GeoJSON em WGS84.

Um ponto em relação ao metrô

POST /co/metro-bogota/proximity/v1 Dataset Entra uma coordenada, sai o quão perto ela está do metrô: estações, linhas e obras.

Campo	Tipo	Notas
`latitude`	number	Obrigatório. Latitude em graus decimais (WGS84), p. ex. `4.6486`.
`longitude`	number	Obrigatório. Longitude em graus decimais (WGS84), negativa em Bogotá, p. ex. `-74.0633`.

curl https://api.croma.run/co/metro-bogota/proximity/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "latitude": 4.594147, "longitude": -74.097327 }'

Retorna as_of, latitude, longitude e:

nearest_station: a estação mais próxima de qualquer linha, com distance_m até seu centro.
stations_within_1km: quantas estações têm o centro a menos de 1.000 metros.
inside_intervention_limit: se o ponto está dentro da área de obras da Linha 1.
intervention_limit_distance_m: metros até a borda dessa área; 0 se estiver dentro.
parcel: o imóvel necessário para a Linha 1 que contém o ponto, com seu CHIP, endereço e polígono; null quando nenhum o contém.
parcels_within_100m: quantos desses imóveis têm o centro a menos de 100 metros.
lines[]: por linha, { line, alignment_distance_m, nearest_station }: a distância ao traçado da linha e a estação mais próxima dessa linha.

As distâncias são em linha reta, medidas sobre as formas publicadas, com precisão de cerca de um metro. Não são distâncias a pé.

Imóveis necessários para a Linha 1

POST /co/metro-bogota/parcels-search/v1 Dataset Este imóvel está entre os que o metrô precisa? Pergunte por CHIP, por endereço ou por ponto.

Campo	Tipo	Notas
`query`	string	Opcional. Palavras do endereço como Bogotá o escreve, p. ex. `KR 24B 2 10 SUR`.
`chip`	string	Opcional. O CHIP do imóvel, exato, p. ex. `AAA0011RDTO`.
`latitude`	number,null	Opcional. Latitude de um ponto, p. ex. `4.5967`. Com `longitude`, só o que está a menos de `radius_m`, o mais próximo primeiro, com `distance_m`. Por padrão `null`.
`longitude`	number,null	Opcional. Longitude do ponto, p. ex. `-74.0995`. Por padrão `null`.
`radius_m`	integer	Opcional. Metros ao redor do ponto, 10-5000. Padrão `200`. Por padrão `200`.
`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/metro-bogota/parcels-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "chip": "AAA0011RDTO" }'

Retorna as_of, os filtros aplicados, total, page, per_page, total_pages, count e parcels[]; cada imóvel traz distance_m quando a busca parte de um ponto (0 quando o ponto está sobre ele). Uma lista vazia significa que o imóvel não está na consulta. Cada imóvel é { id, chip, address, line, latitude, longitude, area_m2, geometry }.

chip: o identificador cadastral do imóvel em Bogotá, p. ex. AAA0011RDTO. Serve para cruzar com o cadastro da cidade.
address: o endereço como publicado, p. ex. CL 1 24 09.
area_m2: a área medida sobre o polígono.
geometry: o imóvel, um polígono GeoJSON em WGS84.

São os imóveis que a Metro de Bogotá lista em sua consulta pública de imóveis da Linha 1. A lista diz que um imóvel é necessário para a linha, não em que etapa está sua aquisição, e não traz proprietário nem ocupante. Confirme a situação atual de um imóvel com a Metro de Bogotá.

Avanço das obras

POST /co/metro-bogota/progress/v1 Dataset A porcentagem construída frente à planejada, mês a mês, e em que ponto o projeto está hoje.

Campo	Tipo	Notas
`from_month`	string	Opcional. Primeiro mês da série, `yyyy-mm`, p. ex. `2026-01`.
`to_month`	string	Opcional. Último mês da série, `yyyy-mm`.

curl https://api.croma.run/co/metro-bogota/progress/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "from_month": "2026-01" }'

Retorna as_of, line, o intervalo pedido, count e:

latest: o mês mais recente com avanço físico informado.
months[]: { month, line, planned_pct, executed_pct, planned_month_pct, executed_month_pct, schedule_baseline, budget_planned_cop, budget_planned_cumulative_cop, budget_executed_cop, budget_executed_cumulative_cop, budget_executed_month_pct, budget_executed_cumulative_pct, budget_baseline }. planned_pct e executed_pct são o avanço físico acumulado em porcentagem; os campos _month_ são só o mês.
project: o valor do projeto em pesos (value_cop), o início da concessão (start_date) e o início de operação previsto (end_date).
stages[]: cada etapa com suas datas.
activities[]: o que está em andamento, com status e a data de corte do relatório (reported_on).
milestones[]: o que foi alcançado no último período informado, com a data (end_date).

Nomes, estados e notas vêm em espanhol, como publicados.

Remanejamento de redes

POST /co/metro-bogota/network-relocation-search/v1 Dataset As redes de água, energia, gás e telecom que o metrô precisa mover, e como vai cada uma.

Campo	Tipo	Notas
`query`	string	Opcional. Palavras do código de interferência ou da concessionária, p. ex. `COD-00`, `EAAB`.
`utility`	string	Opcional. Uma concessionária (ESP): `CODENSA`, `VANTI`, `EAAB`, `ETB`, `TELEFÓNICA`.
`status`	enum	Opcional. `por_iniciar`, `en_ejecucion`, `ejecutada` ou `eliminada`.
`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/metro-bogota/network-relocation-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "utility": "EAAB" }'

Retorna as_of, os filtros aplicados, total, page, per_page, total_pages, count e interferences[]. Cada uma é

{ id, line, utility, interference, segment, contract_group, agreement, status, planned_pct, executed_pct, compliance_index, compliance_status, deadline_status, planned_start, planned_end, deadline, slack_days, reported_on }

. As partes são concessionárias; não há dados pessoais. O relatório foi publicado pela última vez em 2022.

Inventário de árvores

POST /co/metro-bogota/trees-search/v1 Dataset Cada árvore que as obras tocam: o que foi autorizado para ela, se foi feito e quando.

Campo	Tipo	Notas
`query`	string	Opcional. Palavras do nome comum, da espécie ou da localização, p. ex. `Caucho sabanero`, `Ficus`.
`treatment`	enum	Opcional. `tala`, `traslado`, `tratamiento_integral`, `conservacion` ou `poda`.
`status`	enum	Opcional. `ejecutado`, `no_ejecutado` ou `sin_reporte`.
`locality`	string	Opcional. Uma localidad de Bogotá, p. ex. `KENNEDY`, `BOSA`, `CHAPINERO`.
`latitude`	number,null	Opcional. Latitude de um ponto, p. ex. `4.5967`. Com `longitude`, só o que está a menos de `radius_m`, o mais próximo primeiro, com `distance_m`. Por padrão `null`.
`longitude`	number,null	Opcional. Longitude do ponto, p. ex. `-74.0995`. Por padrão `null`.
`radius_m`	integer	Opcional. Metros ao redor do ponto, 10-5000. Padrão `200`. Por padrão `200`.
`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/metro-bogota/trees-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "treatment": "traslado", "locality": "KENNEDY" }'

Retorna as_of, os filtros aplicados, total, page, per_page, total_pages, count e trees[]; cada árvore traz distance_m quando a busca parte de um ponto. Cada árvore é

{ id, tree_number, line, common_name, scientific_name, sigau_code, treatment, status, executed_on, scheduled_from, scheduled_to, permit, work_front, work_front_group, chainage, locality, locality_code, upz, location, relocation_site, height_m, trunk_perimeter_m, trunk_diameter_cm, height_category, stump_category, botanical_garden_record, latitude, longitude, coordinates_approximate, relocation_location, relocation_latitude, relocation_longitude, note }

treatment: o que a licença ambiental autoriza: tala (corte), traslado (transplante), tratamiento_integral, conservacion ou poda.
status: ejecutado, no_ejecutado ou sin_reporte; executed_on é a data em que foi feito.
permit: o ato administrativo que respalda o tratamento.
relocation_site: para uma árvore transplantada, para onde foi levada.
coordinates_approximate: true quando o inventário indica que a árvore não tem coordenadas próprias.

Traçado e obras

POST /co/metro-bogota/infrastructure-search/v1 Dataset A linha e o que se constrói ao seu redor, como formas para desenhar em um mapa ou para medir em relação a elas.

Campo	Tipo	Notas
`kind`	enum	Opcional. `alignment` (traçado), `viaduct` (viaduto), `intervention_limit` (limite de intervenção), `access_building` (edifício de acesso) ou `depot` (Patio Taller). Todos por padrão.
`line`	integer	Opcional. `1` (Linha 1, em construção) ou `2` (Linha 2, em projeto). `0`, o padrão, retorna todas as linhas. Por padrão `0`.
`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/metro-bogota/infrastructure-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "kind": "alignment" }'

Retorna as_of, os filtros aplicados, total, page, per_page, total_pages, count e results[]. Cada resultado é { id, kind, line, name, station_id, note, latitude, longitude, length_m, area_m2, geometry, geometry_url }.

kind: alignment (o traçado da linha), viaduct (a estrutura elevada por onde circulam os trens da Linha 1), intervention_limit (toda a área de projeto, construção e operação da Linha 1), access_building (um edifício por onde se entra em uma estação) ou depot (o Patio Taller, o pátio e as oficinas da Linha 1).
station_id: para um edifício de acesso, a estação a que pertence.
length_m, area_m2: o comprimento de um traçado em metros; o perímetro e a área de um polígono.
geometry: a forma como GeoJSON em WGS84. As formas mais detalhadas (o viaduto, o traçado da Linha 1, o limite de intervenção) vêm simplificadas com precisão de cerca de um metro, e com todos os pontos publicados em geometry_url.

Camadas e shapefiles

POST /co/metro-bogota/layers/v1 Dataset As camadas publicadas, cada uma com o arquivo oficial para abrir em um SIG.

Campo	Tipo	Notas
`line`	integer	Opcional. `1` (Linha 1, em construção) ou `2` (Linha 2, em projeto). `0`, o padrão, retorna todas as linhas. Por padrão `0`.

curl https://api.croma.run/co/metro-bogota/layers/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "line": 1 }'

Retorna as_of, line, count e layers[]. Cada camada é

{ id, line, kind, title, description, geometry_type, feature_count, file_name, bytes, modified_at, source_document_url, document_url, document_versions[] }

document_url: o shapefile compactado da camada, exatamente como a Metro de Bogotá o publicou. source_document_url é o mesmo arquivo na Metro de Bogotá.
document_versions[]: cada versão do arquivo, da mais antiga à mais recente, { document_url, modified_at, bytes }. Surge uma nova quando a Metro de Bogotá substitui o arquivo.
Os edifícios de acesso da Linha 1 são publicados sem arquivo: seu file_name e seus campos de documento são null.

Referência completa

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

Primeiros passos

Tipos de solicitação

Monitores

Feedback

Países

Buscar estações

Uma estação

Um ponto em relação ao metrô

Imóveis necessários para a Linha 1

Avanço das obras

Remanejamento de redes

Inventário de árvores

Traçado e obras

Camadas e shapefiles

Referência completa

​Buscar estações

​Uma estação

​Um ponto em relação ao metrô

​Imóveis necessários para a Linha 1

​Avanço das obras

​Remanejamento de redes

​Inventário de árvores

​Traçado e obras

​Camadas e shapefiles

Referência completa

Buscar estações

Uma estação

Um ponto em relação ao metrô

Imóveis necessários para a Linha 1

Avanço das obras

Remanejamento de redes

Inventário de árvores

Traçado e obras

Camadas e shapefiles