Visão geral do Compute Routes

O Compute Routes é um método no serviço da API Routes que aceita uma solicitação HTTPS e retorna a rota ideal entre dois locais. Forneça rotas com trânsito em tempo real para transporte público, bicicleta, carro, veículos motorizados de duas rodas ou a pé entre vários locais.

Precisa de matrizes de rotas? Se você tiver interesse em uma matriz de rotas, consulte a Visão geral da Compute Route Matrix.

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 o Compute Routes

Com o Compute Routes, você pode rotear seus veículos ou pacotes de acordo com suas preferências, otimizando o custo e a qualidade, com uma ampla variedade de detalhes de rota.

O que você pode fazer com as rotas de computação?

Com o método Compute Routes da API Routes, é possível fazer o seguinte:

  • Confira rotas para diferentes formas de viajar e para um ou vários destinos:

    • Modos de transporte: transporte público, carro, veículos de duas rodas, a pé ou de bicicleta.

    • Uma série de waypoints que podem ser otimizados para a ordem mais eficiente de viagem até eles.

  • Use várias maneiras de especificar origens, destinos e pontos de passagem:

    • Strings de texto. Por exemplo: "Chicago, IL", "Darwin, NT, Australia", "1800 Amphitheatre Parkway, Mountain View, CA 94043" ou "CWF6+FWX Mountain View, California"

    • IDs de lugares

    • Coordenadas de latitude e longitude, opcionalmente com a direção do veículo

  • Ajuste as opções de trajeto com base nas suas necessidades e objetivos:

  • Controle a latência e a qualidade solicitando apenas os dados necessários usando uma máscara de campo, que ajuda a evitar o tempo de processamento desnecessário e taxas de faturamento mais altas. Para mais detalhes, consulte Escolher quais informações retornar.

Como o Compute Routes funciona

O método ComputeRoutes da API Routes aceita uma solicitação POST HTTP com um corpo de solicitação JSON que contém os detalhes da solicitação. São necessários uma origem, um destino, travelMode e uma máscara de campo para especificar quais campos serão retornados.

Exemplo

curl -X POST -d '{
    "origin": {
      "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
    },
    "destination": {
      "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
    },
  "travelMode": "DRIVE"
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
  'https://routes.googleapis.com/directions/v2:computeRoutes'

Em seguida, o serviço calcula a rota solicitada e retorna os campos que você solicitou.

Recursos

A tabela a seguir resume os recursos disponíveis pelo método Compute Routes da API Routes, além dos dados retornados.

Recursos de dados Dados retornados Formato da devolução
ComputeRoutes Retorna rotas, segmentos e etapas de uma rota, com rotas alternativas, se solicitado. JSON

Como usar o Compute Routes

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 um trajeto e analisar a resposta Para mais informações, consulte Pegar uma rota e Analisar as respostas da rota.

Bibliotecas de clientes disponíveis

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

A seguir