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.

Vérifiez que vous remplissez les conditions préalables.

Activez l'API dans votre projet Google Cloud.

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

Les produits Google Maps Platform exigent que les appels d'API incluent un jeton OAuth pour éviter toute utilisation non autorisée.

Créer un jeton OAuth

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

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

Vous pouvez appeler les API Google Maps directement en envoyant des requêtes d'API au serveur, ou vous pouvez utiliser des bibliothèques clientes pour simplifier votre code. Google Maps fournit des bibliothèques clientes pour Go, Java, Node.js et Python. Pour en savoir plus, consultez Bibliothèques clientes Navigation Connect.

Présentation d'OAuth

Vous pouvez créer et gérer des jetons d'accès avec OAuth de plusieurs façons, en fonction de votre environnement de déploiement.

Vous pouvez utiliser OAuth 2.0 pour les interactions serveur à serveur entre votre application et un service Google. Dans ce scénario, vous utilisez un compte de service associé à votre application plutôt qu'à un utilisateur individuel. Vous pouvez envoyer des requêtes d'API à l'aide du compte de service sans impliquer directement les utilisateurs. Pour en savoir plus sur les méthodes d'authentification, consultez Méthodes d'authentification chez Google.

Vous pouvez également intégrer Navigation Connect à une application mobile Android ou iOS. Pour en savoir plus sur l'utilisation d'OAuth et 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.

Champs d'application OAuth

Pour utiliser OAuth avec Navigation Connect, vous devez attribuer le champ d'application suivant au jeton OAuth :

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

Exemple : essayer des appels d'API REST dans votre environnement de développement local

Si vous ne disposez pas d'un environnement qui génère des jetons et que vous souhaitez essayer Navigation Connect avec un jeton OAuth, suivez la procédure décrite dans cette section.

Cet exemple décrit 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 avec des bibliothèques clientes, consultez S'authentifier à l'aide de bibliothèques clientes.

N'utilisez la procédure REST suivante que pour le développement ou les tests, et non pour la production.

Prérequis

Avant d'effectuer une requête REST à l'aide des ADC, utilisez la CLI gcloud pour fournir des identifiants aux ADC :

  1. Installez et initialisez la CLI gcloud. Pour en savoir plus, consultez Installer la gcloud CLI.

  2. Authentifiez-vous à l'aide de la CLI gcloud :

    gcloud auth application-default login

  3. Finalisez la procédure de connexion pour enregistrer vos identifiants 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 de 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'en-tête X-Goog-User-Project.

Pour appeler Navigation Connect à l'aide d'un jeton OAuth, procédez comme suit :

  1. Dans l'exemple de code suivant, remplacez les espaces réservés par vos valeurs :

    • PROJECT_ID : ID de votre projet Google Cloud
    • ANDROID_APP_ID : nom du package Android de votre application, le cas échéant
    • IOS_APP_ID : ID du bundle iOS de votre application, le cas échéant
    #!/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. Pour copier la commande curl, cliquez sur Copier dans l'exemple de code.

  3. Collez la commande dans une fenêtre de terminal, puis 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 unique du projet (nombre entier long)
  • TRIP_ID : ID de trajet UUIDv4 généré par votre backend
  • BASE64_ENCODED_TRIP_TOKEN : jeton authentifié renvoyé par la méthode createTrip pour lancer la navigation détaillée suivie dans Google Maps ou Waze

Dépannage

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

Étape suivante

Ensuite, configurez vos comptes de service pour l'API Navigation Connect afin de permettre une communication sécurisée de serveur à serveur entre votre infrastructure de backend, Google Maps et Waze.

Configurer votre compte de service