Ajuster les préférences de routage

Les calculs d'itinéraire (y compris le recalcul) renvoient l'itinéraire qui prend le moins de temps à parcourir comme meilleur itinéraire par défaut. Toutefois, vous pouvez modifier la stratégie de routage afin que l'itinéraire le plus court parmi les alternatives soit renvoyé.

Le terme plus court désigne l'itinéraire le plus court parmi les itinéraires optimaux en fonction de notre modèle de coût par défaut. L'itinéraire le plus court n'est pas forcément le plus absolu, car il peut s'agir d'une mauvaise alternative. Par exemple, si l'itinéraire le plus court est de 10 km et prend 50 minutes, et qu'un autre itinéraire est de 15 km, mais ne prend que 20 minutes, le deuxième choix est optimal, car passer 30 minutes pour réduire cinq kilomètres n'est pas un bon compromis.

Une fois que vous avez défini la stratégie de routage pour un trajet, elle ne change pas tant que le trajet n'est pas terminé. Pour modifier la stratégie de routage d'un trajet existant, vous devez effacer les destinations et les redéfinir avec la nouvelle stratégie de routage.

Remarque : Cette fonctionnalité est destinée aux fournisseurs de services de transport avec chauffeur qui opèrent sur des marchés réglementés (comme l'Europe), où ils sont souvent tenus par la loi de fixer le prix de leurs services selon les mêmes principes que les taxis traditionnels, qui facturent principalement en fonction de la distance parcourue.

Obtenir des informations sur un itinéraire

Pour déterminer la stratégie d'itinéraire optimale pour un point de repère donné, appelez getRouteInfo() pour obtenir des informations sur l'itinéraire par défaut le plus adapté et l'itinéraire le plus court. Les détails incluent la durée et la distance jusqu'à un point de cheminement de destination.

Ces informations proviennent de RouteInfo et sont renvoyées dans un ListenableResultFuture.

Exemple

L'exemple de code suivant montre comment obtenir les détails de l'itinéraire pour chacune des deux stratégies de routage.

ListenableResultFuture<RouteInfo> routeInfoFuture =
        navigator.getRouteInfo(waypoint, routingOptions);

Définir la stratégie de routage

Vous pouvez configurer la stratégie de routage en définissant RoutingOptions.routingStrategy lorsque vous appelez setDestinations().

RoutingOptions.routingStrategy prend l'une des valeurs d'énumération suivantes :

Valeur d'énumération	Description
RoutingStrategy.DEFAULT_BEST	Classe les itinéraires selon le modèle de coût par défaut du SDK Navigation. Il s'agit de la stratégie de routage par défaut.
RoutingStrategy.SHORTER	Classe les itinéraires par distance. La route la mieux classée est la plus courte parmi celles renvoyées.

Avertissement : Cette fonctionnalité n'est pas compatible avec la fonctionnalité Masquer l'itinéraire alternatif. L'utilisation simultanée de ces deux fonctionnalités entraînera des résultats inattendus.

Exemple

L'exemple de code suivant montre comment définir la préférence pour l'itinéraire le plus court.

RoutingOptions routingOptions = new RoutingOptions();
routingOptions.routingStrategy(RoutingStrategy.SHORTER);
navigator.setDestinations(destinations, routingOptions, displayOptions);

Itinéraires incluant des ferries

Par défaut, le NavSDK exclut les itinéraires qui incluent des ferries. Si vous préférez inclure des options de ferry dans vos itinéraires, vous pouvez ajuster cette préférence d'itinéraire pour exposer le trajet aux segments de ferry en définissant avoidFerries sur false.

Exemple

RoutingOptions routingOptions = new RoutingOptions().avoidFerries(true);
// Add additional routing preferences
navigator.setDestination(destination, routingOptions);

Format de l'accroche d'itinéraire

Lorsque vous sélectionnez la préférence d'itinéraire le plus court, des encadrés affichent des informations sur la distance le long de l'itinéraire. Vous pouvez toutefois utiliser les accroches d'estimation du temps d'arrivée.

Configurer le format de l'info-bulle de l'itinéraire

Vous pouvez modifier le format de l'info-bulle de l'itinéraire en appelant setRouteCalloutInfoFormat dans NavigationView (ou dans NavigationFragment). setRouteCalloutInfoFormat accepte l'une des valeurs d'énumération suivantes :

Valeur d'énumération	Description
RouteCalloutInfoFormat.DEFAULT	Affiche le temps restant lorsque vous utilisez la stratégie de routage de la meilleure route par défaut. Affiche la distance restante lorsque la stratégie de routage du chemin le plus court est utilisée.
RouteCalloutInfoFormat.TIME	Affiche le temps restant.
RouteCalloutInfoFormat.DISTANCE	Affiche la distance restante.

Exemple

L'exemple de code suivant montre comment configurer le format de l'encart d'itinéraire.

mNavFragment.setRouteCalloutInfoFormat(RouteCalloutInfoFormat.TIME);