Isócronas

Aplicações

A isócrona delimita a região do espaço que pode ser alcançada, a partir de um ponto de origem (ou até um ponto de destino), dentro de um limite de tempo de deslocamento — considerando a malha viária real. É a base geoespacial para decisões de localização, cobertura e territorialização.

Conceito

Uma isócrona é um polígono que delimita todos os pontos do território que podem ser alcançados, a partir (ou até) uma coordenada de referência, dentro de um determinado limite de tempo de deslocamento. Diferente de um raio simples (círculo euclidiano), ela é calculada sobre a malha viária real — respeitando ruas, velocidades permitidas, sentidos e topologia da rede.

O parâmetro sentido define a semântica da isócrona: SAINDO significa “a partir deste ponto, aonde eu consigo chegar em X segundos?” — o polígono é construído seguindo o sentido natural das vias. Já INDO significa “de onde eu consigo chegar até este ponto em X segundos?” — o polígono é construído seguindo as vias no sentido reverso. Em malhas com muitas vias de mão única, os dois polígonos podem ser bastante diferentes.

Isócrona × isodistância × buffer: por que a diferença importa

Três recortes reais a partir do mesmo ponto — Av. Paulista, 2064, São Paulo/SP (-23.558308, -46.659477), perfil car:

Isócrona por tempo — 5 min de carro
malha viária + velocidades reais

Isodistância — 500 m pela malha
distância acumulada via ruas

Buffer 500 m
círculo euclidiano, ignora ruas

A isócrona por tempo reflete a velocidade real do perfil (o polígono cresce mais rápido nas vias principais). A isodistância mede o alcance rodoviário absoluto — bom quando o critério de negócio é "raio de X metros de rua". O buffer euclidiano é uma referência geométrica pura (círculo perfeito) — normalmente superestima a área acessível na prática.

Sentido: SAINDO vs INDO

Escolha o sentido conforme a pergunta de negócio que você quer responder. Ambos os sentidos utilizam o mesmo time_limit em segundos e o mesmo profile de deslocamento.

Parâmetros de Entrada

Exemplos

Dois cenários a partir do mesmo endereço — Av. das Nações Unidas, 12995, São Paulo/SP (-23.605541, -46.696247) — ilustram como o sentido (SAINDO/INDO) e o perfil de deslocamento mudam completamente o polígono retornado. O campo geometria retorna sempre um POLYGON em formato WKT pronto para ser consumido por PostGIS, GeoPandas ou bibliotecas de visualização.

Isócrona de 15 min de carro (SAINDO) — Av. das Nações Unidas, 12995, São Paulo/SP lat=-23.605541, lng=-46.696247 · profile=car · time_limit=900 · sentido=SAINDO · condicao_transito=normal

{
  "geometria": "POLYGON ((-46.7392 -23.5719, ..., -46.7392 -23.5719))",
  "modo": "tempo",
  "limite_tempo_s": 900,
  "limite_distancia_m": null,
  "perfil": "car",
  "sentido": "SAINDO",
  "area_m2": 26814000,
  "condicao_transito": "normal",
  "fator_temporal": 0.7,
  "limite_tempo_s_efetivo": 630,
  "municipio_ibge": 3550308
}

Polígono da região alcançável em até 15 minutos saindo do ponto, dirigindo em condicao_transito=normal (fator 0,7 — o motor recebe 630 s efetivos, refletindo a velocidade típica de um dia útil fora de pico). O contorno é fortemente alongado ao longo das Marginais Pinheiros e Av. das Nações Unidas, mostrando como o eixo viário determina o alcance real — muito diferente de um círculo geodésico.

Barreiras físicas aparecem no polígono. O Rio Pinheiros corta a área em duas: o lado oposto (Butantã, Morumbi) é praticamente inacessível dentro do orçamento de 15 min porque só pode ser atravessado pelas poucas pontes existentes — cada travessia consome minutos do budget. Um buffer euclidiano de mesma "distância equivalente" cruzaria o rio como se não existisse. Este é um caso clássico de por que isócrona ≠ raio.

Isócrona de 30 min a pé (INDO) — mesmo endereço lat=-23.605541, lng=-46.696247 · profile=foot · time_limit=1800 · sentido=INDO

{
  "geometria": "POLYGON ((-46.7018 -23.5891, ..., -46.7018 -23.5891))",
  "modo": "tempo",
  "limite_tempo_s": 1800,
  "limite_distancia_m": null,
  "perfil": "foot",
  "sentido": "INDO",
  "area_m2": 3812400,
  "condicao_transito": "normal",
  "fator_temporal": 1.0,
  "limite_tempo_s_efetivo": 1800,
  "municipio_ibge": 3550308
}

Polígono da região de onde pedestres conseguem chegar até o ponto em até 30 minutos caminhando. Como condicao_transito não afeta perfil foot, o fator_temporal volta para 1,0. A área (~3,8 km²) é ordens de grandeza menor que a de carro pelo mesmo ponto — útil para dimensionar catchment pedestre de um ponto comercial ou estação. Note o formato "espinha" ao longo do corredor Berrini, que reflete a hierarquia viária pedonal.

A barreira do Rio Pinheiros é ainda mais evidente a pé. Como pedestres têm menos opções de travessia (basicamente as passarelas), o polígono fica quase todo confinado ao lado leste do rio — bairros como Morumbi e Chácara Santo Antônio, mesmo geograficamente próximos, ficam funcionalmente inacessíveis no orçamento de 30 min. Um raio euclidiano de 2 km, por outro lado, cobriria os dois lados sem distinção — e superestimaria a captação pedestre real do endereço.

Atributos Retornados

O retorno do endpoint /routing/isochrone segue o schema IsochroneResponseSchema e contém a geometria do polígono da isócrona e os metadados do cálculo.

Detalhes Técnicos

Limitações