A matriz de rotas de computação é um método no serviço da API Routes que aceita uma solicitação HTTPS e retorna distâncias e tempos de viagem para uma matriz de rotas entre diferentes locais de origem e destino. Calcule os tempos de viagem e as distâncias para vários destinos com até 625 elementos de trajeto.
Precisa de rotas de carro? Se você tiver interesse em rotas, consulte a Visão geral das rotas do Compute.
Migrando? Se você estiver migrando da API Distance Matrix (legado), consulte as instruções de migração começando com Por que migrar para a API Routes.
Por que usar a Compute Routes Matrix
Com a matriz de rotas de computação, você pode determinar as rotas mais eficientes para a programação de envio, como:
A melhor forma de atribuir um conjunto de workers para retirar uma série de pacotes
Determinar o melhor depósito para enviar pacotes ao destino final
O que você pode fazer com a Compute Route Matrix?
Com a matriz de rotas do Compute, você pode conferir uma matriz de rotas possíveis entre muitos locais de início e término. É possível especificar várias origens e destinos por solicitação do lado do servidor com o número de origens multiplicado pelo número de destinos até 625. É possível transmitir elementos da resposta antes que a matriz inteira seja calculada, reduzindo a latência da resposta.
É possível solicitar estes tipos de dados de rota para determinar a maneira mais eficiente de rotear passageiros, remessas ou trabalhadores entre várias origens e destinos:
Distância em quilômetros ou milhas para um meio de transporte selecionado
Tempo estimado de viagem no trânsito
Como funciona a Compute Routes Matrix
O método ComputeRouteMatrix
aceita uma solicitação POST HTTP com
um corpo de solicitação JSON que contém os detalhes da solicitação. É necessário ter pelo menos uma origem, dois ou mais destinos, o modo de transporte e uma máscara de campo para especificar quais campos serão retornados.
Exemplo
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420761, "longitude": -122.081356 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.403184, "longitude": -122.097371 } } } } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420999, "longitude": -122.086894 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.383047, "longitude": -122.044651 } } } } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
A resposta contém as rotas possíveis para a combinação de todos os waypoints de origem e destino.
Recursos
A tabela a seguir resume os recursos disponíveis pelo método Compute Route Matrix da API Routes, além dos dados retornados.
Recursos de dados | Dados retornados | Formato da devolução |
---|---|---|
ComputeRouteMatrix | Retorna uma matriz de rotas de um ponto de passagem de origem para um ponto de passagem de destino. | JSON |
Como usar a Compute Route Matrix
1 | Configurar | Comece com Configurar seu projeto do Google Cloud e siga as instruções de configuração. |
2 | Entenda como a API Routes cobra | Para mais informações, consulte Uso e faturamento. |
3 | Calcular a matriz de rotas e analisar a resposta | Para mais informações, consulte Acessar uma matriz de rotas e Analisar a resposta da matriz de rotas. |
Bibliotecas de clientes disponíveis
Para conferir uma lista das bibliotecas de cliente disponíveis para a matriz de rotas de computação, consulte Bibliotecas de cliente.
A seguir
- Acessar uma matriz de rotas
- Opções de matriz de trajeto disponíveis
- Escolher quais informações retornar
- Migrar da API Distance Matrix (legado)
- Migrar da prévia da API Routes para o GA