Configurer Navigation Connect

Développeurs de l'Espace économique européen (EEE)

Ce document décrit la procédure à suivre pour commencer à utiliser Navigation Connect.

Assurez-vous de remplir les conditions préalables.

Activez l'API dans votre projet Google Cloud.

Configurez un OAuth pour effectuer une requête API authentifiée.

Les produits Google Maps Platform sont protégés contre les utilisations non autorisées, car les appels d'API doivent inclure un jeton OAuth.

Créer un jeton OAuth

Navigation Connect est compatible avec l'utilisation d'OAuth 2.0 pour l'authentification. Google accepte les scénarios courants OAuth 2.0, tels que ceux relatifs à un serveur Web.

Ce document explique comment transmettre un jeton OAuth à l'appel Navigation Connect dans votre environnement de développement. Pour obtenir des instructions sur l'utilisation d'OAuth dans un environnement de production, consultez Méthodes d'authentification chez Google.

À propos d'OAuth

Il existe de nombreuses façons de créer et de gérer des jetons d'accès avec OAuth en fonction de votre environnement de déploiement.

Par exemple, le système Google OAuth 2.0 est compatible avec les interactions entre serveurs, telles que celles entre votre application et un service Google. Pour ce scénario, vous avez besoin d'un compte de service, qui est un compte qui appartient à votre application et non à un utilisateur final. Votre application appelle les API Google au nom du compte de service, de sorte que les utilisateurs ne sont pas directement impliqués. Pour en savoir plus sur les méthodes d'authentification, consultez Méthodes d'authentification chez Google.

Vous pouvez également utiliser Navigation Connect dans le cadre d'une application mobile Android ou iOS. Pour obtenir des informations générales sur l'utilisation d'OAuth avec Navigation Connect, y compris des informations sur la gestion des jetons d'accès pour différents environnements de déploiement, consultez Utiliser OAuth 2.0 pour accéder aux API Google.

À propos des champs d'application OAuth

Pour utiliser OAuth avec Navigation Connect, le jeton OAuth doit être associé au champ d'application suivant :

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

Exemple : tester les appels d'API REST dans votre environnement de développement local

Si vous souhaitez essayer Navigation Connect à l'aide d'un jeton OAuth, mais que vous ne disposez pas d'une configuration d'environnement pour générer des jetons, vous pouvez utiliser la procédure décrite dans cette section pour effectuer l'appel.

Cet exemple explique comment utiliser le jeton OAuth fourni par les identifiants par défaut de l'application (ADC) pour effectuer l'appel. Pour en savoir plus sur l'utilisation des ADC pour appeler des API Google à l'aide de bibliothèques clientes, consultez la page S'authentifier à l'aide de bibliothèques clientes.

Prérequis

Pour pouvoir effectuer une requête REST à l'aide des ADC, utilisez Google Cloud CLI pour fournir des identifiants aux ADC :

  1. Installez et initialisez gcloud CLI.

  2. Exécutez la commande gcloud suivante sur votre machine locale pour créer votre fichier d'identifiants :

    gcloud auth application-default login
  3. Un écran de connexion s'affiche. Une fois que vous êtes connecté, vos identifiants sont stockés dans le fichier d'identifiants local utilisé par ADC.

Pour en savoir plus, consultez Configurer les ADC pour un environnement de développement local.

Effectuer une requête REST

Dans cet exemple, vous transmettez deux en-têtes de requête :

  • Transmettez le jeton OAuth dans l'en-tête Authorization à l'aide de la commande suivante pour générer le jeton :

    gcloud auth application-default print-access-token

    Le jeton renvoyé a un champ d'application https://www.googleapis.com/auth/cloud-platform.

  • Transmettez l'ID ou le nom de votre projet Google Cloud pour lequel la facturation est activée dans l' X-Goog-User-Project en-tête.

L'exemple suivant effectue un appel à Navigation Connect à l'aide d'un jeton OAuth.

  1. Modifiez le champ PROJECT_ID pour transmettre l'ID de votre projet Google Cloud.

    Modifiez également les éléments suivants, le cas échéant :

    • ANDROID_APP_ID : nom du package Android de votre application.
    • IOS_APP_ID : ID du bundle iOS de votre application.
    #!/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. Cliquez sur l'icône de copie dans l'exemple de code, Sélectionnez l'icône de copie., pour copier la curl commande.
  3. Collez la commande dans une fenêtre de terminal et exécutez-la.

La réponse est un objet 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",
}

Cette réponse inclut les valeurs suivantes :

  • PROJECT_NUMBER : identifiant entier long unique du projet.
  • TRIP_ID : ID de trajet généré par votre backend au format UUIDv4.
  • BASE64_ENCODED_TRIP_TOKEN : jeton authentifié renvoyé par la méthode createTrip. Transmettez ce jeton à votre application mobile pour lancer la navigation guidée avec suivi dans Google Maps ou Waze.

Dépannage

Si votre requête renvoie un message d'erreur indiquant que les identifiants d'utilisateur final ne sont pas compatibles avec cette API, consultez Résoudre les problèmes de configuration de vos ADC.

Étape suivante

L'étape suivante de la configuration de l'API Navigation Connect consiste à configurer vos comptes de service pour activer une communication sécurisée de serveur à serveur entre votre infrastructure backend, Google Maps et Waze.

Configurer votre compte de service