Configurare Navigation Connect

Sviluppatori dello Spazio economico europeo (SEE)

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

Verifica di soddisfare i prerequisiti.

Attiva l'API nel tuo progetto Google Cloud.

Configura OAuth per effettuare una richiesta API autenticata.

I prodotti Google Maps Platform richiedono che le chiamate API includano un token OAuth per impedire l'utilizzo non autorizzato.

Creare un token OAuth

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

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

Puoi chiamare le API di Google Maps direttamente effettuando richieste API al server oppure puoi utilizzare le librerie client per semplificare il codice. Google Maps fornisce librerie client per Go, Java, Node.js e Python. Per saperne di più, vedi Librerie client Navigation Connect.

Panoramica di OAuth

Puoi creare e gestire token di accesso con OAuth in diversi modi a seconda dell'ambiente di deployment.

Puoi utilizzare OAuth 2.0 per le interazioni server-to-server tra la tua applicazione e un servizio Google. Per questo scenario, utilizzi un service account associato alla tua applicazione anziché a un singolo utente. Puoi effettuare richieste API utilizzando il service account senza coinvolgere direttamente gli utenti. Per saperne di più sui metodi di autenticazione, vedi Metodi di autenticazione di Google.

In alternativa, puoi integrare Navigation Connect in un'app mobile Android o iOS. Per ulteriori informazioni sull'utilizzo di OAuth e sulla gestione dei token di accesso per diversi ambienti di deployment, consulta Utilizzare OAuth 2.0 per accedere alle API di Google.

ambiti OAuth

Per utilizzare OAuth con Navigation Connect, devi assegnare al token OAuth il seguente ambito:

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

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

Se non hai un ambiente che genera token e vuoi provare Navigation Connect con un token OAuth, utilizza la procedura descritta in questa sezione.

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

Utilizza la seguente procedura REST solo per lo sviluppo o i test, non per la produzione.

Prerequisiti

Prima di effettuare una richiesta REST utilizzando ADC, utilizza la CLI gcloud per fornire le credenziali ad ADC:

  1. Installa e inizializza la CLI gcloud. Per saperne di più, consulta Installa gcloud CLI.

  2. Esegui l'autenticazione con la CLI gcloud:

    gcloud auth application-default login

  3. Completa la procedura di accesso per salvare le tue credenziali nel file delle credenziali locali utilizzato da ADC.

Per maggiori informazioni, vedi Configura ADC per un ambiente di sviluppo locale.

Effettuare una richiesta REST

In questo esempio, trasmetti 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 con la fatturazione abilitata nell'intestazione X-Goog-User-Project.

Per chiamare Navigation Connect utilizzando un token OAuth, completa i seguenti passaggi:

  1. Nel seguente esempio di codice, sostituisci i segnaposto con i tuoi valori:

    • PROJECT_ID: il tuo ID progetto Google Cloud
    • ANDROID_APP_ID: il nome del pacchetto Android della tua app, se applicabile
    • IOS_APP_ID: l'ID pacchetto iOS della tua app, se applicabile
    #!/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. Per copiare il comando curl, fai clic su Copia nell'esempio di codice.

  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 long-integer per il progetto
  • TRIP_ID: l'ID viaggio UUIDv4 generato dal backend
  • BASE64_ENCODED_TRIP_TOKEN: il token autenticato restituito dal metodo createTrip per avviare la navigazione passo passo monitorata in Google Maps o Waze

Risoluzione dei problemi

Se la tua richiesta restituisce un messaggio di errore che indica che questa API non supporta le credenziali dell'utente finale, consulta Risolvere i problemi di configurazione delle credenziali predefinite dell'account di servizio.

Passaggi successivi

Successivamente, configura i service account per l'API Navigation Connect in modo da supportare la comunicazione sicura da server a server tra l'infrastruttura di backend, Google Maps e Waze.

Configurare il service account