Obtenir un jeton d'itinéraire

Pour demander à l'API Routes de renvoyer des jetons de parcours pour les parcours générés, procédez comme suit:

1. Définissez les paramètres suivants, qui sont requis pour renvoyer un jeton de parcours:

   • Définissez travelMode sur DRIVE.
   • Définissez routingPreference sur TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL.

2. Vérifiez qu'aucun de vos points de cheminement d'itinéraire ne correspond à un point de cheminement via.

3. Spécifiez le masque de champ routes.routeToken pour renvoyer un jeton de parcours:

   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 de parcours pour votre parcours 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 de route

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.