Visão geral da Compute Routes Matrix

O Compute Route Matrix é 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 Visão geral do Compute Routes.

Migrando? Se você estiver migrando da API Distance Matrix (legada), consulte as instruções de migração em Por que migrar para a API Routes.

Por que usar o recurso Compute Route Matrix

Com o recurso Compute Route Matrix, é possível determinar as rotas mais eficientes para o agendamento de despachos, como:

• Como atribuir um conjunto de trabalhadores para coletar uma série de pacotes

• Determinar o melhor depósito para enviar pacotes ao destino final

O que você pode fazer com o recurso Compute Route Matrix?

Com a API Compute Route Matrix, é possível receber uma matriz de rotas possíveis entre vários locais de início e fim. É 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 toda a matriz seja calculada, reduzindo a latência da resposta.

Você pode solicitar esses 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 modo de viagem selecionado

• Tempo estimado de viagem no trânsito

Como funciona o recurso Compute Route Matrix

O método ComputeRouteMatrix aceita uma solicitação HTTP POST com um corpo de solicitação JSON que contém os detalhes da solicitação. São obrigatórios pelo menos uma origem, dois ou mais destinos, travelMode e uma máscara de campo para especificar quais campos retornar.

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 pontos de partida e de destino.

Recursos

A tabela a seguir resume os recursos disponíveis pelo método Compute Route Matrix da API Routes, além dos dados que ele retorna.

Como usar o recurso Compute Route Matrix

Bibliotecas de clientes disponíveis

Para conferir uma lista das bibliotecas de cliente disponíveis para Compute Route Matrix, consulte Bibliotecas de cliente.

A seguir

• Acessar uma matriz de rotas
• Opções de matriz de rotas disponíveis
• Escolha quais informações retornar
• Migrar da API Distance Matrix (legada)
• Migrar da prévia da API Routes para a disponibilidade geral