Affiche l'itinéraire principal ainsi que les autres itinéraires facultatifs, en fonction d'un ensemble de points de cheminement terminaux et intermédiaires.
REMARQUE:Cette méthode nécessite que vous spécifiiez un masque de champ de réponse dans l'entrée. Vous pouvez fournir le masque de champ de réponse à l'aide du paramètre d'URL $fields
ou fields
, ou d'un en-tête HTTP/gRPC X-Goog-FieldMask
(consultez Paramètres et en-têtes d'URL disponibles. La valeur est une liste de chemins d'accès de champs séparés par une virgule. Consultez la documentation détaillée sur la création des chemins d'accès aux champs.
Par exemple, dans cette méthode:
- Masque de champ de tous les champs disponibles (pour l'inspection manuelle):
X-Goog-FieldMask: *
- Masque de champ de durée, distance et polyligne au niveau de l'itinéraire (exemple de configuration de production):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google déconseille l'utilisation du masque de champ de réponse utilisant le caractère générique (*
) ou la spécification de ce masque de champ au niveau supérieur (routes
) pour les raisons suivantes:
- Sélectionner uniquement les champs dont vous avez besoin permet à notre serveur d'économiser des cycles de calcul et de vous renvoyer le résultat avec une latence plus faible.
- Sélectionner uniquement les champs dont vous avez besoin pour votre job de production garantit des performances de latence stables. Nous pourrions ajouter d'autres champs de réponse à l'avenir, et ces nouveaux champs pourraient nécessiter du temps de calcul supplémentaire. Si vous sélectionnez tous les champs, ou tous les champs au niveau supérieur, vous risquez de constater une dégradation des performances, car tout nouveau champ que nous ajoutons sera automatiquement inclus dans la réponse.
- Si vous ne sélectionnez que les champs dont vous avez besoin, vous réduirez la taille des réponses et, par conséquent, le débit du réseau.
Requête HTTP
POST https://routespreferred.googleapis.com/v1:computeRoutes
L'URL utilise la syntaxe de transcodage gRPC.
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{ "origin": { object ( |
Champs | |
---|---|
origin |
Obligatoire. Point de cheminement de départ. |
destination |
Obligatoire. Point de cheminement de destination. |
intermediates[] |
Facultatif. Ensemble de points de cheminement sur l'itinéraire (à l'exclusion des terminaux) permettant de s'arrêter ou de passer à proximité. Vous pouvez ajouter jusqu'à 25 points de cheminement intermédiaires. |
travelMode |
Facultatif. Spécifie le mode de transport. |
routingPreference |
Facultatif. Spécifie comment calculer la route. Le serveur tente d'utiliser la préférence de routage sélectionnée pour calculer la route. Si la préférence de routage entraîne une erreur ou une latence extra longue, une erreur est renvoyée. À l'avenir, nous pourrons mettre en place un mécanisme de remplacement permettant d'utiliser une option différente lorsque l'option préférée ne donnera pas de résultat valide. Vous ne pouvez spécifier cette option que si |
polylineQuality |
Facultatif. Indique votre préférence pour la qualité de la polyligne. |
polylineEncoding |
Facultatif. Spécifie l'encodage préféré pour la polyligne. |
departureTime |
Facultatif. Heure de départ. Si vous ne définissez pas cette valeur, elle est définie par défaut sur l'heure à laquelle vous avez effectué la requête. Si vous définissez cette valeur sur une heure déjà passée, la requête échoue. Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: |
computeAlternativeRoutes |
Indique si des itinéraires alternatifs doivent être calculés en plus de l'itinéraire. |
routeModifiers |
Facultatif. Ensemble de conditions à remplir qui affectent le mode de calcul des itinéraires. |
languageCode |
Facultatif. Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Pour en savoir plus, consultez la page http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. Consultez la page Langues acceptées pour obtenir la liste des langues acceptées. Si vous ne fournissez pas cette valeur, la langue d'affichage est déduite de l'emplacement de la requête d'itinéraire. |
units |
Facultatif. Spécifie les unités de mesure des champs d'affichage. Cela inclut le champ |
optimizeWaypointOrder |
Si optimiserWaypointOrder est défini sur "true", une tentative est effectuée pour réorganiser les points de cheminement intermédiaires spécifiés afin de réduire le coût global de l'itinéraire. Si l'un des points de cheminement intermédiaires est via un point de cheminement, la requête échoue. Utilisez ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index pour identifier le nouvel ordre. Si routes.Optimized_intermediate_waypoint_index n'est pas demandé dans l'en-tête |
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de ComputeRoutesResponse
.
Niveaux d'accès des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/maps-platform.routespreferred
Pour en savoir plus, consultez la présentation d'OAuth 2.0.