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 peuvent 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 de l'utilisation d'ID client à l'utilisation de clés API.

Pour commencer, procédez comme suit :

1. Vérifier l'utilisation actuelle de l'ID client
2. Préparer des clés API
3. Vérifier les paramètres de quota
4. Modifier votre code
5. Surveiller le trafic de votre ID client
6. Suspendre votre ID client

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

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

• Services Maps Platform que vous utilisez avec votre ID client
• Applications, sites ou systèmes avec lesquels vous utilisez votre ID client

Google a envoyé une notification par e-mail aux clients concernés concernant l'abandon de l'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 Cloud Console.
2. Filtrez votre utilisation à l'aide des paramètres suivants :
   • Identifiants: sélectionnez "project_number:<identifiant numérique>" uniquement.
3. Définissez le filtre suivant.
   • Regroupé par: API

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

Cloud Console n'affiche pas les détails de vos applications, sites ou systèmes. Vous pouvez toutefois trouver des indices sur les sources de votre trafic associé à l'ID client. Procédez comme suit :

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

Préparer des clés API

Tous les ID client sont associés à un projet Google Cloud. L'utilisation d'une clé API de ce projet vous permet d'accéder aux mêmes fonctionnalités que celles auxquelles vous aviez accès avec votre ID client. Nous vous recommandons de migrer vers le projet associé pour éviter les problèmes liés aux quotas ou aux 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 clé API pour la migration des ID client.
   • Vous pouvez réutiliser toutes les clés API existantes du projet Cloud.
   • Vous pouvez utiliser plusieurs clés API à partir 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 découvrir 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 (sites Web, adresses IP, applications Android ou applications iOS, par exemple).
• Définissez des restrictions d'API pour votre clé API.

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

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

Vérifier les paramètres de quota

Assurez-vous que les paramètres de quota attendus sont définis sur votre projet Cloud. Vous ne devez le faire que si vous appelez les services côté client de l'API Maps JavaScript à partir d'un ID client. Vous pouvez consulter et ajuster vos paramètres de quota sur la page des quotas Google Maps.

En savoir plus sur les rapports sur les quotas

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

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

Examinez votre configuration et votre utilisation actuelles des quotas, puis ajustez vos limites de quota en conséquence.

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

• 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.
• Estimer l'utilisation de votre quota d'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 connaître les besoins supplémentaires en quota par minute.
  • Graphique "Par jour" : le pic de trafic doit correspondre aux besoins de quota supplémentaires 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

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

Supprimer le paramètre de signature pour les services Web

Pour les API de services Web (*), le paramètre de signature n'est pas nécessaire lorsque vous y accédez avec une clé API. Ne supprimez que le paramètre de signature de vos requêtes d'API.

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

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

Secret de signature pour les API d'images

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 que le seuil est atteint dans votre production. Remplacez votre secret de signature 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 la section Utiliser une signature numérique.

Surveiller le trafic de votre ID client

Après le déploiement, vérifiez que votre trafic a bien été 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 les données par identifiant.

Suspendre votre ID client

Nous recommandons vivement aux développeurs de suspendre les ID client après la migration. Il sert à protéger vos identifiants contre tout trafic involontaire et à confirmer que toute utilisation restante de votre ID client n'est pas critique (tests, caches, bots, etc.) et peut renvoyer des erreurs sans avoir d'impact sur l'activité. Vous pouvez suspendre votre ID client dans la console Cloud. Pour en savoir plus, consultez la section Présentation de l'authentification via le forfait Premium.

Dépannage

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

Vous pouvez consulter vos statistiques d'erreur dans les graphiques des codes 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.

RefererNotAllowedMapError erreur

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

Erreur OverQuotaMapError ou OVER_QUERY_LIMIT

Le OverQuotaMapError ou le 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 à 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"
}