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 ou as distâncias e valores de para uma matriz de trajetos entre diferentes locais de origem e destino.

Por que usar a API Routes

Com a API Routes, você pode conferir rotas e informações de viagem precisas usando detalhes de transporte, condições atualizadas de trânsito e vias e preferências:

  • Tipo e recursos dos diferentes meios de transporte

  • A direção de um veículo

  • Lado da via para embarques ou desembarques

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

  • Preocupações de segurança, como evitar áreas perigosas ou oferecer uma retirada com segurança áreas

  • Equilibre latência, qualidade e custo das suas viagens de trajeto com opções atributos como pedágios e metadados de viagens, como tempo e distância, e informações sobre eficiência

Também é possível determinar as rotas mais eficientes para a programação de despachos, como como:

  • Qual é a melhor maneira de atribuir um conjunto de workers para selecionar uma série de pacotes

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

O que você pode fazer com a API Routes?

Com a API Routes, você tem duas categorias principais de rotas informações:

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

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

Ver rotas para um ou vários destinos

Com o método Compute Routes da API Routes, é possível calcular entre locais:

  • Ver rotas para diferentes meios de transporte e para um ou vários destinos:

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

    • Uma série de waypoints que podem ser otimizados para a ordem mais eficiente levá-los para dentro.

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

    • Strings de texto. Por exemplo: "Chicago, IL", "Darwin, NT, Australia", "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 somente os dados necessários com o uma máscara de campo, que ajuda a evitar tempo de processamento desnecessário e solicitar taxas de faturamento. Para mais detalhes, consulte Escolha quais informações retornar.

Conseguir uma matriz de rotas possíveis

O método Compute Route Matrix da API Routes fornece uma matriz de informações para trajetos recomendados entre várias partidas pontos, incluindo distância e horários estimados de chegada, para ajudar você a escolher os melhores origens e destinos com base nas suas de negócios. 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, você pode determinar a maneira mais eficiente de rotear passageiros, remessas ou trabalhadores entre múltiplas origens e de destino.

É possível transmitir elementos da resposta antes de toda a matriz ter sido calculada, reduzindo a latência de resposta.

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

Como a API Routes funciona

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

ComputeRoutes

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. Os campos obrigatórios são uma origem, destination, 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'

O serviço então calcula o trajeto solicitado e retorna os campos solicitado.

ComputeRouteMatrix

A API Routes ComputeRouteMatrix aceita uma solicitação POST HTTP com um corpo de solicitação JSON que contém os detalhes da solicitação. Os campos obrigatórios são pelo menos um origem, dois ou mais destinos, TravelMode e uma máscara de campo para especificar quais a serem 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 todas as origens e waypoints do destino.

Recursos

A tabela a seguir resume os recursos disponíveis no API Routes com os dados retornados.

Recursos de dados Dados retornados Formato de devolução
ComputeRoutes Retorna trajetos, trechos e etapas de uma rota com rotas alternativas. se solicitado. JSON
ComputeRouteMatrix Retorna uma matriz de trajetos de um waypoint de origem para um destino waypoint.

Como usar a API Routes

1 Configuração Comece em 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 da rota.
3 Calcular a matriz de rotas e analisar a resposta Para mais informações, consulte Ver uma matriz de rotas. e Analise 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