Guide de migration des ID client

Présentation

Afin d'améliorer la sécurité et la fiabilité de l'authentification, les ID client Maps Platform sont obsolètes depuis le 26 mai 2025 et ne pourront plus être utilisés après le 31 mai 2026.

Au lieu d'utiliser un ID client, vous devez utiliser des identifiants de clé API pour authentifier le trafic de votre service d'API Google Maps. Ce guide vous explique comment passer des ID client aux clés API.

Pour commencer, procédez comme suit :

1. Vérifiez l'utilisation actuelle de l'ID client.
2. Préparez les clés API.
3. Vérifiez les paramètres de quota.
4. Mettez à jour votre code.
5. Surveillez le trafic de votre ID client.
6. Mettez en veille votre ID client.

Vérifier l'utilisation actuelle de l'ID client

Avant de commencer le processus de migration, listez les éléments suivants :

• Les services Maps Platform que vous utilisez avec votre ID client.
• Les applications, sites ou systèmes que vous utilisez avec votre ID client.

Google a envoyé un e-mail de notification aux clients concernés concernant l'obsolescence des ID client en mai 2025. Vous trouverez également ces informations dans l'e-mail de notification.

Dans la console Cloud, vous pouvez vérifier l'état le plus récent de l'utilisation de votre ID client sur la page Métriques Google Maps

Pour obtenir la liste des services Maps Platform :

1. Ouvrez la page Métriques dans la console Cloud.
2. Filtrez votre utilisation avec les paramètres suivants :
   • Identifiants : sélectionnez uniquement "project_number:<identifiant numérique>".
3. Définissez le filtre suivant.
   • Groupé par : API

Pour obtenir des indications sur les applications, les sites ou les systèmes :

La console Cloud n'affiche pas les détails de vos applications, sites ou systèmes. Toutefois, vous pouvez trouver des indications sur les sources de trafic de votre ID client. Procédez comme suit :

1. Ouvrez la page Métriques dans la console Cloud.
2. Sélectionnez un service Maps Platform dans le menu déroulant.
3. Filtrez votre utilisation avec les paramètres suivants :
   • Identifiants : sélectionnez uniquement "project_number:<identifiant numérique>".
4. Définissez le filtre suivant.
   • Regrouper par : plate-forme ou domaine
5. Répétez l'étape 2 pour chaque service Maps Platform pour lequel vous devez vérifier le trafic.

Préparer les clés API

Tous les ID client sont associés à un projet Google Cloud. L'utilisation d'une clé API de ce projet vous donnera accès aux mêmes fonctionnalités que celles auxquelles vous accédiez auparavant avec votre ID client. Nous vous recommandons de migrer vers le projet associé pour éviter les problèmes de quotas ou les fonctionnalités manquantes.

1. Recherchez le projet Cloud auquel votre ID client est associé :
   • Questions fréquentes sur la migration du portail
2. Assurez-vous que votre projet Cloud est associé à un compte de facturation ouvert.
3. Créez une nouvelle clé API pour la migration de l'ID client.
   • Vous pouvez réutiliser toutes les clés API existantes dans le projet Cloud.
   • Vous pouvez utiliser plusieurs clés API du même projet Cloud, par exemple pour séparer le trafic de chaque service Maps Platform ou pour séparer le trafic de différentes plates-formes (navigateur, application mobile, etc.). Consultez le guide de sécurité pour connaître les bonnes pratiques de gestion des clés API.

Sécuriser votre clé API

Veillez à sécuriser votre clé API pour la protéger contre tout accès non autorisé.

• Définissez une restriction d'application pour votre clé API (par exemple, sites Web, adresses IP, applications Android ou applications iOS).
• Définissez des restrictions d'API pour votre clé API.

Pour en savoir plus, consultez les conseils de sécurité de Google Maps Platform.

Pour l'API Maps JavaScript, l'API Maps Static et l'API Street View Static, vous pouvez migrer les URL de provenance approuvées de votre ID client vers les restrictions de la clé API. Vous trouverez la liste des URL de provenance approuvées dans la console Cloud.

Vérifier les paramètres de quota

Assurez-vous que les paramètres de quota attendus sont définis dans votre projet Cloud. Vous n'avez besoin de le faire que si vous appelez les services côté client de l'API Maps JavaScript à partir d'un ID client. Vous pouvez vérifier et ajuster vos paramètres de quota sur la page Quotas Google Maps.

En savoir plus sur les rapports de quota

Augmentation du quota pour les services côté client de l'API Maps JavaScript

**Avertissement** : L'utilisation de l'ID client sur les services côté client de l'API Maps JavaScript ne consomme pas de quota de projet. Une fois que vous migrez vers une clé API, votre utilisation consommera le quota du projet. Vous devez vous assurer que vous disposez d'une marge de quota suffisante avant de migrer.

Si vous utilisez les services suivants sur l'API Maps JavaScript, vous constaterez une augmentation de l'utilisation du quota après la migration de la clé API.

Vérifiez votre configuration de quota actuelle, votre utilisation actuelle et ajustez vos limites de quota en conséquence.

1. Vérifiez si vous utilisez les services côté client de l'API Maps JavaScript avec un ID client.
   • Ouvrez la page Métriques dans la console Cloud.
   • Filtrez votre utilisation avec les paramètres suivants :
     • Groupé par : méthode API
     • Identifiants : sélectionnez uniquement "project_number:<identifiant numérique>".
   • Vous verrez ensuite une liste de noms de méthodes avec leur trafic dans le graphique "Trafic par méthode API".

