Use a API Distance Matrix quando a solução exigir distância e tempo de viagem entre uma grande lista de pontos de origem e destino.
Se você quiser usar a funcionalidade da Distance Matrix e conseguir serialização de solicitações e desserialização de respostas, novas tentativas automáticas e alguma validação de solicitações de cliente, tente uma das nossas bibliotecas de cliente. Se você já está usando a API Maps JavaScript, utilize o serviço de matriz de distância para ter a funcionalidade da API Distance Matrix.
Observação: esse serviço não retorna informações detalhadas sobre o trajeto. Para fazer isso, transmita a origem e o destino desejados para a API Directions.
Solicitação e resposta da API Distance Matrix
Uma solicitação da Google Distance Matrix API apresenta a seguinte forma:
https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
em que outputFormat pode ser um dos seguintes valores:
- json (recomendado), indica a saída em JavaScript Object Notation (JSON) ou
- xml, indica a saída como XML.
Observação: os URLs precisam ser codificados corretamente para serem válidos e são limitados a 8.192 caracteres para todos os serviços da Web. Esteja ciente desse limite ao criar seus URLs. Observe que navegadores, proxies e servidores diferentes também podem ter limites de caracteres de URL diferentes.
Como usar a matriz de distância
Acesse a API Distance Matrix por uma interface HTTP com solicitações criadas como uma string de URL, transmitindo origens e destinos, com sua chave de API.
- Se você quiser usar uma das nossas bibliotecas de cliente em vez da API Distance Matrix autônoma ou do serviço da Web do lado do cliente, faça o download e a instalação. Saiba mais sobre nossas bibliotecas de cliente.
- Escolha ou crie um projeto, ative o faturamento e ative a API Distance Matrix. Consulte Configurar no Console do Cloud.
- Crie e restrinja uma chave de API e a adicione ao seu código. Consulte Usar uma chave de API.
- Veja uma solicitação e resposta da Distance Matrix e tente um exemplo de solicitação.
Conteúdo recomendado
- Bibliotecas de cliente: use uma das nossas bibliotecas de cliente, que inclui a funcionalidade de várias APIs, incluindo a Distance Matrix.
- Práticas recomendadas para o serviço da Web: aprenda várias práticas recomendadas para usar e trabalhar com a matriz de distância.
- Notas da versão: veja as notas da versão da Distance Matrix.
- Informações de faturamento e cota: encontre as unidades e os custos de faturamento da matriz de distância.
- Políticas e restrições: entenda as restrições do uso da matriz de distância.