Principais conceitos

Para gerar uma isócrona, forneça à API uma origem, um modo de viagem, como carro, bicicleta ou a pé, e um limite de tempo. Também é possível ajustar as preferências de trajeto e a aparência visual do polígono resultante.

Horizonte temporal

A principal restrição que você fornece ao serviço é a travel_duration. Ela define o horizonte temporal para o cálculo.

• Duração máxima:a API oferece um tempo máximo de viagem de 3.600 segundos (1 hora) para o modo DRIVE e 7.200 segundos (2 horas) para os modos WALK e BICYCLE.
• Performance:o tempo de cálculo é dimensionado de acordo com a duração solicitada e o modo de viagem selecionado. Uma isócrona de carro de uma hora abrange uma área geográfica e uma rede viária muito maiores do que uma isócrona a pé de uma hora, o que resulta em maior latência para a solicitação de carro.

Pontos de origem e ajuste de estradas

Você pode especificar o ponto de partida da isócrona de duas maneiras:

• Coordenadas:um par de latitude e longitude (location).
• IDs de lugar:um identificador exclusivo de um lugar específico no Google Maps (place). Quando você fornece um ID de lugar, o serviço usa o centroide desse lugar como o ponto de origem. A API espera o formato de nome do recurso, como places/ChIJ.... Para mais informações sobre IDs de lugar, consulte IDs de lugar.

Independentemente do método de entrada, a API não calcula os tempos de viagem do ponto físico exato se ele não estiver em uma estrada, como dentro de um parque ou edifício. Para lidar com essa situação, o serviço usa o ajuste de estradas. O ajuste de estradas tem os seguintes recursos:

• Ajuste inteligente:o serviço tenta ajustar seu ponto de origem ao segmento de estrada mais próximo.
• Reconhecimento de modo:a lógica de ajuste considera seu travel_mode. Se você solicitar DRIVE, a API vai ignorar caminhos exclusivos para pedestres e procurar a rua mais próxima. Se você solicitar WALK, a API vai priorizar caminhos e calçadas.
• Casos de falha:se a API não encontrar um segmento de estrada adequado a aproximadamente 100 metros do ponto de origem, ela vai retornar um erro 404 NOT_FOUND. Isso geralmente indica que o ponto está muito longe da rede viária ou em uma área em que os dados do mapa não oferecem suporte ao modo de viagem solicitado.

Reconhecimento de trânsito

Controle como as informações de trânsito influenciam o polígono gerado com o parâmetro routing_preference:

• TRAFFIC_UNAWARE (padrão) : usa limites de velocidade e hierarquia de estradas para gerar o polígono isócrono. Isso produz uma forma determinística que não varia com base na hora do dia. Esse parâmetro é ideal para análise geral ou planejamento de cenários de referência.
• TRAFFIC_AWARE:calcula isócronas usando condições de trânsito em tempo real ou preditivas no momento da solicitação, fazendo com que a área acessível diminua durante o congestionamento e aumente durante os horários de pico.

Observação: as isócronas com reconhecimento de trânsito são mais sensíveis à latência do que as isócronas sem reconhecimento de trânsito isócronas.

Suavização e fidelidade

Você pode personalizar a aparência e a precisão dos polígonos de saída usando os parâmetros polygon_fidelity e enable_smoothing. Embora essas opções sejam independentes, elas funcionam juntas para determinar a forma final.

• polygon_fidelity:controla o tamanho das células da grade subjacente usadas para calcular a área acessível.

  • LOW:usa células de grade maiores. É melhor para cobrir grandes áreas sem lacunas, resultando em uma forma generalizada.
  • MEDIUM:precisão equilibrada.
  • HIGH:usa células de grade menores. Resulta em um ajuste mais apertado à rede viária, mas pode produzir áreas vazias ou buracos se a rede viária for esparsa.
  • POLYGON_FIDELITY_UNSPECIFIED:se não for especificado, o serviço vai selecionar dinamicamente a fidelidade com base na duração da viagem solicitada.

    

    Fidelidade de polígono alta, média e baixa

• enable_smoothing:controla se as bordas nítidas das células da grade definidas pela fidelidade são arredondadas.

  • false (bruto) : o padrão. Retorna o cálculo geométrico exato. As bordas aparecem irregulares ou escalonadas. É melhor para precisão analítica, como testes rigorosos de ponto em polígono. Latência menor do que a suavizada.
  • true (suavizado) : aplica um algoritmo de pós-processamento para arredondar os cantos. É melhor para exibição visual em mapas.

    

    Isócrona com e sem suavização