Pour recevoir des mises à jour sur les données de trajet depuis Google Maps ou Waze, configurez votre backend à l'aide de l'une des options suivantes :
- une méthode d'extraction à l'aide de l'API Navigation Connect ;
- Méthode push axée sur les événements utilisant Google Cloud Pub/Sub.
Option 1 : Utiliser l'API Navigation Connect
Pour récupérer manuellement le dernier état du trajet, appelez la méthode GetTrip avec l'ID de trajet unique.
L'exemple suivant montre comment appeler l'API à partir de la ligne de commande à l'aide de vos identifiants par défaut de l'application (ADC) pour autoriser la requête de serveur à serveur.
#!/bin/bash
gcloud auth application-default login
access_token="$(gcloud auth application-default print-access-token)"
# Call the GetTrip method
curl -X GET "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips/TRIP_ID" \
-H "Authorization: Bearer ${access_token}" \
-H "Content-Type: application/json"
Personnaliser les formats de polylignes (Waze uniquement)
Si vous avez activé le signalement de l'itinéraire restant lors de la création du trajet, vous pouvez personnaliser la représentation de la polyligne de l'itinéraire restant renvoyée lorsque vous appelez la méthode GetTrip.
Pour choisir un format pour la polyligne, incluez le paramètre routePolylineFormat dans votre requête. Voici quelques exemples de formats compatibles :
ENCODED: chaîne polyligne encodée standard (cinq décimales).S2ENCODED: S2Polyline encodé.GEO_JSON: format GeoJSON LineString.
Option 2 : Utiliser Google Cloud Pub/Sub
Pour recevoir régulièrement des informations sur les trajets, abonnez-vous à un sujet Google Cloud Pub/Sub. Une fois que le conducteur a donné son accord, Navigation Connect envoie les mises à jour directement à votre sujet.
Pour une présentation de la messagerie, consultez le guide de démarrage rapide de Pub/Sub.
Les sections suivantes décrivent comment utiliser Google Cloud Pub/Sub pour recevoir des données d'une session de navigation avec Google Maps ou Waze.
1. Créer un sujet
Créez un sujet nommé exactement navigation_connect_trip_notifications dans votre projet Google Cloud, comme suit :
- Activez l'API Pub/Sub.
- Accédez à la page Sujets Pub/Sub dans la console Google Cloud.
- Cliquez sur Créer un sujet.
Saisissez
navigation_connect_trip_notificationsdans le champ ID du sujet.Cliquez sur Créer.
La console affiche le nom complet du sujet sous la forme projects/project-number/topics/navigation_connect_trip_notifications, où project-number est le numéro unique de votre projet.
2. Accorder l'autorisation de publication au compte de service Navigation Connect
Google utilise un compte de service pour publier les informations sur les trajets dans les thèmes Google Cloud Pub/Sub. Pour recevoir des notifications dans votre sujet, accordez l'autorisation projects.topics.publish pour ce sujet au compte de service suivant : geo-navigation-connect-pubsub@system.gserviceaccount.com.
Pour en savoir plus, consultez la documentation Pub/Sub sur le contrôle des accès.
3. Intégrer à votre backend
Pour traiter les mises à jour, écrivez une application côté serveur qui s'authentifie et s'abonne à votre thème. Utilisez les bibliothèques clientes Pub/Sub pour simplifier le développement. Pour les tests, vous pouvez également utiliser la gcloud CLI et la console Google.
4. Tester votre abonnement
Vérifiez votre configuration à l'aide de gcloud CLI ou de la console Google Cloud.
CLI gcloud
Extrayez les messages d'un abonnement (par exemple, my-sub) à l'aide de la commande suivante :
gcloud pubsub subscriptions pull my-sub --auto-ack
Console Google Cloud
Dans la console Google Cloud, procédez comme suit :
- Ouvrez la page Abonnements.
- Sélectionnez votre abonnement, puis cliquez sur l'onglet Messages.
- Cliquez sur Extraire.
Étape suivante
Une fois que vous commencez à recevoir des données de trajet, analysez-les pour les utiliser dans vos systèmes et applications.