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 routes générées, procédez comme suit :

1. Définissez les paramètres suivants, qui sont obligatoires 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 points de départ et de destination. Vous pouvez spécifier des emplacements adaptés à 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 l' emplacement.
3. Vérifiez qu'aucun de vos points de cheminement de route 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 de circulation dynamiques, les routes générées avec un jeton donné peuvent différer de la route prévue. Pour minimiser les différences, utilisez le jeton quelques minutes après sa génération.

Vous pouvez utiliser le jeton de route pour votre route prévue 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 de route

Voici un exemple de corps de requête curl pour une route à point de départ unique et à destination unique. Il 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.