Obtenir un jeton d'itinéraire

Développeurs de l'Espace économique européen (EEE)

Si votre adresse de facturation se trouve dans l'Espace économique européen, les Conditions d'utilisation de Google Maps Platform pour l'EEE s'appliqueront à votre utilisation des Services à compter du 8 juillet 2025. La fonctionnalité varie selon la région. En savoir plus

Pour demander à Compute Routes de renvoyer des jetons de route pour les itinéraires générés, procédez comme suit :

1. Définissez les paramètres suivants requis pour renvoyer un jeton de route :
   • Définissez travelMode sur DRIVE ou TWO_WHEELER.
   • Définissez routingPreference sur TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL.
2. Spécifiez les lieux de départ et de destination. Vous pouvez spécifier des lieux en fonction de votre cas d'utilisation, à l'aide des éléments suivants : coordonnées de latitude et de longitude, chaînes d'adresse, jetons de points de navigation ou ID de lieu. Consultez les options de spécification de la zone géographique.
3. Vérifiez qu'aucun des points de cheminement de votre itinéraire n'est un point de cheminement Via.

4. Spécifiez le masque de champ routes.routeToken pour renvoyer un jeton de route :

   X-Goog-FieldMask: routes.routeToken
   

Remarque : En raison des conditions routières dynamiques, les itinéraires générés avec un jeton donné peuvent différer de l'itinéraire planifié. Pour minimiser les différences, utilisez le jeton dans les minutes qui suivent sa génération.

Vous pouvez utiliser le jeton d'itinéraire pour l'itinéraire planifié dans le SDK Navigation. Pour en savoir plus, consultez les pages suivantes :

• Planifier un itinéraire (Android)
• Planifier un itinéraire (iOS)

Exemple de jeton d'itinéraire

Voici un exemple de corps de requête curl pour un itinéraire à une seule origine et une seule destination. Elle utilise des masques de champ pour demander un jeton de route, ainsi que la durée, la distance et la polyligne de la route :

curl -X POST -d
{"origin":{
    "location": {
        "latLng":{
            "latitude":  -37.8167,
            "longitude": 144.9619
        }
    }
},
"destination":{
    "location": {
        "latLng":{
            "latitude":-37.8155,
            "longitude": 144.9663
        }
    }
},
"routingPreference":"TRAFFIC_AWARE",
"travelMode":"DRIVE"
}
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H X-Goog-FieldMask: routes.routeToken,routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
'https://routes.googleapis.com/directions/v2:computeRoutes'

Pour en savoir plus, consultez la documentation de référence de l'API Compute Routes.