MCP Tools Reference: mapstools.googleapis.com

Ferramenta: compute_routes

Calcula trajetos entre uma origem e um destino, com a opção de incluir paradas intermediárias. Retorna a distância e a duração de cada trajeto.

Requisitos de entrada (CRÍTICOS):

1. origin e destination (objetos - OBRIGATÓRIO): cada um precisa ser fornecido usando exatamente um dos seguintes:

   • address (string, por exemplo, 'Eiffel Tower, Paris'). Lugares, pontos de referência e empresas com nome são resolvidos diretamente. Portanto, NÃO chame search_places primeiro apenas para geocodificar um waypoint. Inclua qualquer cidade, região ou país mencionado pelo usuário.
   • lat_lng (objeto, {"latitude": number, "longitude": number}).
   • place_id (string, por exemplo, 'ChIJOwE_Id1w5EAR4Q27FkL6T_0'), por exemplo, de search_places.

2. intermediate_waypoints (matriz de objetos, OPCIONAL): até 10 paradas para passar, em ordem, entre a origem e o destino. Mesmo formato de origin. Não compatível com TRANSIT. Inclua apenas as paradas que o usuário pediu.

3. travel_mode (tipo enumerado - OPCIONAL): DRIVE (padrão), WALK, BICYCLE ou TRANSIT.

4. Horário (OPCIONAL - defina no máximo UM): carimbos de data/hora RFC 3339 com um ajuste de UTC, por exemplo, '2026-09-19T08:00:00-07:00'. O padrão é "partindo agora". Para TRANSIT, o horário pode ser de até 7 dias no passado ou até 100 dias no futuro. Para outros modos, o horário pode ser de até 365 dias no futuro e não pode ser no passado.

   • departure_time: use quando o usuário disser quando vai sair (por exemplo, "amanhã às 8h").
   • arrival_time: use quando o usuário disser o horário de chegada (por exemplo, "chegar lá até as 9h").

5. routing_preference (tipo enumerado - OPCIONAL):

   • ROUTING_PREFERENCE_TRAFFIC_UNAWARE (padrão): ignora o trânsito em tempo real, incidentes e interdições. Latência mais baixa.
   • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL: usa as condições de trânsito em tempo real quando disponíveis. Não há suporte para WALK ou BICYCLE. Defina isso APENAS quando o usuário perguntar sobre o trânsito, congestionamento ou um horário de chegada ajustado ao trânsito. Ela gera custos e latência mais altos.

6. location_bias (objeto, OPCIONAL): {"latitude": number, "longitude": number} usado para eliminar a ambiguidade de nomes de lugares em endereços de pontos de referência. Se um nome for ambíguo (por exemplo, "Springfield") e o usuário não tiver informado uma região, mantenha o nome como fornecido em address e defina location_bias para a área pretendida em vez de adivinhar uma região.

7. compute_alternative_routes (booleano, OPCIONAL): defina como true somente quando o usuário pedir opções ou alternativas de trajeto. O padrão é false, que retorna apenas o trajeto recomendado.

8. include_polyline (booleano - OPCIONAL): defina como true somente quando a geometria do trajeto (encoded_polyline) for necessária. O padrão é false.

Instruções para chamada de ferramenta:

• Se a origem ou o destino estiverem ausentes, você PRECISA pedir esclarecimentos ao usuário antes de chamar a ferramenta.
• Para perguntas como "Qual é a distância de A até B?", use B como origin e A como destination.

Exemplo de chamada de ferramenta: {"origin":{"address":"Torre Eiffel"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"intermediate_waypoints":[{"address":"Museu do Louvre"}],"travel_mode":"DRIVE","departure_time":"2026-09-19T08:00:00+02:00"}

Instruções para resposta:

• Quando rotas alternativas são solicitadas, elas são ordenadas da mais para a menos recomendada.
• Se routes estiver vazio, informe ao usuário que nenhuma rota foi encontrada. Não adivinhe um trajeto.
• Apenas declare os fatos retornados pela ferramenta. NÃO invente navegação guiada, linhas de transporte público, estações, plataformas ou baldeações.
• A saída embasada precisa ser atribuída à fonte usando o campo attribution de cada rota, quando disponível.

O exemplo de código abaixo mostra como usar curl para chamar a ferramenta MCP compute_routes.

Esquema de entrada

{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode),
  "intermediateWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "routingPreference": enum (RoutingPreference),
  "locationBias": {
    object (LatLng)
  },
  "includePolyline": boolean,
  "computeAlternativeRoutes": boolean,

  // Union field timing can be only one of the following:
  "departureTime": string,
  "arrivalTime": string
  // End of list of possible types for union field timing.
}

{
  "seconds": string,
  "nanos": integer
}

{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}

{
  "latitude": number,
  "longitude": number
}

Esquema de saída

{
  "routes": [
    {
      object (Route)
    }
  ]
}

{
  "distanceMeters": integer,
  "duration": string,
  "attribution": {
    object (Attribution)
  },
  "encodedPolyline": string,
  "retrievalToken": string
}

{
  "seconds": string,
  "nanos": integer
}

{
  "title": string,
  "url": string
}

Anotações de ferramentas

As anotações de ferramentas são enviadas aos clientes do MCP para descrever o risco básico de uma determinada ferramenta. A maioria dos clientes trata essas dicas como não confiáveis, mas elas podem ser usadas para decidir quando um pedido de confirmação pode ser enviado a um usuário.

Além da string de título, as seguintes dicas booleanas são definidas:

• readOnlyHint: se for verdadeiro, a ferramenta não modifica o ambiente. (Padrão: falso).
• destructiveHint: se for verdadeiro, a ferramenta poderá realizar ações destrutivas. Se for falso, a ferramenta só poderá realizar ações aditivas. Padrão: verdadeiro.
• idempotentHint: se for verdadeiro, chamar a ferramenta repetidamente com os mesmos argumentos não terá efeito adicional no ambiente. (Padrão: falso).
• openWorldHint: se for verdadeiro, a ferramenta poderá interagir com um "mundo aberto" de entidades externas. Se for falso, a ferramenta só poderá interagir com entidades internas. Por exemplo, uma ferramenta de pesquisa na Web seria de mundo aberto, enquanto uma ferramenta de memória não seria.

Dica destrutiva: ❌ | Dica idempotente: ❌ | Dica somente leitura: ✅ | Dica de jogos de mundo aberto: ❌