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 Distance Matrix API, 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
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. |
|
|
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:
- Java Cliente para serviços do Google Maps
- Python Cliente para serviços do Google Maps
- Cliente Go para serviços do Google Maps
- Node.js Cliente para serviços do Google Maps
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
- Comece a usar o Distance Matrix: acesse Primeiros passos.
- Comece a usar exemplos de solicitações e respostas: acesse Distance Matrix solicitação e resposta
- Siga as práticas recomendadas: acesse Práticas recomendadas para serviços da Web práticas.