Calculer des itinéraires

L'outil compute_routes renvoie un itinéraire entre un point de départ et une destination pour un mode de transport donné. La réponse inclut la distance et la durée de l'itinéraire. Par défaut, les itinéraires sont calculés sans tenir compte du trafic en temps réel. Pro ajoute le routage qui tient compte du trafic en temps réel et des itinéraires avec plus d'arrêts intermédiaires.

Vous pouvez appeler compute_routes via le serveur MCP ou en tant que méthode REST computeRoutes. Cette page décrit les options de requête, y compris les options Pro, le contenu de la réponse et la facturation des requêtes. Pour obtenir les schémas complets, consultez la documentation de référence sur le MCP compute_routes et la documentation de référence sur REST computeRoutes.

Options de requête

Le tableau suivant décrit les options de requête pour compute_routes :

Options Pro

Deux options sélectionnent le SKU Maps Grounding Pro. Une requête qui utilise l'une ou l'autre de ces fonctionnalités est facturée au SKU Pro :

Toutes les autres options sont facturées sous le SKU Essentials, y compris le mode de transport, la durée, les itinéraires alternatifs, les polylignes et la pondération de l'emplacement.

Routage tenant compte du trafic

Par défaut, les itinéraires sont calculés sans tenir compte des conditions de circulation en temps réel (ROUTING_PREFERENCE_TRAFFIC_UNAWARE). Ce paramètre offre la latence la plus faible. Elle convient aux requêtes pour lesquelles le trafic n'a pas d'importance ou ne s'applique pas, comme les itinéraires à pied ou la planification approximative.

Définissez routing_preference sur ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL pour calculer l'itinéraire et sa durée en fonction des conditions de circulation actuelles, lorsque les données de trafic sont disponibles. Utilise cet outil lorsque l'utilisateur demande combien de temps prend un trajet en voiture en ce moment. Pour les itinéraires TRANSIT, ce paramètre utilise les données de transports en commun en temps réel, telles que les retards et les annulations, lorsqu'elles sont disponibles. Elle n'est pas compatible avec les routes WALK ou BICYCLE. Ces requêtes renvoient une erreur INVALID_ARGUMENT. Il s'agit d'une option Pro. La requête est donc facturée sous le SKU Pro. Cette option ajoute également de la latence.

Exemple

La requête MCP suivante demande un itinéraire en voiture tenant compte du trafic, avec un arrêt intermédiaire et une polyligne encodée. Il est facturé sous le 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
}

L'exemple suivant envoie la même requête à la méthode 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"

Remplacez API_KEY par votre clé API.

Réponse

La réponse contient routes[], classés du plus recommandé au moins recommandé. Un seul itinéraire est renvoyé, sauf si compute_alternative_routes est défini sur true. Chaque itinéraire comprend :

• distanceMeters : distance de l'itinéraire, en mètres.
• duration : temps nécessaire pour parcourir l'itinéraire. Avec ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL, la durée tient compte des conditions de circulation.
• encodedPolyline : chemin d'accès de l'itinéraire sous la forme d'une polyligne encodée, lorsque include_polyline est défini sur true. Vous pouvez l'utiliser pour tracer l'itinéraire sur une carte avec d'autres API Google Maps Platform.
• retrievalToken : jeton opaque renvoyé pour les itinéraires DRIVE (valide pendant 10 minutes) que vous pouvez transmettre à search_along_route pour trouver des lieux le long de cet itinéraire sans renvoyer de points de cheminement.
• attribution : attribution que vous devez afficher avec l'itinéraire. Consultez Exigences d'attribution.

Facturation et quotas

Chaque requête compute_routes correspond à un événement facturable :

• Une requête qui n'utilise aucune option Pro est facturée sous le SKU Maps Grounding Essentials.
• Une requête qui utilise une option Pro est facturée sous le SKU Maps Grounding Pro. L'utilisation des deux options Pro dans une même requête ne modifie pas les frais. Pour connaître les tarifs de l'édition Pro, consultez Comparer les éditions Essentials, Pro et l'ancrage avec Google Maps.

La demande d'itinéraires alternatifs, d'une polyligne, d'une heure de départ ou d'arrivée, ou d'un autre mode de transport ne modifie pas le SKU.

Le quota compute_routes est de 300 requêtes par minute pour chaque projet, partagé par les deux SKU. Pour connaître les tarifs, consultez la grille tarifaire principale et la grille tarifaire pour l'Inde.

Limites

• Une requête peut inclure au maximum 25 points de cheminement intermédiaires. Entre 11 et 25 points de cheminement, il s'agit d'une option Pro. Une requête contenant plus d'éléments renvoie une erreur INVALID_ARGUMENT.
• Les itinéraires en transports en commun ne sont pas compatibles avec les points de cheminement intermédiaires. Une requête de transport en commun avec des points de cheminement intermédiaires renvoie une erreur INVALID_ARGUMENT.
• ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL n'est pas compatible avec les itinéraires à pied ou à vélo.
• Pour les itinéraires en transports en commun, les heures de départ et d'arrivée peuvent remonter jusqu'à sept jours dans le passé ou être programmées jusqu'à 100 jours à l'avance. Pour les autres modes de transport, elles ne peuvent pas être dans le passé et peuvent être définies jusqu'à 365 jours à l'avance.
• Les coordonnées des points de cheminement doivent se situer dans des limites géographiques valides (latitude de -90 à 90, longitude de -180 à 180).
• L'outil ne renvoie pas de navigation détaillée, de segments ni de détails sur les lignes de transports en commun.