Planifier un itinéraire

Il peut arriver que vous souhaitiez planifier l'itinéraire que votre application fournit 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 : une entreprise de livraison de nourriture peut vouloir réduire le temps nécessaire à la livraison.

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

  • Réduire le temps de trajet jusqu'à la destination : une opération de répartition de services peut vouloir réduire le temps nécessaire pour que les opérateurs répondent à une demande de travail.

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

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 Transition des polylignes et des jetons d'itinéraire dans l'API Route Optimization.

Pourquoi utiliser un jeton d'itinéraire pour les objectifs d'itinéraire ?

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 l'utilise lorsque cela est possible.

  • Choisissez le meilleur itinéraire à utiliser pour 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 de l'itinéraire que vous souhaitez utiliser lorsque vous le transmettez au SDK Navigation.

  • Estimez le prix à l'avance, y compris les estimations de l'heure d'arrivée prévue 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 de l'itinéraire.

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

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 routage de votre véhicule.

Voici ce qui se passe lorsque vous demandez et utilisez un jeton d'itinéraire :

  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 les objectifs d'itinéraire.

  2. Vous transmettez le jeton d'itinéraire au SDK Navigation.

  3. Le SDK Navigation récupère l'itinéraire ou, si l'itinéraire n'est pas disponible en raison de conditions changeantes, il récupère l'itinéraire le plus 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 en permanence de correspondre au meilleur itinéraire en fonction des objectifs d'itinéraire du jeton.

Ce processus maximise la proximité de l'itinéraire réel par rapport à l'itinéraire planifié.

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

Considérez votre itinéraire planifié et vos objectifs d'itinéraire comme des consignes à suivre : ils ne sont pas prescriptifs. Vous pouvez constater une différence entre votre itinéraire planifié et l'itinéraire fourni par la navigation guidée en raison de différences dans les conditions routières, le lieu de départ ou d'autres paramètres qui ont changé depuis que vous avez créé l'itinéraire planifié. Cette différence peut entraîner une inadéquation entre vos objectifs planifiés et réels en termes de distance et d'heure d'arrivée prévue, entre autres qualités importantes du trajet.

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éer 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 d'itinéraire avec l'une des méthodes suivantes :

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

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

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

  1. Stockez le jeton d'itinéraire : dans le SDK Navigation, configurez une chaîne pour stocker le jeton d'itinéraire. Exemple :

    String 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 d'itinéraire au SDK Navigation à l'aide de la méthode Navigator.setDestinations, en spécifiant les mêmes points de cheminement de destination que ceux utilisés lors de la création du jeton d'itinéraire :

    setDestinations(List destinations, CustomRoutesOptions customRoutesOptions, DisplayOptions displayOptions);

    Exemple :

    CustomRoutesOptions customRoutesOptions =
      CustomRoutesOptions.builder()
      .setRouteToken(routeToken)
      .setTravelMode(TravelMode.DRIVING)
      .build();

La méthode Navigator.setDestinations renvoie l'état de la requête. Si elle trouve un itinéraire entre l'emplacement du véhicule et la destination donnée, elle renvoie RouteStatus.OK.

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

Exemple

L'exemple de code suivant montre comment spécifier un itinéraire planifié à l'aide d'un jeton d'itinéraire.

    ArrayList <Waypoint> destinations = Lists.newArrayList();
    Waypoint waypoint1 =
       Waypoint.builder()
          .setLatLng(10, 20)
          .setTitle("title")
          .setVehicleStopover(true)
          .build();
    destinations.add(waypoint1);
    Waypoint waypoint2 =
       Waypoint.builder()
          .setPlaceId("ChIJYV-J-ziuEmsRIMyoFaMedU4")
          .setTitle("title")
          .setVehicleStopover(true)
           .build()
    destinations.add(waypoint2);

    String routeToken = "route token returned by Routes API";

    CustomRoutesOptions customRoutesOptions =
       CustomRoutesOptions.builder()
          .setRouteToken(routeToken)
          .setTravelMode(TravelMode.DRIVING)
          .build();

    // Existing flow to get a Navigator.
    NavigationApi.getNavigator(...);

    // Existing flow for requesting routes.
    ListenableResultFuture<RouteStatus> routeStatusFuture =
        navigator.setDestinations(destinations, customRoutesOptions);

    // Or with display options.
    DisplayOptions displayOptions = new DisplayOptions();

    ListenableResultFuture<RouteStatus> routeStatusFuture =
        navigator.setDestinations(destinations, customRoutesOptions, displayOptions);

Interaction entre les jetons d'itinéraire et le SDK Navigation

Voici comment l'itinéraire généré par le SDK Navigation et l'itinéraire planifié dans le jeton d'itinéraire interagissent :

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

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

  • S'adapte aux conditions routières et de circulation. Consultez Pourquoi un itinéraire planifié peut ne pas être suivi exactement ?

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

    • avoidsHighways
    • avoidsTolls
    • avoidsFerries
    • licensePlateRestriction

  • Suit:

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

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