Obtenir un jeton d'itinéraire

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

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
    

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

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. Il utilise des masques de champ pour demander un jeton d'itinéraire, ainsi que la durée, la distance et la polyligne de l'itinéraire :

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.