Planifier un itinéraire

Vous pouvez parfois planifier le parcours que votre application propose aux utilisateurs. L'utilisation d'un jeton d'itinéraire de l'API Routes, de l'API Routes Preferred ou de l'API Route Optimization peut vous aider à spécifier deux éléments pour votre itinéraire planifié:

• Une polyligne pour l'itinéraire

• Vos objectifs d'itinéraire

Voici quelques exemples d'objectifs de routage que vous pouvez avoir:

• Réduire le délai de livraison: un établissement qui propose la livraison de repas peut souhaiter réduire le délai de livraison.

• Réduire le temps de trajet ou la consommation de carburant: une entreprise de logistique peut souhaiter améliorer l'efficacité de ses chauffeurs et réduire ses coûts de carburant.

• Minimiser le temps de trajet: une opération de distribution de service peut vouloir réduire le temps nécessaire pour que les opérateurs accèdent à une demande de travail.

• Réduire les coûts et améliorer la sécurité: une entreprise de covoiturage peut souhaiter trouver un itinéraire moins coûteux pour les passagers et éviter certaines zones pour des raisons de sécurité.

Important :L'itinéraire parcouru peut varier de l'itinéraire planifié fourni par le jeton. Les changements de trafic, les conditions de la route ou le fait que le véhicule s'écarte de l'itinéraire donné peuvent entraîner des modifications de l'itinéraire. À mesure que des modifications se produisent, le SDK de navigation tente continuellement de revenir à l'itinéraire planifié ou, si le retour n'est pas pratique, suit les objectifs de l'itinéraire dans le jeton d'itinéraire.

Pour en savoir plus sur la planification d'un itinéraire à l'aide d'un jeton d'itinéraire, consultez Demander un jeton d'itinéraire dans l'API Routes et Polylignes de transition et jetons d'itinéraire dans l'API Route Optimization.

Pourquoi utiliser un jeton de parcours pour les objectifs de parcours

Avec un jeton d'itinéraire de l'API Routes, de l'API Routes Preferred ou de l'API Route Optimization, vous avez plus de contrôle sur l'itinéraire fourni:

• Planifiez un itinéraire à l'avance pour que le SDK Navigation puisse l'utiliser lorsque cela est possible.

• Choisissez le meilleur itinéraire à utiliser par le SDK Navigation. Si vous demandez des jetons d'itinéraire lorsque vous générez des itinéraires dans l'API Routes, vous obtenez un jeton d'itinéraire pour chaque itinéraire généré. Vous pouvez ensuite choisir le jeton pour l'itinéraire que vous souhaitez utiliser lorsque vous le transmettez au SDK Navigation.

• Estimer le prix à l'avance, y compris les estimations de l'heure d'arrivée et de la distance. Bien que le coût et le temps réels puissent varier, cette estimation réduit l'écart entre le coût prévu et le coût réel du trajet.

• Spécifiez des objectifs d'itinéraire plus avancés, tels que l'itinéraire écologique ou le plus court.

Remarque :Un jeton d'itinéraire est destiné à un point de départ et à une destination spécifiques, et à un moment donné. Vous devez envoyer une nouvelle requête à l'API Routes, à l'API Routes Preferred ou à l'API Route Optimization pour obtenir un nouveau jeton d'itinéraire.

Fonctionnement des jetons d'itinéraire

Vous pouvez utiliser l'API Routes, l'API Routes Preferred ou l'API Route Optimization pour planifier un itinéraire à l'aide d'objectifs d'itinéraire. Vous pouvez transmettre un jeton d'itinéraire renvoyé par l'une de ces API au SDK Navigation pour guider le calcul du trajet de votre véhicule.

Voici ce qui se passe lorsque vous demandez et utilisez un jeton de parcours:

1. L'API Routes, l'API Routes Preferred ou l'API Route Optimization renvoie un jeton d'itinéraire chiffré qui inclut la polyligne de l'itinéraire et ses objectifs.

2. Vous transmettez le jeton de parcours au SDK Navigation.

3. Le SDK Navigation récupère l'itinéraire ou, si celui-ci n'est pas disponible en raison de conditions changeantes, il récupère l'itinéraire le mieux adapté.

4. Pendant le trajet, si le trafic ou d'autres conditions routières changent, ou si un véhicule s'écarte de l'itinéraire planifié, les itinéraires modifiés tentent continuellement de correspondre au meilleur itinéraire en fonction des objectifs de l'itinéraire dans le jeton.

Ce processus maximise la proximité de l'itinéraire réel avec l'itinéraire planifié.

Pourquoi un itinéraire planifié peut-il ne pas être suivi exactement ?

Considérez votre itinéraire planifié et ses objectifs comme des consignes à suivre: ils ne sont pas contraignants. Vous pouvez constater une différence entre votre itinéraire planifié et celui fourni par la navigation guidée en raison de différences dans les conditions de circulation, le point de départ ou d'autres paramètres qui ont changé depuis la création de l'itinéraire planifié. Cette différence peut entraîner un décalage entre vos objectifs planifiés et réels en termes de distance et d'heure d'arrivée estimée, entre autres caractéristiques importantes du trajet.

Conseil :Nous vous recommandons de toujours demander un nouveau jeton d'itinéraire chaque fois que vous définissez la destination dans le SDK Navigation, et de prévoir des variations pour éviter tout impact sur votre activité.

