Gérer les points de cheminement

Par défaut, le SDK Navigation pour Android trouve l'itinéraire le plus rapide vers un point de cheminement. Toutefois, cela ne garantit pas que le véhicule arrivera du côté de la route où le client attend ni que le lieu d'arrivée est sûr pour que le conducteur s'arrête. Ce guide décrit deux fonctionnalités que vous pouvez utiliser dans ces situations :

  • Préférence d'itinéraire selon le côté de la route
  • Fonctionnalité d'arrêt

Préférence d'itinéraire selon le côté de la route

Vous pouvez définir une préférence pour arriver d'un côté particulier de la route lorsque vous créez un point de cheminement pour un arrêt. Vous pouvez spécifier la préférence de deux manières : préférer le même côté de la route ou fournir un cap d'arrivée.

Privilégier le même côté de la route

Vous fournissez les coordonnées géographiques du point de cheminement, puis vous définissez un indicateur (setPreferSameSideOfRoad) qui indique que vous préférez arriver du même côté de la route que le point de cheminement, ancré au trottoir le plus proche.

Waypoint waypoint =
   Waypoint.builder()
           .setLatLng(latitude, longitude)
           .setTitle("Somewhere in Sydney")
           .setPreferSameSideOfRoad(true)
           .build()

Définir un cap d'arrivée

Vous fournissez les coordonnées géographiques du point de cheminement, puis un cap d'arrivée (setPreferredHeading) qui correspond au sens de circulation du même côté de la route que le client en attente.

Waypoint waypoint =
   Waypoint.builder()
           .setLatLng(latitude, longitude)
           .setTitle("Somewhere in Sydney")
           .setPreferredHeading(preferredHeading)
           .build()

Le SDK Navigation choisit le segment de route le plus proche du point de cheminement, dont la direction de la voie correspond (à +/- 55 degrés) au côté de la route où se trouve le point de cheminement.

Définir la préférence d'escale

Dans certains endroits, les conducteurs ne peuvent pas s'arrêter en toute sécurité (par exemple, les zones surélevées, les ferries, les lieux souterrains et d'autres zones à accès limité). La fonctionnalité Escale déplace le point de cheminement vers un lieu à proximité si son emplacement ne convient pas à l'arrêt d'un véhicule. Lorsque vous définissez setVehicleStopover sur true, le point de cheminement est automatiquement déplacé lors du calcul de l'itinéraire, si un autre emplacement est disponible.

Fonctionnement

Vous définissez la préférence pour une étape lorsque vous créez le point de cheminement de cette étape. Pour ce faire, spécifiez la préférence setVehicleStopover comme indiqué dans l'exemple suivant :

Waypoint waypoint =
   Waypoint.builder()
           .setLatLng(latitude, longitude)
           .setTitle("Somewhere in Sydney")
           .setVehicleStopover(true)
           .build()