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 le routage et l'expérience du conducteur. Cela est utile dans des cas comme la livraison de nourriture ou le VTC, 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 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, au SDK Navigation pour iOS ou à l'API Routes, où un point de cheminement 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é.

Exemple : cas d'utilisation du VTC

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 VTC qui calcule le prix de l'itinéraire et dirige les conducteurs vers le point de prise en charge approprié.

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 diriger le conducteur vers le point de prise en charge approprié.

Consultez la section Documentation complémentaire pour obtenir des liens vers la documentation pertinente de l'API Routes, du SDK Navigation pour iOS et du SDK Navigation pour Android.

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

Diagramme de cas d'utilisation pour les VTC ou les services de livraison
Schéma d'un cas d'utilisation de VTC ou de livraison

Exemple de VTC

Imaginez un scénario de VTC dans lequel 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.

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

Exemples d'applications pour les consommateurs et les chauffeurs

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 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 pour les conducteurs qui utilise le SDK Navigation pour iOS ou Android afin de créer un point de cheminement pour diriger le conducteur vers le point de prise en charge approprié.

Documentation complémentaire