API Distance Matrix

A API Matrix calcula tempos de viagem e distâncias entre cada combinação de origens e destinos num único pedido. Os casos de uso típicos incluem encontrar o condutor ou técnico mais próximo de um trabalho, resolver problemas de encaminhamento de veículos, estimar janelas de tempo de entrega para clientes, e calcular a cobertura da área de serviço para planeamento de instalações.

A API Directions devolve uma única rota detalhada entre dois pontos, incluindo instruções de viragem e geometria. A API Matrix devolve uma tabela de distâncias e durações para múltiplos pares origem-destino sem geometria de rota. Se precisar de comparar muitas localizações de forma eficiente, a API Matrix é mais rápida e mais rentável do que fazer chamadas individuais à Directions.

A API suporta matrizes até 100 origens por 100 destinos num único pedido, fornecendo até 10.000 pares origem-destino por chamada. As matrizes não precisam de ser quadradas: pode enviar 1 origem por 100 destinos para uma pesquisa de localização próxima, ou 50 por 50 para uma atribuição completa frota-cliente.

A API Matrix suporta condução, caminhada, ciclismo e transportes públicos. O modo de viagem é definido por pedido. Todos os pares num único pedido utilizam o mesmo modo. Se precisar de resultados de modo misto, envie pedidos separados para cada modo e junte as respostas na sua aplicação.

Por predefinição, a API Matrix utiliza velocidades de tráfego livre representativas das condições de viagem típicas. As durações ajustadas ao tráfego em tempo real estão disponíveis nos planos elegíveis. Defina o parâmetro departure_time para uma marca de tempo futura para receber estimativas de viagem baseadas na hora do dia, fundamentadas em padrões de tráfego históricos.

Envie a sua única localização de consulta como origem e a sua lista de localizações candidatas como destinos. A API devolve o tempo de viagem e a distância do ponto de consulta a cada candidato numa única chamada. Ordene a resposta por duração para encontrar a opção mais próxima. Isto é significativamente mais eficiente do que chamar a API Directions em ciclo para cada candidato.