Questo prodotto o funzionalità è sperimentale (pre-GA). I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le offerte pre-GA sono coperte dai Termini specifici di servizio di Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Panoramica della configurazione e requisiti

Questo documento spiega la procedura per configurare l'API Navigation Connect ed elenca i requisiti del dispositivo del conducente per l'utilizzo dell'API Navigation Connect.

Procedura di configurazione di Navigation Connect

Prima di poter utilizzare l'API Navigation Connect, devi completare i seguenti passaggi di configurazione:

Crea e configura un progetto Google Cloud.
Attiva l'API Navigation Connect e verifica la tua app.
Configura OAuth per creare token OAuth.
Configura il tuo service account per consentire la comunicazione tra la tua infrastruttura di backend e Google Maps o Waze.

Requisiti minimi del dispositivo per l'utilizzo di Navigation Connect

Questi requisiti sono necessari affinché il dispositivo del conducente possa eseguire correttamente una sessione di Navigation Connect. Una sessione utilizza l'API Navigation Connect per inviare dati sul percorso in tempo reale, come la posizione e l'orario di arrivo stimato, al server di backend.

Versioni dell'app supportate

Sul dispositivo deve essere installata Waze versione 5.15.5 o successive oppure Google Maps versione 26.14 o successive.

Posizione esatta attivata

Chiedi al conducente di attivare le autorizzazioni per la posizione esatta sul dispositivo. Waze e Google Maps richiedono la posizione esatta per avviare la navigazione.

Finestra di dialogo per il consenso del conducente.

Consenso del conducente

Navigation Connect richiede il consenso del conducente per condividere i dati sul percorso. Non devi attivare la finestra di dialogo per il consenso. Google Maps o Waze gestiscono automaticamente questa interfaccia utente.

Al primo viaggio avviato dalla tua app, Google Maps o Waze chiede al conducente di condividere i dati sul percorso.

Se il conducente tocca Consenti, Navigation Connect inizia a condividere la posizione in tempo reale e i dati sull'orario di arrivo stimato con il tuo backend.
Se il conducente tocca Non consentire o revoca il consenso in un secondo momento, Google Maps o Waze fornisce indicazioni passo passo, ma Navigation Connect non invia i dati. Il backend riceve uno stato CLIENT_ERROR nel payload dei dati sul percorso.

I conducenti devono riconfermare questo consenso ogni 12 mesi.

Passaggi successivi

Il primo passo per configurare l'API Navigation Connect è creare e configurare un progetto Google Cloud.

Configurare l'API Navigation Connect