Méthode API	Service côté client	Service pour ajuster le quota
google.routes.Directions.Javascript	Service Directions	API Directions
google.routes.DistanceMatrix.Javascript	Service Distance Matrix	API Distance Matrix
google.maps.Elevation.Javascript	Service Elevation	API Elevation
google.places.Geocoding.Javascript	Service Geocoding	API Geocoding
google.places.*.Javascript, autre que google.places.Geocoding.Javascript	Bibliothèque Places	API Places

• Si vous n'utilisez pas ces méthodes d'API, vous n'avez pas à vous soucier des paramètres de quota, car le trafic de votre ID client consomme déjà le quota de votre projet.
• Estimez l'utilisation du quota de votre ID client.
  • Pour chacun des services, vérifiez la granularité par seconde et par jour.
  • Graphique par seconde : multipliez le trafic de pointe par 60 pour obtenir les besoins supplémentaires en quota par minute.
  • Graphique par jour : le trafic de pointe doit correspondre aux besoins supplémentaires en quota par jour.
• Ajustez votre quota sur les services Maps Platform correspondants.
  • En fonction du nom de la méthode que vous trouverez à l'étape 1, ajustez le quota sur les services correspondants.

Mettre à jour votre code

Remplacer le paramètre client par le paramètre clé

Mettez à jour les identifiants d'authentification de URL&client={value} vers URL&key={value} dans vos appels sortants à l'API GMP. Si vos applications utilisent HTTP pour accéder aux services GMP, mettez-les à jour pour qu'elles utilisent HTTPS.

Mettre à jour le paramètre de canal pour les rapports

Vous pouvez suivre votre utilisation par canal en spécifiant le paramètre de canal dans vos requêtes API. Les clés API n'acceptent que les valeurs numériques pour le paramètre de canal. Si vous utilisez votre ID client avec des valeurs non numériques pour le paramètre de canal, remplacez-les par une valeur numérique acceptée.

Pour en savoir plus, consultez la section Rapports Google Maps Platform.

Supprimer le paramètre de signature pour les services Web

Pour les API de service Web suivantes, le paramètre de signature n'est pas nécessaire lorsque vous y accédez avec une clé API. Supprimez uniquement le paramètre de signature de vos requêtes API.

• API Directions (ancienne version)
• API Distance Matrix (ancienne version)
• API Geocoding
• API Elevation
• API Time Zone

Pour en savoir plus, consultez Présentation du forfait Premium.

Secret de signature pour les API d'imagerie

L'API Maps Static et l'API Street View Static nécessitent toujours le paramètre de signature. Elles acceptent un petit nombre de requêtes sans signature à des fins de test, mais elles commencent à échouer une fois le seuil atteint en production. Remplacez votre secret de signature par celui de l'ID client par celui de la clé API. Vous pouvez utiliser le même algorithme de signature, mais vous devez utiliser un autre secret de signature. Pour en savoir plus, consultez Utiliser une signature numérique.

**Avertissement** : Avant de déployer des modifications de code en production, vérifiez que la fonctionnalité de bout en bout n'a pas été affectée.

Surveiller le trafic de votre ID client

Après le déploiement, vérifiez que votre trafic a bien migré à l'aide des tableaux de bord de la console Cloud. Vous constaterez une diminution du trafic de votre ID client, qui s'affiche au format "project_number:123456" dans le tableau de bord lorsque vous regroupez par identifiant.

Mettre en veille votre ID client

Nous recommandons vivement aux développeurs de mettre en veille les ID client après la migration. Cela permet de protéger vos identifiants contre tout trafic involontaire et de confirmer que toute utilisation restante sur votre ID client n'est pas critique (par exemple, tests, caches, robots, etc.) et peut renvoyer des erreurs sans avoir d'impact sur l'activité. Vous pouvez mettre en veille votre ID client dans la console Cloud. Pour en savoir plus, consultez Forfait Premium : présentation de l'authentification.

Dépannage

Comment savoir si notre requête échoue ou non ?

Vous pouvez consulter vos statistiques d'erreur dans les graphiques de code de réponse

Erreur ApiNotActivatedMapError ou REQUEST_DENIED

L'erreur ApiNotActivatedMapError ou REQUEST_DENIED s'affiche si vous n'avez pas activé le service dans votre projet Cloud. Suivez les instructions pour activer le service.

Erreur RefererNotAllowedMapError

L'erreur RefererNotAllowedMapError s'affiche si votre domaine source n'est pas ajouté à votre clé API. Consultez la section "Sécuriser votre clé API" et ajoutez votre domaine à la clé API.

Erreur OverQuotaMapError ou OVER_QUERY_LIMIT

L'erreur OverQuotaMapError ou OVER_QUERY_LIMIT s'affiche si le quota configuré n'est pas suffisant pour couvrir votre trafic. Consultez la section "Vérifier les paramètres de quota" et ajustez votre quota en conséquence.

Erreur "Les requêtes adressées à cette API doivent être effectuées via SSL"

Si le message d'erreur suivant s'affiche, remplacez "http://" par "https://" dans vos requêtes API.

{
  "error_message" : "Requests to this API must be over SSL. Load the API with
  \"https://\" instead of \"http://\".",

  "results" : [],

  "status" : "REQUEST_DENIED"
}