Itinéraire à l'aide de jetons de points de navigation

Développeurs de l'Espace économique européen (EEE)

Les jetons de points de navigation vous permettent d'envoyer des informations contextuelles clés sur une destination au SDK Navigation pour Android afin d'améliorer l'itinéraire et l'expérience du conducteur. Cela peut être utile dans des cas comme la livraison de nourriture ou le covoiturage, où le point de prise en charge ou de dépose peut être ambigu sans saisie de l'utilisateur.

Cette image montre des exemples d'application de covoiturage pour les consommateurs où le point de navigation est sélectionné, et une application pour les chauffeurs utilisant le SDK Navigation pour Android afin de guider précisément le chauffeur.

Exemples d'applications pour les consommateurs et les conducteurs

Pour créer et transmettre un jeton de point de navigation, utilisez le point de terminaison Destinations de l'API Geocoding afin de permettre à vos utilisateurs de sélectionner un lieu de leur choix dans une liste de points de navigation. La sélection de l'utilisateur devient un point de navigation renvoyé par le point de terminaison Destinations de l'API Geocoding. Vous pouvez ensuite transmettre le jeton de point de navigation, qui contient à la fois les coordonnées de destination et des informations contextuelles, au SDK Navigation pour Android, où un waypoint est créé pour un routage précis. La destination sera mise en évidence pour le conducteur par le SDK Navigation en fonction du lieu auquel le jeton est associé.

Comment un jeton de point de navigation est créé et envoyé au SDK Navigation pour le routage

Par exemple, imaginez un cas d'utilisation de covoiturage, où il existe une application permettant au consommateur de réserver le trajet et une deuxième application permettant au conducteur de recevoir une notification du trajet et des informations de routage vers la destination.

Lorsqu'un consommateur ouvre l'application, celle-ci appelle le point de terminaison Destinations de l'API Geocoding et lui propose une sélection de points de navigation potentiels :

Consommateur choisissant un point de dépôt

L'utilisateur choisit le point de son choix, qui est l'un des navigationPoints du corps de réponse d'une requête SearchDestinations :

"navigationPoints": [
    {
      "navigationPointToken": <encoded navigation point token>,
      "displayName": "South Entrance",
      "travelModes": ["DRIVE"],
      "usages": ["PICKUP","DROPOFF"],
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389
      }
      }
    }
]

Le jeton de point de navigation de la réponse est transmis à une application mobile pour les conducteurs qui utilise le SDK Navigation pour Android afin de créer un Waypoint pour guider le conducteur vers le point de retrait approprié.