Calcular rotas

A ferramenta compute_routes retorna um trajeto entre uma origem e um destino para um determinado meio de transporte. A resposta inclui a distância e a duração do trajeto. Por padrão, as rotas são calculadas sem trânsito em tempo real. O Pro adiciona rotas que consideram o trânsito em tempo real e rotas com mais paradas intermediárias.

É possível chamar compute_routes pelo servidor MCP ou como o método REST computeRoutes. Nesta página, descrevemos as opções de solicitação, incluindo as opções Pro, o que a resposta contém e como as solicitações são faturadas. Para ver os esquemas completos, consulte a referência do MCP do compute_routes e a referência do REST do computeRoutes.

Opções de solicitação

A tabela a seguir descreve as opções de solicitação para compute_routes:

Opções do Pro

Duas opções selecionam a SKU do Maps Grounding Pro. Uma solicitação que usa um ou ambos é faturada com a SKU Pro:

Todas as outras opções são faturadas na SKU Essentials, incluindo modo de viagem, tempo, rotas alternativas, polilinhas e polarização de local.

Rotas com base no trânsito

Por padrão, as rotas são calculadas sem condições de trânsito em tempo real (ROUTING_PREFERENCE_TRAFFIC_UNAWARE). Essa configuração tem a menor latência. É adequado para solicitações em que o tráfego não importa ou não se aplica, como rotas de caminhada ou planejamento aproximado.

Defina routing_preference como ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL para calcular o trajeto e a duração dele com as condições de trânsito atuais, quando os dados de trânsito estiverem disponíveis. Use quando o usuário perguntar quanto tempo leva um trajeto de carro agora. Para rotas de TRANSIT, essa configuração usa dados de transporte público em tempo real, como atrasos e cancelamentos, quando disponíveis. Ele não é compatível com as rotas WALK ou BICYCLE. Essas solicitações retornam um erro INVALID_ARGUMENT. Essa é uma opção Pro, então a solicitação é faturada com a SKU Pro. A opção também adiciona latência.

Exemplo

A solicitação MCP a seguir pede uma rota de carro que considere o trânsito, com uma parada intermediária e uma polilinha codificada. A cobrança é feita com a SKU Pro:

{
  "method": "tools/call",
  "params": {
    "name": "compute_routes",
    "arguments": {
      "origin": {"address": "Ferry Building, San Francisco, CA"},
      "destination": {"address": "Golden Gate Park, San Francisco, CA"},
      "intermediate_waypoints": [
        {"address": "Palace of Fine Arts, San Francisco, CA"}
      ],
      "travel_mode": "DRIVE",
      "routing_preference": "ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL",
      "include_polyline": true
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}

O exemplo a seguir envia a mesma solicitação para o método REST computeRoutes:

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-d '{
  "origin": {"address": "Ferry Building, San Francisco, CA"},
  "destination": {"address": "Golden Gate Park, San Francisco, CA"},
  "intermediateWaypoints": [
    {"address": "Palace of Fine Arts, San Francisco, CA"}
  ],
  "travelMode": "DRIVE",
  "routingPreference": "ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL",
  "includePolyline": true
}' \
"https://mapstools.googleapis.com/v1:computeRoutes"

Substitua API_KEY pela sua chave de API.

Resposta

A resposta contém routes[], ordenados do mais para o menos recomendado. Apenas um trajeto é retornado, a menos que compute_alternative_routes seja true. Cada rota inclui:

• distanceMeters: a distância do trajeto, em metros.
• duration: o tempo necessário para percorrer o trajeto. Com ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL, a duração considera as condições de trânsito.
• encodedPolyline: o caminho do trajeto como uma polilinha codificada, quando include_polyline é true. Você pode usá-la para desenhar o trajeto em um mapa com outras APIs da Plataforma Google Maps.
• retrievalToken: um token opaco retornado para rotas DRIVE (válido por 10 minutos) que você pode transmitir para search_along_route para encontrar lugares ao longo dessa rota sem reenviar waypoints.
• attribution: a atribuição que precisa ser mostrada com o trajeto. Consulte os requisitos de atribuição.

Faturamento e cotas

Cada solicitação compute_routes é um evento faturável:

• Uma solicitação que não usa nenhuma opção Pro é faturada de acordo com a SKU Maps Grounding Essentials.
• Uma solicitação que usa uma opção Pro é faturada na SKU Maps Grounding Pro. Usar as duas opções Pro em uma solicitação não muda a cobrança. Para saber os preços do Pro, consulte Comparar os planos Essentials, Pro e embasamento com o Google Maps.

Solicitar rotas alternativas, uma polilinha, um horário de partida ou chegada ou um modo de viagem diferente não muda a SKU.

A cota de compute_routes é de 300 consultas por minuto para cada projeto, compartilhada por ambas as SKUs. Para saber os preços, consulte a tabela de preços principal e a tabela de preços da Índia.

Limites

• Uma solicitação pode incluir no máximo 25 waypoints intermediários. De 11 a 25 é uma opção Pro. Uma solicitação com mais retorna um erro INVALID_ARGUMENT.
• As rotas de transporte público não aceitam waypoints intermediários. Uma solicitação de transporte público com waypoints intermediários retorna um erro INVALID_ARGUMENT.
• ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL não é compatível com rotas a pé ou trajetos para bicicleta.
• Para rotas de transporte público, os horários de partida e chegada podem ser de até 7 dias no passado ou 100 dias no futuro. Para outros meios de transporte, elas não podem estar no passado e podem ser de até 365 dias no futuro.
• As coordenadas do waypoint precisam estar dentro de limites geográficos válidos (latitude de -90 a 90, longitude de -180 a 180).
• A ferramenta não retorna etapas de navegação guiada, trechos ou detalhes de linhas de transporte público.