Lorsque vous déterminez le meilleur itinéraire pour un trajet en partage de course, l'itinéraire le plus rapide n'est pas toujours la meilleure option. Vous voudrez peut-être planifier votre itinéraire.
L'API Routes Preferred vous permet de planifier un itinéraire en spécifiant un objectif de route à l'aide de la méthode ComputeCustomRoutes.
La méthode ComputeCustomRoutes peut également contribuer à la conformité des routes, car elle vous permet de minimiser l'écart entre l'itinéraire sélectionné par l'opérateur et celui emprunté.
Utilisez à la fois l'API Routes Preferred et le SDK Navigation pour tirer pleinement parti de la planification d'itinéraires.
Activer la méthode ComputeCustomRoutes
Pour pouvoir utiliser la méthode ComputeCustomRoutes dans votre code, vous devez l'activer. Pour en savoir plus sur l'activation des méthodes API Routes Preferred, consultez le guide de démarrage.
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 du paramètre d'URL $fields ou fields, ou de l'en-tête HTTP/gRPC X-Goog-FieldMask. Pour en savoir plus, consultez Paramètres système.
La valeur du masque de champ est une liste de chemins d'accès de champs séparés par une virgule. Le chemin d'accès de chaque champ est une liste de noms de champs séparés par un point représentant la hiérarchie des messages. Un nom de champ correspond soit à la clé de l'objet JSON, soit au nom du tag de champ protobuf. Le chemin d'accès du champ commence à partir du type de message de réponse de niveau supérieur et est éventuellement suivi d'un ou de plusieurs points, puis du niveau suivant de nom de champ. En général, les chemins d'accès de champ sont construits de la manière suivante:
topLevelField[.secondLevelField][.thirdLevelField][...]
Un masque de champ de cas spécial est un caractère générique "*", qui sélectionne tous les champs au niveau de la racine.
Pour en savoir plus, consultez :
Pour obtenir des exemples d'utilisation de la méthode ComputeCustomRoutes, consultez la section Calculer des exemples de routes personnalisées (bêta).
Calcul des frais de péage
Pour en savoir plus sur le calcul des frais de péage, consultez la section Calculer les frais de péage.
Pour obtenir des exemples de calcul des frais de péage, consultez la section Calculer un itinéraire personnalisé.