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 repère. Toutefois, cela ne garantit pas que le véhicule arrivera du côté de la route où le client attend ou que l'endroit 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 de routage par côté de la route
  • Fonctionnalité d'escale

Côté de la route à emprunter

Cette fonctionnalité vous permet de vous assurer que le véhicule arrive du bon côté de la route. Vous définissez la préférence d'arrivée d'un côté particulier de la route lorsque vous créez le point de cheminement pour cet arrêt. Vous pouvez spécifier la préférence de l'une des deux manières suivantes: préférer le même côté de la route ou indiquer une direction d'arrivée.

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

Vous fournissez les coordonnées géographiques du point d'intérêt, puis définissez un indicateur (setPreferSameSideOfRoad) qui indique que vous préférez arriver du même côté de la route que le point d'intérêt, en fonction du 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 d'intérêt, puis un angle d'arrivée (setPreferredHeading) correspondant au sens de circulation sur le 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 voie s'aligne (à +/- 55 degrés) avec le côté de la route sur lequel se trouve le point de cheminement.

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

Dans certains endroits, il est impossible pour les conducteurs de s'arrêter de manière sécurisée (par exemple, zones surélevées, ferries, lieux souterrains et autres zones à accès limité). La fonctionnalité Escale déplace le point de cheminement vers un lieu à proximité si son emplacement n'est pas adapté à un arrêt de 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 un arrêt lorsque vous créez le repère pour cet arrêt. Pour ce faire, spécifiez la préférence setVehicleStopover comme illustré dans l'exemple suivant:

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