MCP Tools Reference: mapstools.googleapis.com

Strumento: compute_routes

Calcola i percorsi di viaggio tra un'origine e una destinazione, facoltativamente attraverso fermate intermedie. Restituisce la distanza e la durata di ogni percorso.

Requisiti di input (FONDAMENTALI):

1. origin e destination (oggetti - OBBLIGATORI): ciascuno deve essere fornito utilizzando esattamente uno dei seguenti elementi:

   • address (stringa, ad es. 'Eiffel Tower, Paris'). I luoghi, i punti di riferimento e le attività con un nome vengono risolti direttamente, quindi NON chiamare prima search_places solo per geocodificare un waypoint. Includi qualsiasi città, regione o paese menzionato dall'utente.
   • lat_lng (oggetto, {"latitude": number, "longitude": number}).
   • place_id (stringa, ad esempio 'ChIJOwE_Id1w5EAR4Q27FkL6T_0'), ad esempio da search_places.

2. intermediate_waypoints (array di oggetti - FACOLTATIVO): fino a 25 tappe da attraversare, in ordine, tra l'origine e la destinazione. Stesso formato di origin. Non supportato con TRANSIT. Includi solo le fermate richieste dall'utente. Se specifichi più di 10 tappe intermedie, i costi e la latenza saranno più elevati.

3. travel_mode (enum - FACOLTATIVO): DRIVE (predefinito), WALK, BICYCLE o TRANSIT.

4. Tempistica (FACOLTATIVO - imposta al massimo UN valore): timestamp RFC 3339 con un offset UTC, ad esempio '2026-09-19T08:00:00-07:00'. Il valore predefinito è la partenza immediata. Per TRANSIT, l'ora può essere impostata fino a 7 giorni nel passato o fino a 100 giorni nel futuro. Per le altre modalità, l'ora può essere impostata fino a 365 giorni nel futuro e non deve essere nel passato.

   • departure_time: da utilizzare quando l'utente indica quando partirà (ad es. "domani alle 8:00").
   • arrival_time: da utilizzare quando l'utente indica l'orario di arrivo (ad es. "arrivo alle 9:00").

5. routing_preference (enum - FACOLTATIVO):

   • ROUTING_PREFERENCE_TRAFFIC_UNAWARE (predefinito): ignora il traffico in tempo reale, gli incidenti e le chiusure. Latenza minima.
   • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL: utilizza le condizioni del traffico in tempo reale, se disponibili. Non supportato per WALK o BICYCLE. Imposta questo valore SOLO quando l'utente chiede informazioni sul traffico, sulla congestione o su un orario di arrivo stimato basato sul traffico. Comporta costi e latenza più elevati.

6. location_bias (oggetto - FACOLTATIVO): {"latitude": number, "longitude": number} utilizzato per eliminare l'ambiguità dei nomi dei luoghi negli indirizzi dei waypoint. Se un nome è ambiguo (ad es. "Springfield") e l'utente non ha fornito una regione, mantieni il nome così come è stato fornito in address e imposta location_bias sull'area prevista anziché indovinare una regione.

7. compute_alternative_routes (booleano - FACOLTATIVO): impostalo su true solo quando l'utente richiede opzioni o alternative per il percorso. Il valore predefinito è false, che restituisce solo il percorso consigliato.

8. include_polyline (booleano - FACOLTATIVO): imposta su true solo quando è necessaria la geometria del percorso (encoded_polyline). Il valore predefinito è false.

Instructions for Tool Call:

• Se l'origine o la destinazione non sono presenti, DEVI chiedere chiarimenti all'utente prima di chiamare lo strumento.
• Per le domande del tipo "Quanto dista A da B?", utilizza B come origin e A come destination.

Esempio di chiamata allo strumento: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"intermediate_waypoints":[{"address":"Louvre Museum"}],"travel_mode":"DRIVE","departure_time":"2026-09-19T08:00:00+02:00"}

Instructions for Response:

• Quando vengono richiesti percorsi alternativi, questi vengono ordinati dal più consigliato al meno consigliato.
• Se routes è vuoto, comunica all'utente che non è stato trovato alcun percorso. Non provare a indovinare un percorso.
• Per trovare luoghi lungo un percorso DRIVE, passa il retrieval_token del percorso a search_along_route. Il token è valido per 10 minuti.
• Indica solo i fatti restituiti dallo strumento. NON inventare indicazioni stradali passo passo, linee di trasporto pubblico, stazioni, banchine o coincidenze.
• L'output basato su dati reali deve essere attribuito alla fonte utilizzando il campo attribution di ogni percorso, se disponibile.

Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP compute_routes.

Schema di input

{
  "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.
}

{

  // 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
}

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

Schema di output

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

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

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

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

Annotazioni dello strumento

Le annotazioni degli strumenti vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client considera questi suggerimenti non attendibili, ma possono essere utilizzati per decidere quando inviare una richiesta di conferma a un utente.

Oltre alla stringa del titolo, i seguenti suggerimenti booleani sono definiti come segue:

• readOnlyHint: se true, lo strumento non modifica il suo ambiente. Valore predefinito: false.
• destructiveHint: se true, lo strumento può eseguire azioni distruttive. Se è false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.
• idempotentHint: se true, la chiamata ripetuta dello strumento con gli stessi argomenti non avrà alcun effetto aggiuntivo sul suo ambiente. Valore predefinito: false.
• openWorldHint: se true, lo strumento può interagire con un "open world" di entità esterne. Se false, lo strumento può interagire solo con entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria non lo sarebbe.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ✅ | Open World Hint: ❌