Visão geral da API Distance Matrix

A API Distance Matrix é um serviço que aceita uma solicitação HTTPS que contêm origens e destinos para um determinado meio de transporte. Para cada combinação de origem e destino, ele retorna a distância e a duração da viagem.

Por que usar a API Distance Matrix

Você pode usar a API Distance Matrix para determinar a melhor trajetos de viagem entre várias origens e destinos possíveis. Para exemplo, quais trabalhadores enviar para locais de trabalho ou de quais armazéns enviar pacotes.

O que você pode fazer com a API Distance Matrix

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

A API Distance Matrix fornece informações com base no trajeto recomendado entre os pontos inicial e final. Você pode solicitar estes 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 com 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 um origem e todos os destinos solicitados, começando com a primeira origem em a solicitação e prosseguir por etapas para a próxima.

Por exemplo, se a solicitação especificar A e B como origens e C e D como destinos, ela retornará distâncias e 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, em 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 no a API Distance Matrix com 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, coordenadas de latitude/longitude.

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

Como usar a API Distance Matrix

1 Prepare-se. Comece com a etapa Configurar seu projeto do Google Cloud e conclua a configuração as instruções a seguir.
2 Usar uma solicitação de matriz de distância Quando você tiver uma chave de API, poderá começar a testar a API Distance Matrix diretamente no navegador. Consulte Exemplos de solicitações. no guia Vamos começar para exemplos.
3 Criar uma solicitação mais complexa Tente uma solicitação que forneça várias origens e destinos. Aprender sobre parâmetros opcionais para restringir cálculos, como um valor horário de partida ou restrições de trajeto. Consulte Parâmetros opcionais no guia de solicitação e resposta do Distance Matrix.
4 Noções básicas sobre respostas Analise as respostas de dados para se preparar 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 o tempo e a distância do percurso.

Bibliotecas de clientes disponíveis

Chame essa API no idioma do sua escolha por meio de uma das seguintes bibliotecas de cliente:

Os clientes Java, Python, Go e Node.js para Google Maps Os serviços são bibliotecas-cliente com suporte da comunidade, com código aberto de acordo com 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