Planifier un itinéraire à l'aide d'un jeton d'itinéraire

Vous pouvez planifier un itinéraire en créant un jeton d'itinéraire, puis en le transmettant au SDK Navigation, comme décrit dans les étapes suivantes:

Étape 1: Créez un jeton d'itinéraire à l'aide de l'API Routes, de l'API Routes Preferred ou de l'API Route Optimization

1. Demandez un jeton de route à l'aide de l'une des méthodes suivantes:

   • API Routes: computeRoutes. Pour en savoir plus sur la demande d'un jeton de parcours dans l'API Routes, consultez Calculer un parcours et Demander un jeton de parcours.

   • API Routes préférée: computeCustomRoutes. Pour en savoir plus sur la demande d'un jeton de parcours dans l'API Routes Preferred, consultez Planifier un parcours.

   • API Route Optimization: optimizeTours ou batchOptimizeTours. Pour en savoir plus sur la demande d'un jeton de parcours dans l'API Route Optimization, consultez Polylignes de transition et jetons de parcours.

2. Configurez votre requête API Routes ou API Routes Preferred pour répondre aux exigences d'utilisation d'un jeton de route:

   • Définissez travel_mode sur DRIVING ou TWO_WHEELER.
   • Définissez routing_preference sur TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL.
   • N'utilisez PAS de points de cheminement Via.

Étape 2: Transmettre le jeton d'itinéraire au SDK Navigation

1. Stocker le jeton de parcours: dans le SDK Navigation, configurez une chaîne pour stocker le jeton de parcours. Exemple :

   let routeToken = "route token returned by Routes API"

   Exemple de jeton d'itinéraire renvoyé:

   {
   // Other fields
   "routeToken": "CqMBCjoKCJQOor5DHcwiEhBon3XpHXFnVvDeWMwd9PpAGgz6wtnFDKIBrAHTARpCApUDSggAAAAACjcrP3gBEAQaTApKChgKDQoCCAERAAAAAACAZkAR3SQGgZUXdUASEggAEAMQBhATEBIYAkIEGgIIBSIYChZ2VEJiWlBPSkk1aU5wUVRzNTV5d0FRKAEiFQBcJuds-Efh-2QZhOMTtUCCxEVL_g",
   }
   

2. Transmettez le jeton de parcours au SDK Navigation à l'aide de la méthode mapView.navigator setDestinations, en spécifiant les mêmes points de repère de destination que ceux que vous avez utilisés lors de la création du jeton de parcours:

   mapView.navigator?.setDestinations([waypoint1, waypoint2], routeToken: routeToken, callback: {...})

Remarque :Si vous devez emprunter à nouveau le même itinéraire, demandez un nouveau jeton d'itinéraire.

La méthode Navigator.setDestinations renvoie l'état de la requête. Si un itinéraire est trouvé entre la position de l'utilisateur et la destination donnée, il renvoie RouteStatus.OK.

Pour en savoir plus sur cette méthode, consultez GMSNavigator.setDestinations.

Exemple

Les exemples de code suivants montrent comment récupérer un itinéraire planifié.

Swift

let location = CLLocationCoordinate2D(latitude: 47.67, longitude: -122.20)
let waypoint1 = GMSNavigationWaypoint(location: location, title: "waypoint from location")!
let waypoint2 = GMSNavigationWaypoint(placeID: "samplePlaceID", title: "waypoint from Place ID")!

let routeToken = "route token returned by Routes API"
mapView.navigator?.setDestinations([waypoint1, waypoint2], routeToken: routeToken, callback: {...})

Objective-C

CLLocationCoordinate2D location = CLLocationCoordinate2DMake(47.67, -122.20);
GMSNavigationWaypoint *waypoint1 = [[GMSNavigationWaypoint alloc] initWithLocation:coordinate title:@"waypoint from location"];
GMSNavigationWaypoint *waypoint2 = [[GMSNavigationWaypoint alloc] initWithPlaceID:@"samplePlaceID"
                                                                            title:@"waypoint from Place ID"];
NSString *routeToken = @"route token returned by Routes API";

[mapView.navigator setDestinations:@[waypoint1, waypoint2]
                         routeToken:routeToken
                           callback:^(GMSRouteStatus routeStatus){...}];

Interaction entre les jetons de parcours et le SDK Navigation

Voici comment la route générée par le SDK Navigation et la route planifiée dans le jeton de route interagissent:

• Remplace toutes les destinations définies précédemment.

• Utilise le lieu de départ du véhicule.

• S'ajuste en fonction de l'état de la route et de la circulation. Consultez Pourquoi un itinéraire planifié peut ne pas être suivi exactement.

• Ignore les options de routage suivantes, car elles ne sont pas nécessaires:

  • avoidsHighways
  • avoidsTolls
  • avoidsFerries
  • licensePlateRestriction

• Abonnés:

  • Options liées aux points de cheminement, telles que la préférence de côté de la route.

  • Objectifs de l'itinéraire Si le SDK Navigation doit ajuster la route renvoyée, il utilise les objectifs de route que vous avez spécifiés lors de la demande du jeton de route. C'est pourquoi vous devez utiliser les mêmes options liées aux points de cheminement que celles que vous avez spécifiées dans l'API Routes.