Configurare Navigation Connect

Sviluppatori dello Spazio economico europeo (SEE)

Questo documento descrive i passaggi necessari per iniziare a utilizzare Navigation Connect.

Assicurati di soddisfare i prerequisiti.

Abilita l'API nel tuo progetto Google Cloud.

Configura un OAuth per effettuare una richiesta API autenticata.

Abilitare l'API e verificare l'app

Questa guida descrive la procedura per abilitare l'API Navigation Connect e verificare l'app in Google Cloud console, che consente alla tua app di interfacciarsi in modo sicuro con Google Maps e Waze. Devi completare questa procedura per utilizzare l'API Navigation Connect.

1. Abilitare l'API Navigation Connect

Utilizza la console Google Cloud o il gcloud comando per abilitare l'API Navigation Connect nel tuo progetto Google Cloud.

Per abilitare l'API, segui questi passaggi:

Console

  1. Apri la pagina del prodotto nella console Google Cloud:

    Abilitare l'API Navigation Connect

  2. Fai clic sul pulsante Abilita.

gcloud

gcloud services enable \
    --project "PROJECT" \
    "navigationconnect.googleapis.com"

Scopri di più su Google Cloud SDK , sull' installazione di Cloud SDK e sui seguenti comandi:

2. Avviare la procedura di verifica dell'app

Dopo aver abilitato l'API, devi verificare l'app per attivarla. La sola abilitazione dell'API non concede l'accesso. Prima di poter utilizzare l'API Navigation Connect, devi fornire i dettagli dell'attività e dell'app per la revisione.

Per avviare la procedura di verifica, utilizza uno dei seguenti metodi:

  • API Marketplace:
    1. In API Marketplace, trova la scheda API Navigation Connect.
    2. Fai clic sull'icona blu Verifica richiesta per avviare il flusso di verifica.
  • Chiavi e credenziali nella console Google Cloud:
    1. Nella console Google Cloud, vai alla pagina Chiavi e credenziali.
    2. Fai clic su Chiavi e credenziali di Navigation Connect.
    3. Nel banner, fai clic su Avvia la verifica.

3. Fornire i dettagli dell'app, della raccolta dei dati e della privacy

La seguente tabella descrive i dettagli che devi fornire per la verifica dell'app:

Campo Descrizione
Dettagli dell'app

Fornisci i seguenti dettagli per assicurarti che l'app venga visualizzata correttamente in Google Maps e Waze.
Nome dell'attività o dell'app Inserisci il nome da mostrare agli utenti in Google Maps e Waze.
ID app Fornisci il nome del pacchetto Android o l'ID bundle iOS.
Link universale iOS Fornisci il link universale iOS che consente agli utenti di tornare alla tua app (disponibile solo su Waze).
Logo dell'app (solo Waze) (Facoltativo) Carica un logo PNG o JPG (da 32x32 a 128x128 pixel) da visualizzare in Waze durante una sessione di navigazione.
Dettagli sulla raccolta dei dati e sulla privacy

Inserisci i seguenti dettagli per garantire trasparenza, fiducia dei conducenti e sicurezza dei dati.
Link alle norme sulla privacy Fornisci l'URL delle norme sulla privacy della tua app. Questo link viene visualizzato nella schermata per il consenso.
Titolari del trattamento dei dati aggiuntivi (facoltativo) Fornisci il nome commerciale e il link alle norme sulla privacy di eventuali gestori di dati di terze parti, ad esempio ISV. Questi dettagli vengono visualizzati nella schermata per il consenso.
Conformità dei dati Se la tua app opera negli Stati Uniti, seleziona la casella di controllo Questa app verrà utilizzata per viaggi negli Stati Uniti per garantire la conformità alle normative locali regolamenti.

4. Rivedi e invia

Rivedi il riepilogo delle informazioni fornite prima di inviare l'app per la verifica.

  1. Esamina attentamente il nome, la piattaforma, gli ID e i link dell'app.

  2. Seleziona la casella di controllo Tutte le informazioni sono accurate.
  3. Fai clic su Invia.

Dopo aver inviato l'app per la verifica, inizia la fase di revisione.

  • Tempistiche:la verifica richiede in genere 1-3 giorni lavorativi.
  • Notifica:riceverai un'email quando lo stato della verifica cambia. Riceverai anche un'email in cui ti verrà chiesto l'ID del profilo pagamenti o l'ID sviluppatore Android. Se hai bisogno di un ID sviluppatore Android, consulta Creare un account sviluppatore.
  • Monitoraggio dello stato: monitora i tuoi progressi nella pagina Chiavi e credenziali della console Google Cloud.
  • Assistenza: per aggiornare la configurazione dopo l'approvazione senza influire sulla produzione, crea una richiesta di assistenza.

Una volta verificata, la tua app è autorizzata a utilizzare l'API Navigation Connect per generare token di viaggio che autorizzano l'accesso a una sessione di navigazione e ti consentono di ricevere i dettagli del viaggio da Google Maps e Waze.