Visão geral da API Routes

A API Routes é um serviço que aceita uma solicitação HTTPS e retorna o trajeto ideal entre dois locais ou as distâncias e os tempos de viagem para uma matriz de trajetos entre diferentes locais de origem e de destino.

Por que usar a API Routes

Com a API Routes, você recebe informações precisas sobre trajetos e viagens usando detalhes do transporte, condições do trânsito e da via atualizadas e preferências de trajeto:

  • Tipo e capacidades de diferentes meios de transporte

  • Para que direção um veículo está indo

  • A lateral da via para embarques e desembarques

  • Condições de trânsito e vias interditadas

  • preocupações de segurança, como evitar áreas perigosas ou oferecer áreas de embarque seguras.

  • Encontre equilíbrio entre latência, qualidade e custo para suas necessidades de trajeto com recursos opcionais, como pedágios e metadados de viagens, por exemplo, tempo, distância e economia de combustível.

Você também pode determinar as rotas mais eficientes para a programação de envios, como:

  • A melhor forma de atribuir um conjunto de workers para coletar uma série de pacotes.

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

O que você pode fazer com a API Routes?

Com a API Routes, você pode receber duas categorias principais de informações de roteamento:

  • Trajetos de um local para um ou vários destinos

  • Uma matriz de trajetos possíveis entre muitos locais de partida e chegada.

Consultar rotas para um ou vários destinos

Com o método Compute Routes da API Routes, você pode calcular entre locais:

  • Ver rotas para diferentes maneiras de se deslocar e para um ou vários destinos:

    • Modos de transporte, incluindo transporte público, condução, veículos de duas rodas, caminhada ou bicicleta.

    • Uma série de waypoints, que você pode otimizar na ordem mais eficiente para chegar até eles.

  • 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 suas opções de trajeto com base nas suas necessidades e metas:

  • Controle a latência e a qualidade solicitando apenas os dados necessários usando uma máscara de campo. Isso 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.

Receber uma matriz de possíveis trajetos

O método Compute Route Matrix da API Routes fornece uma matriz de informações para os trajetos recomendados entre vários pontos de partida e chegada, incluindo distância e horários de chegada estimados, para ajudar você a escolher as melhores origens e destinos com base nas necessidades da sua empresa. Você pode solicitar estes tipos de dados de distância:

  • Distância de um meio de transporte selecionado

  • Distância em quilômetros ou milhas

  • Tempo estimado de viagem com trânsito

Com os dados de distância, é possível determinar a maneira mais eficiente de rotear passageiros, remessas ou trabalhadores entre várias origens e destinos possíveis.

É possível fazer streaming de elementos da resposta antes que toda a matriz seja calculada, reduzindo a latência da resposta.

Você pode especificar várias origens e destinos por solicitação do lado do servidor, até 625 com o número de origens multiplicado pelo número de destinos.

Como a API Routes funciona

A API Routes tem dois métodos: ComputeRoute e ComputeRouteMatrix.

ComputeRoute

O método ComputeRoute da API Routes aceita uma solicitação HTTP POST com um corpo de solicitação JSON que contenha os detalhes da solicitação. São obrigatórios: origem, 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 a rota solicitada e retorna os campos solicitados.

Matriz ComputeRoute

A API Routes ComputeRouteMatrix aceita uma solicitação HTTP POST com um corpo de solicitação JSON que contenha os detalhes da solicitação. São obrigatórios pelo menos uma origem, dois ou mais destinos, o TravelMode e uma máscara de campo para especificar quais campos retornar.

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 por meio da API Routes e os dados retornados por ela.

Recursos de dados Dados retornados Formato de devolução
ComputeRoute (em inglês) Retorna trajetos, trechos e etapas de um trajeto, com trajetos alternativos, se solicitado. JSON
ComputeRouteMatrix (em inglês) Retorna uma matriz de trajetos de um waypoint de origem até um waypoint de destino.

Como usar a API Routes

1 Configuração Comece pela seção Configurar seu projeto do Google Cloud e siga as instruções de configuração a seguir.
2 Calcular uma rota e analisar a resposta Para mais informações, consulte Ver uma rota e Analisar as respostas de rotas.
3 Calcular a matriz de rotas e analisar a resposta Para mais informações, consulte Acessar uma matriz de rota e Analisar a resposta da matriz de rota.

Bibliotecas de clientes disponíveis

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

A seguir