Visão geral do Compute Routes

Desenvolvedores do Espaço Econômico Europeu (EEE)

Introdução

Compute Routes é um método no serviço da API Routes que aceita uma solicitação HTTPS e retorna o trajeto ideal entre dois locais. Disponibilize rotas com trânsito em tempo real para transporte público, bicicleta, carro, motocicleta ou a pé.

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

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

Por que usar o Compute Routes

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

O que você pode fazer com o Compute Routes?

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

  • Ver 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, caminhões, a pé ou de bicicleta.

    • Uma série de waypoints que você pode otimizar para que a ordem de viagem seja a mais eficiente.

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

    • Strings de texto. Por exemplo: "Chicago, IL", "Darwin, NT, Austrália", "1800 Amphitheatre Parkway, Mountain View, CA 94043" ou "CWF6+FWX Mountain View, Califórnia"

    • 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 metas:

  • Controle a latência e a qualidade solicitando apenas os dados necessários com uma máscara de campo, o que ajuda a evitar tempo de processamento desnecessário e taxas de faturamento de solicitação 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 HTTP POST com um corpo de solicitação JSON que contém os detalhes da solicitação. É obrigatório informar uma origem, um destino, travelMode e uma máscara de campo para especificar quais campos retornar.

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 o trajeto solicitado e retorna os campos que você pediu.

Recursos

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

Recursos de dados Dados retornados Formato de retorno
ComputeRoutes Retorna rotas, trechos 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 Gerar um trajeto e Analisar as respostas de trajeto.

Bibliotecas de clientes disponíveis

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

A seguir