Visão geral da Compute Routes Matrix

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