Per ricevere gli aggiornamenti dei dati di viaggio da Google Maps o Waze, configura il tuo backend utilizzando una delle seguenti opzioni:
- Un metodo pull che utilizza l'API Navigation Connect oppure
- Un metodo push basato su eventi che utilizza Google Cloud Pub/Sub.
Opzione 1: utilizza l'API Navigation Connect
Per recuperare manualmente lo stato più recente della corsa, chiama il metodo GetTrip con l'ID corsa univoco.
L'esempio seguente mostra come chiamare l'API dalla riga di comando utilizzando le credenziali predefinite dell'applicazione (ADC) per autorizzare la richiesta server-server.
#!/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"
Personalizza i formati delle polilinee
Se hai attivato i report sul percorso rimanente durante la creazione del viaggio, puoi personalizzare la rappresentazione della polilinea del percorso rimanente restituita quando chiami il metodo GetTrip.
Per scegliere un formato per la polilinea, includi il parametro routePolylineFormat nella richiesta. I formati supportati includono:
ENCODED: una stringa di polilinea codificata standard (5 separatori decimali).S2ENCODED: una S2Polyline codificata.GEO_JSON: un formato LineString GeoJSON.
Opzione 2: utilizza Google Cloud Pub/Sub
Per ricevere aggiornamenti regolari sulle corse, iscriviti a un argomento Google Cloud Pub/Sub. Dopo che il conducente ha dato il consenso, Navigation Connect invia gli aggiornamenti direttamente al tuo argomento.
Per un'introduzione alla messaggistica, consulta la guida rapida di Pub/Sub.
Le sezioni seguenti descrivono come utilizzare Google Cloud Pub/Sub per ricevere dati da una sessione di navigazione con Google Maps o Waze.
1. Crea un argomento
Crea un argomento denominato esattamente navigation_connect_trip_notifications nel tuo progetto Google Cloud, come segue:
- Abilita l'API Pub/Sub.
- Vai alla pagina degli argomenti Pub/Sub nella console Google Cloud.
- Fai clic su Crea argomento.
Inserisci
navigation_connect_trip_notificationsnel campo ID argomento.Fai clic su Crea.
La console visualizza il nome completo dell'argomento come projects/project-number/topics/navigation_connect_trip_notifications, dove project-number è il numero di progetto univoco.
2. Concedi l'autorizzazione di pubblicazione al service account di Navigation Connect
Google utilizza un service account per pubblicare gli aggiornamenti delle corse negli argomenti Google Cloud Pub/Sub. Per ricevere aggiornamenti nel tuo argomento, concedi l'autorizzazione projects.topics.publish per questo argomento al seguente service account: geo-navigation-connect-pubsub@system.gserviceaccount.com.
Per saperne di più, consulta la documentazione di Pub/Sub sul controllo degli accessi.
3. Integrazione con il tuo backend
Per elaborare gli aggiornamenti, scrivi un'applicazione lato server che autentichi e si iscriva al tuo argomento. Utilizza le librerie client Pub/Sub per uno sviluppo semplificato. Per i test, puoi anche utilizzare gcloud CLI e la console Google.
4. Testa l'abbonamento
Verifica la configurazione utilizzando gcloud CLI o la console Google Cloud.
gcloud CLI
Esegui il pull dei messaggi da una sottoscrizione (ad esempio my-sub) utilizzando il seguente comando:
gcloud pubsub subscriptions pull my-sub --auto-ack
Console Google Cloud
Nella console Google Cloud, segui questi passaggi:
- Apri la pagina Abbonamenti.
- Seleziona l'abbonamento e fai clic sulla scheda Messaggi.
- Fai clic su Pull.
Passaggi successivi
Una volta che inizi a ricevere i dati sui percorsi, analizzali per utilizzarli nei tuoi sistemi e nelle tue app.