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:

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

Requisiti minimi per i dispositivi per l'utilizzo di Navigation Connect

Questi requisiti sono necessari per l'esecuzione corretta di una sessione di Navigation Connect sul dispositivo del conducente. Una sessione utilizza l'API Navigation Connect per inviare dati sul percorso in tempo reale, come posizione e orario di arrivo stimato, al tuo 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 di accesso alla posizione esatta sul suo dispositivo. Waze e Google Maps richiedono la posizione esatta per avviare la navigazione.

Finestra di dialogo per il 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.

Durante il 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 i dati sulla posizione in tempo reale e 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 forniscono indicazioni stradali passo passo, ma Navigation Connect non invia dati. Il backend riceve lo stato CLIENT_ERROR nel payload dei dati sul percorso.

Gli autisti devono riconfermare questo consenso ogni 12 mesi.

Passaggi successivi

Il primo passaggio per configurare l'API Navigation Connect consiste nel creare e configurare un progetto Google Cloud.