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 trajetos.

Precisa de rotas de carro? Se você tiver interesse em rotas de carro, consulte a Visão geral do Compute Routes.

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

Por que usar o Compute Route Matrix

Com o Compute Route Matrix, você pode determinar as rotas mais eficientes para o agendamento de despacho, como:

• A melhor maneira de atribuir um conjunto de trabalhadores para coletar uma série de pacotes

• Determinar o melhor armazém para enviar pacotes ao destino final

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

Com o Compute Route Matrix, você pode acessar 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 vezes o número de destinos até 625. Você pode transmitir elementos da resposta antes que toda a matriz seja calculada, reduzindo a latência da resposta.

É possível 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 o Compute Route Matrix funciona

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. É necessário ter 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 referência de origem e destino.

Recursos

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

Como usar o Compute Route Matrix

Bibliotecas de clientes disponíveis

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

A seguir

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