Panoramica dell'API Navigation Connect

Sviluppatori dello Spazio economico europeo (SEE)

L'API Navigation Connect è un servizio che collega l'utilizzo della navigazione di Google Maps e Waze da parte del tuo autista ai sistemi aziendali. Utilizza token di autorizzazione della corsa insieme a un deep link nella tua app, in modo che l'autista possa toccare un link o un pulsante per iniziare la navigazione nell'app per utenti finali di sua scelta. Mentre l'autista naviga durante il viaggio, puoi ricevere dati sulla posizione in tempo reale in corso, come posizioni in tempo reale, orari di arrivo stimati molto precisi e stati del ciclo di vita del viaggio.

L'API Navigation Connect offre un'alternativa leggera all'SDK Navigation utilizzando le app Google Maps e Waze autonome per il calcolo del percorso anziché richiedere di creare e incorporare un'interfaccia di navigazione personalizzata nella tua app. Collega in modo sicuro la sessione del conducente al tuo backend. Quando un autista inizia un viaggio, visualizza la sua interfaccia di navigazione familiare con due aggiunte: un prompt di consenso alla condivisione dei dati sul percorso (richiesto ogni 12 mesi) e un pulsante Indietro brandizzato per tornare alla tua app.

Perché utilizzare l'API Navigation Connect

Con l'API Navigation Connect, puoi integrare la posizione del viaggio in tempo reale e gli aggiornamenti dell'orario di arrivo stimato da Google Maps o Waze direttamente nei tuoi processi di backend. In questo modo, puoi prendere decisioni aziendali fondamentali e condividere aggiornamenti accurati con i tuoi clienti, mentre i conducenti utilizzano la loro app di navigazione preferita, Google Maps o Waze.

Ecco alcuni esempi di casi d'uso:

  • Aumentare la trasparenza del ridesharing:fornire ai clienti e ai passeggeri del ridesharing aggiornamenti precisi e in tempo reale sulla posizione del conducente e sui tempi di arrivo stimati.
  • Migliora il monitoraggio delle consegne: informa i clienti di tempi di spedizione o consegna di cibo accurati in base ai dati sul traffico e sul calcolo itinerario in tempo reale.
  • Migliora la gestione della flotta e l'invio: prendi decisioni di invio informate per flotte o forze lavoro mobili che forniscono servizi on demand (come assistenza stradale, manutenzione o trasporto) monitorando le posizioni dei conducenti in tempo reale.

Cosa puoi fare con l'API Navigation Connect

L'API Navigation Connect ti consente di ricevere aggiornamenti sulla posizione in tempo reale e sull'orario di arrivo stimato da Google Maps o Waze direttamente nel tuo backend.

  • Monitora i viaggi in modo non intrusivo:monitora i viaggi senza modificare la scelta dell'autista di utilizzare Google Maps o Waze o la sua esperienza utente.
  • Accedere ai dati sulla posizione in tempo reale:ottieni le posizioni dei conducenti in tempo reale, le distanze rimanenti e il tempo trascorso in modo continuo durante una corsa.
  • Monitora i cicli di vita dei viaggi:configura la frequenza di aggiornamento dei dati sul percorso per monitorare lo stato esatto di un viaggio e sapere immediatamente quando un autista è in viaggio, è arrivato o sospende un viaggio.
  • Consumare e condividere gli orari di arrivo stimati: recupera aggiornamenti dell'orario di arrivo stimato estremamente precisi grazie agli algoritmi di routing live di Google.
  • Monitora il percorso e il traffico rimanenti (solo Waze): ricevi la polilinea del percorso rimanente e le condizioni del traffico in tempo reale dalla posizione attuale del conducente alla destinazione finale, esattamente come vengono visualizzate in Waze.
    • Taglio dinamico:mentre il veicolo si muove, Navigation Connect taglia automaticamente la polilinea del percorso attivo del conducente (il percorso completo attualmente navigato nell'app) per assicurarsi di ricevere solo il percorso rimanente (il segmento dalla posizione attuale del conducente alla destinazione).
    • Frequenza di aggiornamento:le condizioni del percorso e del traffico vengono aggiornate automaticamente in caso di ricalcolo del percorso, reindirizzamento proattivo lato client o modifiche alle condizioni del traffico.
  • Importa i dati in modo flessibile:utilizza i dati dei viaggi in tempo reale tramite chiamate dirette all'API REST o trasmetti gli aggiornamenti in modo efficiente utilizzando le sottoscrizioni Google Cloud Pub/Sub.

Come funziona l'API Navigation Connect

L'API Navigation Connect accetta una richiesta CreateTrip contenente gli identificatori dell'applicazione mobile e la configurazione della sessione. Il servizio genera un'istanza di viaggio univoca e restituisce un token di viaggio. Questo token viene poi aggiunto a un link diretto di Google Maps o Waze. Una volta che l'autista avvia la navigazione e concede il consenso, il servizio elabora i dati di navigazione in tempo reale e restituisce gli aggiornamenti di telemetria, inclusi posizione, orario di arrivo stimato e distanza rimanente.

Risorse

La tabella seguente riepiloga le risorse disponibili tramite l'API Navigation Connect insieme ai dati che restituisce. Per dettagli specifici, consulta il Riferimento API Navigation Connect.

Risorse di dati Dati restituiti

Autenticazione e identificatori di app mobile in formato JSON.

Vedi Creare un viaggio.

Un token di viaggio univoco utilizzato per inizializzare la connessione in Google Maps o Waze.

Consulta Avviare Google Maps o Waze.

L'ID viaggio univoco e un metodo pull o push in formato JSON.

Consulta Recuperare i dati sul percorso.

Telemetria dei viaggi in tempo reale, tra cui:

  • Stato e metadati del viaggio
  • Posizione attuale (latitudine/longitudine)
  • Orario di arrivo stimato (ATE)
  • Distanza e tempo rimanenti

Consulta Gestire i dati sul percorso.

Come utilizzare l'API Navigation Connect

1 Configurazione Inizia con Configura il progetto Google Cloud e completa le istruzioni riportate di seguito.
2 Creare un viaggio Invia una chiamata all'API Navigation Connect per creare un viaggio con un ID univoco e salva il token.
3 Avviare Google Maps o Waze Trasferisci il token di viaggio e avvia Google Maps o Waze per attivare la condivisione dei dati sul percorso.
4 Recuperare i dati sul percorso Invia una chiamata all'API Navigation Connect per recuperare i dati sul percorso. Se vuoi, puoi abbonarti agli aggiornamenti utilizzando Google Cloud Pub/Sub.
5 Gestire i dati sul percorso Scopri come gestire lo stato del viaggio e altri dati del viaggio.