Visão geral da API Distance Matrix (legada)

Desenvolvedores do Espaço Econômico Europeu (EEE)

Introdução

A API Distance Matrix (legada) é 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 da viagem.

Por que usar a API Distance Matrix (legada)

Você pode usar a API Distance Matrix (legada) para ajudar a determinar as rotas de viagem mais eficientes entre várias origens e destinos possíveis. Por 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 (legada)

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

A API Distance Matrix (legada) fornece informações com base na rota recomendada entre os pontos de partida e de chegada. Você pode solicitar estes tipos de dados de distância:

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

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

Como a API Distance Matrix (legada) funciona

A API Distance Matrix (legada) 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 prosseguindo 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 para C
  • A para D
  • B para C
  • B para D

O exemplo a seguir mostra uma solicitação de 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 na API Distance Matrix (legada) e os dados que ela retorna.

Recursos de dados Dados retornados Formato de retorno
Matriz de distância

Forneça 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 cada destino
  • Duração no trânsito se você especificou o modo de direção e um horário de partida
  • JSON
  • XML

Como usar a API Distance Matrix (legada)

1 Configurar Comece com Configurar seu projeto do Google Cloud e siga as instruções de configuração.
2 Fazer uma solicitação de matriz de distância Depois de ter uma chave de API, você pode começar a testar a API Distance Matrix (legada) diretamente no navegador. Consulte Exemplos de solicitações no guia Introdução para ver exemplos.
3 Escrever uma solicitação mais complexa Tente uma solicitação que forneça várias origens e destinos. Saiba mais sobre os 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 Solicitação e resposta da API Distance Matrix (legada).
4 Entender os conceitos básicos de resposta Explore as respostas de dados para se preparar para usar dados de matriz de distância no seu app. Consulte Respostas da matriz de distância para mais detalhes.
5 Incorporar dados de matriz de distância no seu próprio app Você pode usar esses dados para calcular a distância e o tempo de viagem.

Bibliotecas de clientes disponíveis

Chame essa API no idioma de sua preferência usando uma das seguintes bibliotecas de cliente:

Os clientes Java, Python, Go e Node.js dos 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 delas no GitHub, onde você também pode encontrar instruções de instalação e exemplos de código.

A seguir