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

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

Les jetons de point de navigation vous permettent d'envoyer des informations contextuelles clés sur une destination au SDK Navigation pour Android, au SDK Navigation pour iOS ou à l'API Routes pour améliorer le routage et l'expérience du conducteur. Cela est 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 l'intervention de l'utilisateur.

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

Exemples d'applications pour les consommateurs et les chauffeurs

Pour créer et transmettre un jeton de point de navigation, utilisez la méthode 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 la méthode Destinations de l'API Geocoding. Vous pouvez ensuite transmettre le jeton de point de navigation, qui contient à la fois les coordonnées de la destination et des informations contextuelles, au SDK Navigation pour Android, SDK Navigation pour iOS, ou à l'API Routes où un point de cheminement est créé pour un calcul d'itinéraire 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

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

Lorsqu'un consommateur ouvre l'application grand public, celle-ci appelle la méthode 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 se trouve dans le tableau navigationPoints du corps de la 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 ou iOS afin de créer un point de cheminement pour guider le conducteur vers le point de prise en charge approprié.