Lorsque vous déterminez le meilleur itinéraire pour un trajet en partage de course, le l'itinéraire le plus rapide n'est pas toujours la meilleure option. Vous voudrez peut-être pour 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 faciliter la conformité des routes en permettant
vous minimisez l'écart entre l'itinéraire sélectionné par l'opérateur et
en fonction de l'itinéraire.
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
Avant de pouvoir utiliser la méthode ComputeCustomRoutes dans votre code, vous devez
l'activer. Pour en savoir plus sur l'activation 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 une réponse
dans l'entrée. Vous pouvez fournir le masque de champ de réponse en utilisant
le paramètre d'URL $fields ou fields, ou via 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. Chemin d'accès à chaque 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 correspond soit à la clé de l'objet JSON, soit au nom du tag de champ protobuf. Le chemin d'accès du champ commence par le type de message de réponse de niveau supérieur, et éventuellement suivi d'un ou de plusieurs points, puis du niveau suivant du nom du 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 éléments au niveau de la racine .
Pour en savoir plus, consultez les pages suivantes :
Pour obtenir des exemples d'utilisation de la méthode ComputeCustomRoutes, consultez
Calculer des exemples de routes personnalisées (bêta)
Calcul des frais de péage
Pour plus d'informations sur le calcul des frais de péage, consultez Calculer les frais de péage
Pour obtenir des exemples de calcul des frais de péage, consultez Calculer des exemples de routes personnalisées