Lorsque vous déterminez le meilleur itinéraire pour un trajet en covoiturage, l'itinéraire le plus rapide n'est pas toujours la meilleure option. Vous pouvez planifier votre itinéraire.
L'API Routes Preferred vous permet de planifier un itinéraire en spécifiant un objectif d'itinéraire à l'aide de la méthode ComputeCustomRoutes.
La méthode ComputeCustomRoutes peut également vous aider à respecter l'itinéraire en vous permettant de minimiser la différence entre l'itinéraire sélectionné par l'opérateur et l'itinéraire emprunté.
Utilisez à la fois l'API Routes Preferred et le SDK Navigation pour profiter pleinement de la planification d'itinéraire.
Activer la méthode ComputeCustomRoutes
Avant de pouvoir utiliser la méthode ComputeCustomRoutes dans votre code, vous devez l'activer. Pour en savoir plus sur l'activation des méthodes de l'API Routes Preferred, consultez la section Premiers pas.
Utiliser la méthode ComputeCustomRoutes
La méthode ComputeCustomRoutes 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 de
le paramètre d'URL $fields ou fields, ou à l'aide de l'en-tête HTTP/gRPC
X-Goog-FieldMask. Pour en savoir plus, consultez la section
Paramètres système.
La valeur du masque de champ est une liste de chemins de champ séparés par une virgule. Chaque chemin de champ est une liste de noms de champs séparés par un point qui représente la hiérarchie des messages. Un nom de champ est la clé de l'objet JSON ou le nom de la balise de champ protobuf. Le chemin de champ commence par le type de message de réponse de premier niveau, suivi éventuellement d'un ou plusieurs points, puis du niveau suivant du nom de champ. En règle générale, les chemins de champ sont construits de la manière suivante :
topLevelField[.secondLevelField][.thirdLevelField][...]
Un masque de champ spécial est un caractère générique "*", qui sélectionne tous les champs de niveau racine.
Pour en savoir plus, consultez les pages suivantes :
Pour obtenir des exemples d'utilisation de la méthode ComputeCustomRoutes, consultez
la section Exemples de calcul d'un itinéraire personnalisé (bêta).
Calculer les péages
Pour savoir comment calculer les péages, consultez la section Calculer les péages.
Pour obtenir des exemples de calcul des péages, consultez la section Exemples de calcul d'un itinéraire personnalisé.