Visão geral do Compute Routes

Introdução

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 rotas? Se você tiver interesse em uma matriz de rotas, consulte Visão geral da API Compute Route Matrix.

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

Com o Compute Routes, você pode usar uma ampla variedade de detalhes de trajeto para direcionar 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 meios de transporte 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.

• Use várias maneiras de especificar origens, destinos e pontos de referência:

  • 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 o sentido do veículo

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

  • Selecione trajetos econômicos para o tipo de motor do seu veículo: diesel, elétrico, híbrido ou gasolina. Para mais informações, consulte Receber um trajeto ecológico.

  • Defina opções refinadas para o cálculo do tráfego, permitindo que você tome decisões de compensação entre qualidade e latência. Para mais detalhes, consulte Especificar como e se incluir dados de tráfego.

  • Defina o sentido do veículo (direção do trajeto) e as informações da via para aumentar a precisão da HEC. Para mais detalhes, consulte Especificar o sentido do veículo e o lado da via.

  • Especifique locais de passagem x terminais e locais seguros de parada. Para mais detalhes, consulte Definir uma parada em um trajeto e Definir um ponto para um trajeto passar.

  • Solicitar informações de pedágio, além da distância do trajeto e da HEC. Para mais detalhes, consulte Calcular taxas de pedágio para uma rota.

• Controle sua latência e qualidade solicitando apenas os dados necessários usando 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. São obrigatórios uma origem, um destino, travelMode e uma máscara de campo para especificar os campos a serem retornados.

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 ComputeRoutes da API Routes e os dados que ele retorna.

Como usar o recurso Compute Routes

Bibliotecas de clientes disponíveis

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

A seguir

• Traçar uma rota
• Opções de trajeto disponíveis
• Escolha quais informações retornar
• Migrar da API Directions (legada)
• Migrar da prévia da API Routes para a disponibilidade geral