MCP Tools Reference: mapstools.googleapis.com

Outil : compute_routes

Calcule les itinéraires entre un point de départ et une destination, éventuellement en passant par des arrêts intermédiaires. Renvoie la distance et la durée de chaque itinéraire.

Exigences d'entrée (CRITIQUE) :

1. origin et destination (objets - OBLIGATOIRE) : chacun doit être fourni en utilisant exactement l'un des éléments suivants :

   • address (chaîne, par exemple 'Eiffel Tower, Paris'). Les lieux nommés, les points de repère et les établissements sont résolus directement. N'appelez donc PAS search_places d'abord juste pour géocoder un point de cheminement. Incluez toute ville, région ou pays mentionné par l'utilisateur.
   • lat_lng (objet, {"latitude": number, "longitude": number}).
   • place_id (chaîne, par exemple 'ChIJOwE_Id1w5EAR4Q27FkL6T_0'), par exemple à partir de search_places.

2. intermediate_waypoints (tableau d'objets, FACULTATIF) : jusqu'à 25 arrêts par lesquels passer, dans l'ordre, entre le point de départ et la destination. Même format que origin. Non compatible avec TRANSIT. N'incluez que les arrêts demandés par l'utilisateur. Spécifier plus de 10 points de cheminement intermédiaires entraînera des coûts et une latence plus élevés.

3. travel_mode (énumération, FACULTATIF) : DRIVE (par défaut), WALK, BICYCLE ou TRANSIT.

4. Timing (OPTIONAL - set at most ONE): codes temporels RFC 3339 avec un décalage UTC, par exemple '2026-09-19T08:00:00-07:00'. La valeur par défaut est "départ immédiat". Pour TRANSIT, l'heure peut être définie jusqu'à sept jours dans le passé ou jusqu'à 100 jours dans le futur. Pour les autres modes, l'heure peut être fixée jusqu'à 365 jours dans le futur et ne doit pas être dans le passé.

   • departure_time : à utiliser lorsque l'utilisateur indique l'heure de son départ (par exemple, "demain à 8h").
   • arrival_time : à utiliser lorsque l'utilisateur indique l'heure à laquelle il doit arriver (par exemple, "arriver à 9h").

5. routing_preference (énumération - FACULTATIF) :

   • ROUTING_PREFERENCE_TRAFFIC_UNAWARE (par défaut) : ignore le trafic en temps réel, les incidents et les fermetures. Latence la plus faible.
   • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL : utilise les conditions de circulation en temps réel lorsqu'elles sont disponibles. Non compatible avec WALK ou BICYCLE. Définissez cette option UNIQUEMENT lorsque l'utilisateur pose une question sur le trafic, les embouteillages ou l'heure d'arrivée prévue ajustée en fonction du trafic. Cela entraîne des coûts et une latence plus élevés.

6. location_bias (objet, FACULTATIF) : {"latitude": number, "longitude": number} utilisé pour lever l'ambiguïté des noms de lieux dans les adresses des points de cheminement. Si un nom est ambigu (par exemple, "Springfield") et que l'utilisateur n'a pas indiqué de région, conservez le nom tel qu'il est indiqué dans address et définissez location_bias sur la zone prévue au lieu de deviner une région.

7. compute_alternative_routes (booléen, FACULTATIF) : défini sur true uniquement lorsque l'utilisateur demande des options ou des alternatives d'itinéraire. La valeur par défaut est false, qui ne renvoie que l'itinéraire recommandé.

8. include_polyline (booléen, FACULTATIF) : définissez cette option sur true uniquement lorsque la géométrie de l'itinéraire (encoded_polyline) est nécessaire. La valeur par défaut est false.

Instructions pour l'appel d'outil :

• Si le point de départ ou la destination est manquant, vous DEVEZ demander des précisions à l'utilisateur avant d'appeler l'outil.
• Pour les questions du type "À quelle distance se trouve A de B ?", utilisez B comme origin et A comme destination.

Exemple d'appel d'outil : {"origin":{"address":"Tour Eiffel"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"intermediate_waypoints":[{"address":"Musée du Louvre"}],"travel_mode":"DRIVE","departure_time":"2026-09-19T08:00:00+02:00"}

Instructions for Response:

• Lorsque des itinéraires alternatifs sont demandés, ils sont classés du plus recommandé au moins recommandé.
• Si routes est vide, indiquez à l'utilisateur qu'aucun itinéraire n'a été trouvé. Ne devinez pas un itinéraire.
• Pour trouver des lieux le long d'un itinéraire DRIVE, transmettez le retrieval_token de l'itinéraire à search_along_route. Le jeton est valide pendant 10 minutes.
• N'indiquez que les faits renvoyés par l'outil. N'inventez PAS d'itinéraires détaillés, de lignes de transports en commun, de stations, de quais ni de correspondances.
• La sortie ancrée doit être attribuée à la source à l'aide du champ attribution de chaque itinéraire, lorsqu'il est disponible.

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP compute_routes.

Schéma d'entrée

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

Schéma de sortie

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

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

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

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

Annotations d'outils

Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients considèrent ces indications comme non fiables, mais elles peuvent être utilisées pour décider quand envoyer une invite de confirmation à un utilisateur.

En plus de la chaîne de titre, les indications booléennes suivantes sont définies comme suit :

• readOnlyHint : si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".
• destructiveHint : si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions d'ajout. Valeur par défaut : "true".
• idempotentHint : si la valeur est "true", l'appel répété de l'outil avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".
• openWorldHint : si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche sur le Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.

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