Configurer Navigation Connect

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

Ce document décrit les étapes à suivre pour commencer à utiliser Navigation Connect.

Prérequis

Ce guide explique comment configurer votre compte Google Cloud et votre projet Google Cloud avec la facturation activée. Vous devez également savoir comment l'utilisation de l'API Navigation Connect vous est facturée.

  1. Consultez la facturation et les coûts d'utilisation sur la page Utilisation et facturation de Navigation Connect.
  2. Vérifiez que vous disposez d'un compte Google Cloud.

    Se connecter à la console Google Cloud
  3. Vérifiez que vous disposez d'un projet Google Cloud pour lequel la facturation est activée.

    Accéder à la page "Facturation"
    1. Sélectionnez votre projet pour ouvrir la page Facturation.
    2. Sur la page Facturation :

      • Si la facturation est déjà activée pour le projet sélectionné et que vous ne disposez que d'un seul compte de facturation, la page Facturation s'ouvre.
      • Si vous possédez plusieurs comptes de facturation, sélectionnez Accéder au compte de facturation associé pour afficher les détails du compte de facturation associé au projet.
      • Si un compte de facturation existe, mais qu'il n'est pas associé au projet, vous êtes invité à associer un compte de facturation au projet.
      • Si aucun compte de facturation n'existe ou si vous souhaitez en créer un, sélectionnez Gérer les comptes de facturation pour créer un compte de facturation. Pour en savoir plus, consultez Créer un compte de facturation Cloud en libre-service.

Activer l'API et valider votre application

Ce guide décrit la procédure à suivre pour activer l'API Navigation Connect et valider votre application dans la console Google Cloud, ce qui lui permet d'interagir de manière sécurisée avec Google Maps et Waze. Vous devez suivre cette procédure pour utiliser l'API Navigation Connect.

1. Activer l'API Navigation Connect

Utilisez la console Google Cloud ou la commande gcloud pour activer l'API Navigation Connect dans votre projet Google Cloud.

Pour activer l'API, procédez comme suit :

Console

  1. Ouvrez la page du produit dans la console Google Cloud :

    Activer l'API Navigation Connect
  2. Cliquez sur le bouton Activer.

gcloud

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

En savoir plus sur le SDK Google Cloud, l'installation du SDK Cloud et les commandes suivantes :

2. Lancer la procédure de validation de l'application

Après avoir activé l'API, vous devez valider votre application pour activer l'API Navigation Connect. L'activation de l'API ne suffit pas à accorder l'accès. Vous devez fournir des informations sur votre entreprise et votre application pour examen avant de pouvoir utiliser l'API Navigation Connect.

Pour lancer la procédure de validation, utilisez l'une des méthodes suivantes :

  • API Marketplace :
    1. Dans l' API Marketplace, recherchez la fiche API Navigation Connect.
    2. Cliquez sur l'icône bleue Validation requise pour lancer la procédure de validation.
  • Clés et identifiants dans la console Google Cloud :
    1. Dans la console Google Cloud, accédez à la page Clés et identifiants.
    2. Cliquez sur Clés et identifiants Navigation Connect.
    3. Dans la bannière, cliquez sur Lancer la validation.

3. Fournir des informations sur l'application, la collecte des données et la confidentialité

Le tableau suivant décrit les informations que vous devez fournir pour la validation de l'application :

Champ Description
Informations sur l'application

Fournissez les informations suivantes pour vous assurer que votre application s'affiche correctement dans Google Maps et Waze.

Nom de l'entreprise ou de l'application Saisissez le nom à afficher pour les utilisateurs dans Google Maps et Waze.
Identifiant de l'application Indiquez le nom de votre package Android ou l'ID de votre bundle iOS.
Lien universel iOS Indiquez le lien universel iOS qui permet aux utilisateurs de revenir à votre application (disponible sur Waze uniquement).
Logo de l'application (Waze uniquement) (Facultatif) Importez un logo PNG ou JPG (de 32 x 32 à 128 x 128 pixels) pour afficher le logo de votre application dans Waze pendant une session de navigation.
Informations sur la collecte et la confidentialité des données

Saisissez les informations suivantes pour garantir la transparence, la confiance des conducteurs et la sécurité des données.

Lien vers les règles de confidentialité Indiquez l'URL des règles de confidentialité de votre application. Ce lien s'affiche sur l'écran de consentement.
Responsables du traitement supplémentaires (facultatif) Indiquez le nom commercial et le lien vers les règles de confidentialité de tout gestionnaire de données tiers, comme un éditeur indépendant. Ces informations s'affichent sur l'écran de consentement.
Conformité des données Si votre application est utilisée aux États-Unis, cochez la case Cette application sera utilisée pour les trajets effectués aux États-Unis afin de garantir la conformité avec les réglementations locales.

4. Vérifier et envoyer

Vérifiez le récapitulatif des informations que vous avez fournies avant d'envoyer votre application pour validation.

  1. Vérifiez attentivement le nom, la plate-forme, les ID et les liens de votre application.

  2. Cochez la case Toutes les informations sont exactes.
  3. Cliquez sur Envoyer.

Une fois que vous avez envoyé votre application pour validation, la phase d'examen commence.

  • Délai : la validation prend généralement un à trois jours ouvrés.
  • Notification : vous recevez un e-mail lorsque l'état de validation change. Vous recevez également un e-mail vous demandant l'ID de votre profil de paiement ou votre ID de développeur Android. Si vous avez besoin d'un ID de développeur Android, consultez Créer un compte de développeur.
  • Suivi de l'état : suivez votre progression sur la page Clés et identifiants de la console Google Cloud.
  • Assistance : pour mettre à jour votre configuration après approbation sans affecter la production, créez une demande d'assistance.

Une fois validée, votre application est autorisée à utiliser l'API Navigation Connect pour générer des jetons de trajet qui autorisent l'accès à une session de navigation et vous permettent de recevoir les détails du trajet depuis Google Maps et Waze.

Les produits Google Maps Platform exigent que les appels d'API incluent un jeton OAuth pour empêcher 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 API au serveur, ou 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 manières, en fonction de votre environnement de déploiement.

Vous pouvez utiliser OAuth 2.0 pour les interactions de 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 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 : Tester 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 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.

Utilisez la procédure REST suivante uniquement pour le développement ou les tests, et non pour la production.

Prérequis

Avant d'effectuer une requête REST à l'aide d'ADC, utilisez la CLI gcloud pour fournir des identifiants à 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. Terminez le processus 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 en utilisant 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 de type entier long pour le projet.
  • 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