Visão geral da API Distance Matrix

A API Distance Matrix é um serviço que aceita uma solicitação HTTPS contendo origens e destinos para um determinado meio de transporte. Para cada combinação de origem e destino, ela retorna a distância e a duração do percurso.

Por que usar a API Distance Matrix

Você pode usar a API Distance Matrix para determinar os trajetos de viagem mais eficientes entre várias origens e destinos possíveis. Por exemplo, quais workers enviar para locais de jobs ou de quais warehouses enviar pacotes.

O que você pode fazer com a API Distance Matrix

Com a API Distance Matrix, você pode informar a distância e o tempo de deslocamento para uma matriz de origens e destinos. Você pode especificar várias opções, incluindo o meio de transporte, como carro, bicicleta, transporte público ou a pé, e de transporte público, como ônibus, metrô, trem, bonde ou trem.

A API Distance Matrix fornece informações com base na rota recomendada entre os pontos inicial e final. Você pode solicitar os seguintes tipos de dados de distância:

  • Distância de um meio de transporte selecionado
  • Distância em quilômetros ou milhas
  • Tempo estimado de viagem no trânsito

mapa mostrando a origem e os destinos em um mapa e na resposta da API

Como a API Distance Matrix funciona

A API Distance Matrix usa qualquer número de origens (pontos de partida) e destinos e retorna a distância e o tempo de viagem entre cada origem e todos os destinos solicitados, começando pela primeira origem na solicitação e avançando para a próxima.

Por exemplo, se sua solicitação especificar A e B como origens e C e D como destinos, ela retornará as distâncias e o tempo de viagem nesta ordem:

  • A a C
  • A a D
  • B a C
  • B a D

O exemplo a seguir mostra uma solicitação para duas origens: Washington, DC e Boston, com um único destino, Nova York, NY, no formato JSON:

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=New%20York%20City%2C%20NY
  &origins=Washington%2C%20DC%7CBoston
  &units=imperial
  &key=YOUR_API_KEY

Recursos

A tabela a seguir resume os recursos disponíveis pela API Distance Matrix e os dados retornados.

Recursos de dados Dados retornados Formato de devolução
Matriz de distância

Informe origens e destinos na forma de IDs de lugar, endereços ou coordenadas de latitude/longitude.

  • Distância e tempo de viagem entre cada origem e destino
  • Duração no trânsito, se você especificou o modo carro e um horário de partida
  • JSON
  • XML

Como usar a API Distance Matrix

1 Prepare-se. Comece com Configurar seu projeto do Google Cloud e conclua as instruções de configuração a seguir.
2 Testar uma solicitação de matriz de distância Quando você tiver uma chave de API, poderá testar a API Distance Matrix diretamente no seu navegador. Consulte Exemplos de solicitações no guia Primeiros passos para mais exemplos.
3 Fazer uma solicitação mais complexa Faça uma solicitação que inclua várias origens e destinos. Saiba mais sobre os parâmetros opcionais para restringir os cálculos, como um horário de partida especificado ou restrições de trajeto. Consulte Parâmetros opcionais no guia de solicitação e resposta da Distance Matrix.
4 Noções básicas sobre respostas Explore as respostas de dados e se prepare para usar os dados de matriz de distância no seu app. Consulte Respostas da matriz de distância para mais detalhes.
5 Incorpore dados de matriz de distância no seu app. Você pode usar esses dados para calcular a distância e o tempo do percurso.

Bibliotecas de clientes disponíveis

Chame essa API na linguagem que preferir usando uma destas bibliotecas de cliente:

Os clientes Java, Python, Go e Node.js para serviços do Google Maps são bibliotecas de cliente apoiadas pela comunidade e que têm código aberto sob a Licença Apache 2.0. Faça o download deles no GitHub, onde também é possível encontrar instruções de instalação e exemplos de código.

A seguir