Présentation de l'API Navigation Connect

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

L'API Navigation Connect est un service qui connecte l'utilisation de la navigation Google Maps et Waze par vos conducteurs à vos systèmes d'entreprise. Il utilise des jetons d'autorisation de trajet ainsi qu'un lien profond dans votre application, afin que le conducteur puisse appuyer sur un lien ou un bouton pour commencer la navigation dans l'application grand public de son choix. Pendant que le conducteur navigue sur le trajet, vous pouvez recevoir des données de localisation en temps réel, telles que des positions en temps réel, des heures d'arrivée prévues de haute précision et des états du cycle de vie du trajet.

L'API Navigation Connect offre une alternative légère au SDK Navigation. Elle utilise les applications autonomes Google Maps et Waze pour le calcul d'itinéraire, au lieu de vous obliger à créer et à intégrer une interface de navigation personnalisée dans votre application. Elle relie de manière sécurisée la session du conducteur à votre backend. Lorsqu'un conducteur démarre un trajet, il retrouve son interface de navigation habituelle, avec deux ajouts : une invite de consentement pour le partage des données de trajet (requise tous les 12 mois) et un bouton Retour personnalisé pour revenir à votre application.

Pourquoi utiliser l'API Navigation Connect ?

Grâce à l'API Navigation Connect, vous pouvez intégrer des informations en temps réel sur la position et l'heure d'arrivée prévue des trajets depuis Google Maps ou Waze directement dans vos processus de backend. Cela vous aide à prendre des décisions stratégiques importantes et à partager des informations précises avec vos clients, tandis que les conducteurs utilisent leur application de navigation préférée, Google Maps ou Waze.

Voici quelques exemples de cas d'utilisation :

  • Améliorer la transparence du covoiturage : fournissez aux clients et aux passagers des informations précises et en temps réel sur la position de leur conducteur et l'heure d'arrivée estimée.
  • Améliorez le suivi des livraisons : informez les clients des délais de livraison précis des colis ou des repas en fonction des données de trafic et d'itinéraire en temps réel.
  • Améliorez la gestion et la répartition des tâches de votre flotte : prenez des décisions éclairées concernant la répartition des tâches pour les flottes ou les équipes mobiles fournissant des services à la demande (comme l'assistance en cas de panne, la maintenance ou le transport) en suivant la position des conducteurs en temps réel.

Fonctionnalités de l'API Navigation Connect

L'API Navigation Connect vous permet de recevoir des informations en temps réel sur la position et l'heure d'arrivée estimée depuis Google Maps ou Waze directement dans votre backend.

  • Suivi non intrusif des trajets : suivez les trajets sans modifier le choix du conducteur d'utiliser Google Maps ou Waze, ni son expérience utilisateur.
  • Accédez aux données de localisation en temps réel : obtenez la position des conducteurs, la distance restante et le temps écoulé en temps réel tout au long d'un trajet.
  • Surveiller les cycles de vie des trajets : configurez la fréquence de mise à jour des données de trajet pour suivre l'état exact d'un trajet et savoir immédiatement quand un conducteur est en route, est arrivé ou suspend un trajet.
  • Consommer et partager les heures d'arrivée prévues : obtenez des informations très précises sur les heures d'arrivée prévues grâce aux algorithmes de calcul d'itinéraire en direct de Google.
  • Suivre l'itinéraire restant et le trafic : recevez la polyligne de l'itinéraire restant et les conditions de circulation en temps réel de la position actuelle du conducteur à sa destination finale, exactement comme elles s'affichent dans Google Maps ou Waze. Cette fonctionnalité déclenche le SKU Navigation Connect Enterprise.
    • Découpage dynamique : lorsque le véhicule se déplace, Navigation Connect découpe automatiquement la polyligne de l'itinéraire actif du conducteur (l'itinéraire complet parcouru dans l'application) pour s'assurer que vous ne recevez que l'itinéraire restant (le segment allant de la position actuelle du conducteur à la destination).
    • Fréquence de mise à jour : les conditions de circulation et les itinéraires sont mis à jour automatiquement lorsque l'itinéraire est recalculé, lorsque le client est redirigé de manière proactive ou lorsque les conditions de circulation changent.
  • Suivre les écarts d'itinéraire (Waze uniquement) : détectez quand un conducteur s'écarte de l'itinéraire, identifiez l'emplacement et l'heure exacts de l'écart, et déterminez si l'écart a été initié par le conducteur (par exemple, un mauvais virage) ou par le système (par exemple, un changement d'itinéraire pour éviter le trafic). Cette fonctionnalité déclenche le SKU Navigation Connect Enterprise.
  • Ingérez des données de manière flexible : consommez des données de trajet en temps réel à l'aide d'appels d'API REST directs ou diffusez des mises à jour de manière efficace à l'aide des abonnements Google Cloud Pub/Sub.

Fonctionnement de l'API Navigation Connect

L'API Navigation Connect accepte une requête CreateTrip contenant les identifiants de votre application mobile et la configuration de session. Le service génère une instance de trajet unique et renvoie un jeton de trajet. Ce jeton est ensuite ajouté à un lien profond Google Maps ou Waze. Une fois que le conducteur lance la navigation et donne son consentement, le service traite les données de navigation en temps réel et renvoie des mises à jour de télémétrie, y compris la position, l'heure d'arrivée prévue et la distance restante.

Ressources

Le tableau suivant récapitule les ressources disponibles via l'API Navigation Connect, ainsi que les données qu'elle renvoie. Pour en savoir plus, consultez la documentation de référence de l'API Navigation Connect.

Ressources de données Données renvoyées

Identifiants d'authentification et d'application mobile au format JSON.

Consultez Créer un trajet.

Jeton de trajet unique utilisé pour initialiser la connexion dans Google Maps ou Waze.

Consultez Lancer Google Maps ou Waze.

L'ID unique du trajet et une méthode d'extraction ou d'envoi au format JSON.

Consultez Récupérer les données de trajet.

Télémétrie des trajets en temps réel, y compris :

  • État et métadonnées du trajet
  • Position actuelle (latitude/longitude)
  • Heure d'arrivée prévue
  • Distance et temps restants

Consultez Gérer les données de trajet.

Utiliser l'API Navigation Connect

1 Configurer Commencez par Configurer votre projet Google Cloud, puis suivez les instructions.
2 Créer un trajet Envoyez un appel d'API Navigation Connect pour créer un trajet avec un identifiant unique, puis enregistrez le jeton.
3 Lancer Google Maps ou Waze Transmettez le jeton de trajet et lancez Google Maps ou Waze pour activer le partage des données de trajet.
4 Récupérer les données de trajet Envoyez un appel d'API Navigation Connect pour récupérer les données de trajet. Vous pouvez également vous abonner aux mises à jour à l'aide de Google Cloud Pub/Sub.
5 Gérer les données de trajet Découvrez comment gérer l'état du trajet et d'autres données de trajet.