L'API Navigation Connect offre un'alternativa leggera all'SDK Navigation utilizzando le app autonome Google Maps e Waze per il calcolo dell'itinerario, 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 conducente inizia un viaggio, visualizza la sua interfaccia di navigazione familiare con due aggiunte: un messaggio di richiesta del consenso alla condivisione dei dati sul percorso (richiesto ogni 12 mesi) e un pulsante Indietro con il brand per tornare alla tua app.
Perché utilizzare l'API Navigation Connect
Con l'API Navigation Connect, puoi integrare gli aggiornamenti in tempo reale della posizione e dell'orario di arrivo previsto del viaggio da Google Maps o Waze direttamente nei processi di backend. In questo modo, puoi prendere decisioni aziendali fondamentali e condividere aggiornamenti precisi con i tuoi clienti, mentre i conducenti utilizzano l'app di navigazione che preferiscono, Google Maps o Waze.
Alcuni esempi di casi d'uso sono:
- Aumentare la trasparenza del carpooling: fornisci ai clienti e ai passeggeri del carpooling aggiornamenti precisi e in tempo reale sulla posizione del conducente e sugli orari di arrivo previsti.
- Migliorare il monitoraggio delle consegne: informa i clienti degli orari di consegna di spedizioni o cibo precisi in base ai dati sul traffico e sul calcolo dell'itinerario in tempo reale.
- Migliorare la gestione e l'invio della flotta: prendi decisioni informate sull'invio per flotte o personale mobile che fornisce servizi on demand (come assistenza in caso di guasto, manutenzione o trasporto) monitorando le posizioni live dei conducenti.
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.
- Monitorare i viaggi in modo non intrusivo: monitora i viaggi senza modificare la scelta del conducente di utilizzare Google Maps o Waze o modificare la sua esperienza utente.
- Accedere ai dati sulla posizione in tempo reale: ottieni continuamente le posizioni dei conducenti, le distanze rimanenti e il tempo trascorso in tempo reale durante un viaggio.
- Monitorare 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 conducente è in viaggio, è arrivato o sospende un viaggio.
- Utilizzare e condividere gli orari di arrivo previsti: recupera aggiornamenti sull'orario di arrivo previsto estremamente precisi basati sugli algoritmi di calcolo dell'itinerario live di Google.
- Monitorare il percorso e il traffico rimanenti (solo Waze): ricevi la polilinea del percorso attivo e le condizioni del traffico in tempo reale dalla posizione attuale del conducente alla destinazione finale, esattamente come visualizzato in Waze.
- Ritaglio dinamico: man mano che il veicolo si muove, Navigation Connect ritaglia automaticamente la polilinea del percorso attivo per assicurarti di ricevere solo la parte rimanente del viaggio.
- Frequenza di aggiornamento: le condizioni del percorso e del traffico vengono aggiornate automaticamente in caso di ricalcolo dell'itinerario, ricalcolo proattivo lato client o modifiche delle condizioni del traffico.
- Inserire i dati in modo flessibile: utilizza i dati di viaggio in tempo reale tramite chiamate API REST dirette oppure trasmetti in streaming 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 quindi aggiunto a un deep link di Google Maps o Waze. Una volta che il conducente 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 previsto e distanza rimanente.
Risorse
La tabella seguente riepiloga le risorse disponibili tramite l'API Navigation Connect e i dati che restituisce. Per dettagli specifici, consulta il riferimento dell'API Navigation Connect.
| Risorse dati | Dati restituiti |
|---|---|
|
Identificatori di autenticazione e app mobile in formato JSON. Vedi Crea un viaggio. |
Un token di viaggio univoco utilizzato per inizializzare la connessione in Google Maps o Waze. Vedi Avvia Google Maps o Waze. |
|
L'ID viaggio univoco e un metodo pull o push in formato JSON. |
Telemetria di viaggio in tempo reale, tra cui:
|
Come utilizzare l'API Navigation Connect
| 1 | Configurazione | Inizia con Configura il progetto Google Cloud e completa le istruzioni riportate di seguito. |
| 2 | Crea un viaggio | Invia una chiamata all'API Navigation Connect per creare un viaggio con un ID univoco e salva il token. |
| 3 | Avvia Google Maps o Waze | Trasmetti il token di viaggio e avvia Google Maps o Waze per attivare la condivisione dei dati sul percorso. |
| 4 | Recupera 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 | Gestisci i dati sul percorso | Scopri come gestire lo stato del viaggio e altri dati sul percorso. |