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.

Attiva l'API nel tuo progetto Google Cloud.

Configura un OAuth per effettuare una richiesta API autenticata.

I prodotti Google Maps Platform sono protetti dall'utilizzo non autorizzato richiedendo che le chiamate API includano un token OAuth.

Crea un token OAuth

Navigation Connect supporta l'utilizzo di OAuth 2.0 per l'autenticazione. Google supporta gli scenari OAuth 2.0 comuni, ad esempio quelli per un server web.

Questo documento descrive come trasmettere un token OAuth alla chiamata Navigation Connect nel tuo ambiente di sviluppo. Per istruzioni sull'utilizzo di OAuth in un ambiente di produzione, consulta Metodi di autenticazione di Google.

Informazioni su OAuth

Esistono molti modi per creare e gestire token di accesso con OAuth in base all'ambiente di deployment.

Ad esempio, il sistema Google OAuth 2.0 supporta le interazioni server-to-server, come quelle tra la tua applicazione e un servizio Google. Per questo scenario è necessario un service account, ovvero un account che appartiene alla tua applicazione anziché a un singolo utente finale. La tua applicazione chiama le API di Google per conto del service account, quindi gli utenti non sono direttamente coinvolti. Per saperne di più sui metodi di autenticazione, vedi Metodi di autenticazione di Google.

In alternativa, puoi utilizzare Navigation Connect come parte di un'app mobile Android o iOS. Per informazioni generali sull'utilizzo di OAuth con Navigation Connect, incluse quelle sulla gestione dei token di accesso per diversi ambienti di deployment, consulta Utilizzare OAuth 2.0 per accedere alle API di Google.

Informazioni sugli ambiti OAuth

Per utilizzare OAuth con Navigation Connect, al token OAuth deve essere assegnato l'ambito:

https://www.googleapis.com/auth/cloud-platform

Esempio: prova le chiamate API REST nel tuo ambiente di sviluppo locale

Se vuoi provare Navigation Connect utilizzando un token OAuth, ma non hai configurato un ambiente per generare token, puoi utilizzare la procedura descritta in questa sezione per effettuare la chiamata.

Questo esempio descrive come utilizzare il token OAuth fornito dalle credenziali predefinite dell'applicazione (ADC) per effettuare la chiamata. Per informazioni sull'utilizzo di ADC per chiamare le API di Google utilizzando le librerie client, consulta Autenticarsi utilizzando le librerie client.

Prerequisiti

Prima di poter effettuare una richiesta REST utilizzando ADC, utilizza Google Cloud CLI per fornire le credenziali ad ADC:

  1. Installa e inizializza gcloud CLI.

  2. Esegui il seguente comando gcloud sulla tua macchina locale per creare il file delle credenziali:

    gcloud auth application-default login
  3. Viene visualizzata una schermata di accesso. Dopo aver eseguito l'accesso, le tue credenziali vengono archiviate nel file delle credenziali locali utilizzato da ADC.

Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale.

Effettuare una richiesta REST

In questo esempio, vengono trasmesse due intestazioni della richiesta:

  • Passa il token OAuth nell'intestazione Authorization utilizzando il seguente comando per generare il token:

    gcloud auth application-default print-access-token

    Il token restituito ha un ambito di https://www.googleapis.com/auth/cloud-platform.

  • Trasferisci l'ID o il nome del tuo progetto Google Cloud per cui è attivata la fatturazione nell'intestazione X-Goog-User-Project.

Il seguente esempio esegue una chiamata a Navigation Connect utilizzando un token OAuth.

  1. Modifica il campo PROJECT_ID per passare l'ID del tuo progetto Google Cloud.

    Modifica anche quanto segue, a seconda dei casi:

    • ANDROID_APP_ID: il nome del pacchetto Android della tua app.
    • IOS_APP_ID: l'ID pacchetto iOS della tua app.
    #!/bin/bash

trip_id="$(uuidgen)"
access_token="$(gcloud auth application-default print-access-token)"

curl -X POST "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips?tripId=${trip_id}" \
  -H "Authorization: Bearer ${access_token}" \
  -H "Content-Type: application/json" \
  -d '{
  "androidAppId": "ANDROID_APP_ID",
  "iosAppId": "IOS_APP_ID",
}'
  2. Fai clic sull'icona di copia nell'esempio di codice, Seleziona l'icona di copia., per copiare il comando curl.
  3. Incolla il comando in una finestra del terminale ed eseguilo.

La risposta è un oggetto JSON:

{
  "name": "projects/PROJECT_NUMBER/trips/TRIP_ID",
  "authToken": {
    "token": "BASE64_ENCODED_TRIP_TOKEN",
    "expireTime": "2026-03-06T11:09:47.476942Z"
  },
  "state": "NEW",
  "execution": {
    "traveledDistanceMeters": 0,
    "stopAddedInRoute": false
  },
  "createTime": "2026-03-05T23:09:50.768959Z",
  "updateTime": "2026-03-05T23:09:50.768959Z",
}

Questa risposta include i seguenti valori:

  • PROJECT_NUMBER: l'identificatore univoco di tipo intero lungo per il progetto.
  • TRIP_ID: l'ID viaggio generato dal backend in formato UUIDv4.
  • BASE64_ENCODED_TRIP_TOKEN: il token autenticato restituito dal metodo createTrip. Trasferisci questo token alla tua app mobile per avviare la navigazione passo passo monitorata in Google Maps o Waze.

Risoluzione dei problemi

Se la richiesta restituisce un messaggio di errore relativo alle credenziali dell'utente finale non supportate da questa API, consulta Risolvere i problemi di configurazione di ADC.

Passaggi successivi

Il passaggio successivo per la configurazione dell'API Navigation Connect consiste nell'impostare i service account per abilitare la comunicazione sicura da server a server tra l'infrastruttura di backend e Google Maps e Waze.

Configurare il service account