L'API Navigation Connect offre un'alternativa leggera all'SDK Navigation utilizzando le app Google Maps e Waze autonome per il routing, 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 per il 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 importanti e condividere aggiornamenti accurati con i tuoi clienti, mentre i conducenti utilizzano la loro app di navigazione preferita, Google Maps o Waze.
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 dell'autista e sui tempi di arrivo stimati.
- Migliora il monitoraggio delle consegne: informa i clienti dei tempi di spedizione o consegna del cibo accurati in base ai dati sul traffico in tempo reale e sul calcolo itinerario.
- Migliora la gestione e l'invio del parco risorse: prendi decisioni di invio consapevoli per i parchi risorse o le 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 su posizione in tempo reale e 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 dell'autista di utilizzare Google Maps o Waze o la sua esperienza utente.
- Accedere ai dati sulla posizione in tempo reale:ottieni in tempo reale le posizioni dei conducenti, le distanze rimanenti e il tempo trascorso ininterrottamente durante un viaggio.
- Monitora i cicli di vita dei percorsi:configura la frequenza di aggiornamento dei dati sul percorso per monitorare lo stato esatto di un percorso e sapere immediatamente quando un conducente è in viaggio, è arrivato o sospende un percorso.
- Visualizza e condividi gli ETA: recupera aggiornamenti degli ETA estremamente precisi grazie agli algoritmi di routing live di Google.
- Monitorare il percorso rimanente e il traffico:
ricevi la polilinea del percorso rimanente e le condizioni del traffico in tempo reale
dalla posizione attuale del conducente alla destinazione finale, esattamente come
visualizzato in Google Maps o Waze. Questa funzionalità attiva lo
SKU Navigation Connect Enterprise.
- Taglio dinamico:mentre il veicolo si muove, Navigation Connect taglia automaticamente la polilinea del percorso attivo del conducente (il percorso completo 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 al ricalcolo del percorso, al cambio percorso lato client proattivo o alle modifiche delle condizioni del traffico.
- Monitora le deviazioni dall'itinerario (solo Waze): rileva quando un conducente esce dall'itinerario, individua la posizione e l'ora esatte della deviazione e identifica se la deviazione è stata avviata dal conducente (ad esempio, una svolta sbagliata) o dal sistema (ad esempio, un ricalcolo dell'itinerario per evitare il traffico). Questa funzionalità attiva lo SKU Navigation Connect Enterprise.
- Importa i dati in modo flessibile:utilizza i dati dei viaggi in tempo reale tramite chiamate dirette all'API REST o 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 unica e restituisce un token di viaggio. Questo token viene poi aggiunto
a un deep link 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, ETA e distanza rimanente.
Risorse
La tabella seguente riassume 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 |
|---|---|
|
Identificatori di autenticazione e 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 Recupera i dati sul percorso. |
Telemetria della corsa in tempo reale, tra cui:
Consulta la sezione 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 | Crea 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 | Passa il token di viaggio e avvia Google Maps o Waze per attivare la condivisione dei dati di viaggio. |
| 4 | Recupera i dati sul percorso | Invia una chiamata all'API Navigation Connect per recuperare i dati sul percorso. Facoltativamente, iscriviti agli aggiornamenti utilizzando Google Cloud Pub/Sub. |
| 5 | Gestire i dati sul percorso | Scopri come gestire lo stato del percorso e altri dati sul percorso. |