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 afin d'améliorer l'itinéraire et l'expérience du conducteur. Cela est utile dans des cas tels que la livraison de repas ou le covoiturage, où le point de prise en charge ou de dépose peut être ambigu sans l'intervention de l'utilisateur.

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 emplacement préféré 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 destination et des informations contextuelles, au SDK Navigation pour Android, au SDK Navigation pour iOS ou à l'API Routes, où un point de cheminement est créé pour un 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é.

Exemple : Cas d'utilisation du covoiturage

Présentation

Cet exemple montre comment combiner l'API Geocoding, l'API Routes et le SDK Navigation pour iOS ou Android afin de créer une application de covoiturage qui calcule le prix de l'itinéraire et dirige les conducteurs vers le bon point de prise en charge.

Voici les grandes étapes à suivre :

  1. Récupérez un jeton de point de navigation via l'API Geocoding.
  2. Utilisez l'API Routes pour calculer un itinéraire et l'encoder dans un jeton d'itinéraire.
  3. Transmettez le jeton de point de navigation et le jeton d'itinéraire au SDK Navigation.
  4. Utilisez le SDK Navigation pour guider le conducteur vers le bon point de prise en charge.

Consultez la section Pour aller plus loin pour accéder aux liens vers la documentation de l'API Routes, du SDK Navigation pour iOS et du SDK Navigation pour Android.

Ce schéma montre comment une application de covoiturage ou de livraison utiliserait l'API Geocoding, l'API Routes et le SDK Navigation pour iOS ou Android afin de guider un conducteur à l'aide d'un jeton d'itinéraire et d'un jeton de point de navigation :

Diagramme de cas d'utilisation pour le covoiturage ou la livraison
Schéma d'un cas d'utilisation de covoiturage ou de livraison

Exemple de covoiturage

Imaginez un scénario de covoiturage dans lequel une application permet au client de réserver un trajet, et une deuxième application permet au conducteur de recevoir une notification du trajet et des informations d'itinéraire vers la destination.

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

Exemples d'applications pour les clients et les chauffeurs

Lorsqu'un client 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 est l'un des éléments du tableau navigationPoints dans le 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 backend de l'application fournit le jeton de point de navigation à l'API Routes pour calculer l'itinéraire et récupérer un jeton d'itinéraire.

Enfin, le jeton de point de navigation et le jeton d'itinéraire sont transmis à une application mobile de chauffeur qui utilise le SDK Navigation pour iOS ou Android afin de créer un point de cheminement permettant d'acheminer le chauffeur vers le bon point de prise en charge.

Documentation complémentaire