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 modo 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

Use 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 vagas ou de quais depósitos enviar pacotes.

O que você pode fazer com a API Distance Matrix

Com a API Distance Matrix, é possível fornecer a distância e o tempo de deslocamento para uma matriz de origens e destinos. É possível especificar várias opções, incluindo modos de transporte, como dirigir, andar de bicicleta, usar transporte público ou caminhar, além de meios de transporte, como ônibus, metrô, trem, bonde ou trilho.

A API Distance Matrix fornece informações com base no trajeto recomendado entre os pontos de partida e chegada. 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 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 percurso entre cada origem e todos os destinos solicitados, começando pela primeira origem na solicitação e seguindo passo a passo 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 para C
  • B a D

O exemplo a seguir mostra uma solicitação para duas origens: Washington, DC e Boston, com um único destino, New York City, 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 na API Distance Matrix e os dados que ela retorna.

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

Forneça origens e destinos em forma de IDs de lugar, endereços ou 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 em Configurar seu projeto do Google Cloud e siga 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á começar a testar a API Distance Matrix diretamente no navegador. Confira exemplos em Solicitações de amostra no guia Primeiros passos.
3 Criar uma solicitação mais complexa Faça uma solicitação que forneça várias origens e destinos. Saiba mais sobre parâmetros opcionais para restringir cálculos, como um horário de partida especificado ou restrições de rota. 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 dados de matriz de distância no seu app. Consulte Respostas de matriz de distância para mais detalhes.
5 Incorpore dados de matriz de distância ao 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 de sua escolha usando uma das seguintes bibliotecas de cliente:

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