Guide de migration des ID client

Présentation

Pour commencer, procédez comme suit :

1. Vérifier l'utilisation actuelle de l'ID client
2. Préparer les 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
7. Réactivation temporaire en libre-service de l'ID client

Vérifier l'utilisation actuelle des 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é un e-mail de notification aux clients concernés concernant l'abandon des ID client en mai 2025. Vous trouverez également ces informations dans l'e-mail de notification.

Dans la console Cloud, vous pouvez consulter le dernier état 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.
   • Regroupé par : API

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

La console Cloud n'affiche pas les détails de vos applications, sites ni systèmes. Toutefois, vous pouvez trouver des indices 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 de 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 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 les accès non autorisés.

• 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é 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 de confiance de votre ID client vers les restrictions de clé API. Vous trouverez la liste des sites référents de confiance dans la console Cloud.

Examiner les paramètres de quota

Assurez-vous que les paramètres de quota de votre projet Cloud sont corrects. Cette opération n'est nécessaire 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 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 du quota après la migration de la clé API.

Examinez 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 :
     • Critère de regroupement : méthode API
     • Identifiants : sélectionnez uniquement "project_number:<identifiant numérique>".
   • Vous verrez alors une liste des 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 précision "par seconde" et "par jour".
  • Graphique "Par seconde" : multipliez le pic de trafic par 60 pour connaître les besoins supplémentaires en quota par minute.
  • Graphique "Par jour" : le pic de trafic 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} à 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.

Modifier 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 des valeurs numériques acceptées.

Pour en savoir plus, consultez Rapports Google Maps Platform.

Supprimer le paramètre de signature pour les services Web

Pour les API de services 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)
• API Geocoding
• API Elevation
• API Time Zone

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

Code secret de signature pour les API Imagery

Les API Maps Static et Street View Static nécessitent toujours le paramètre de signature. Ils acceptent un petit nombre de requêtes sans signature à des fins de test, mais commencent à échouer une fois le seuil atteint dans votre production. Remplacez le 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 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 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 l'utilisation restante de votre ID client n'est pas critique (par exemple, tests, caches, bots, etc.) et peut renvoyer des erreurs sans impact sur l'activité. Vous pouvez suspendre votre ID client dans la console Cloud. Pour en savoir plus, consultez Forfait Premium : présentation de l'authentification.

Réactivation temporaire en libre-service de l'ID client

Étant donné que les ID client Google Maps Platform sont entrés dans la période d'arrêt progressif en mai 2026, la disponibilité du service n'est plus assurée. L'accès sera périodiquement limité dans le cadre de la procédure d'arrêt planifié du service. Bien que le service soit généralement rétabli automatiquement en quelques heures, vous pouvez choisir de réactiver manuellement l'accès si une restauration immédiate est requise.

Pour restaurer l'accès de toute urgence, vous pouvez effectuer une réactivation en libre-service dans la console Google Cloud :

• Accédez à la page Identifiants Google Maps Platform.
• Localisez le projet Cloud associé à votre ID client.
• Cliquez sur l'icône de réactivation située tout à droite de l'entrée pour restaurer le service.

Si vous ne pouvez pas migrer rapidement vers les clés API et que vous souhaitez être temporairement exempté de toute autre interruption, veuillez contacter l'équipe d'assistance Google Maps Platform en fournissant les informations suivantes :

• ID client
• Cas d'utilisation spécifique
• Date de migration cible
• Évaluation de l'impact sur l'entreprise

Rapport sur l'utilisation des ID client (à partir des rapports sur la facturation)

Il peut être utile aux utilisateurs qui n'ont pas accès aux métriques de projet (par exemple, les administrateurs de la facturation, en particulier les partenaires Maps Platform) de consulter les rapports sur la facturation plutôt que les métriques de projet. Bien que les rapports sur la facturation aient une latence de un à deux jours, ils présentent l'avantage de montrer plus de 30 jours d'insights sur l'utilisation et les coûts.

Pour surveiller l'utilisation des ID client dans la console Google Cloud, procédez comme suit :

1. Accédez à la page Facturation > Rapports dans la console Google Cloud.
2. (Facultatif, pertinent uniquement pour les partenaires) Appliquez un filtre pour sélectionner le compte de sous-facturation souhaité.
3. Regroupez les données de rapport par clé d'étiquette goog-maps-api-key-suffix. Ce libellé affiche les derniers caractères d'une clé API.
4. Identifiez le trafic de l'ID client en recherchant les entrées où l'étiquette goog-maps-api-key-suffix est manquante ou vide, car cette étiquette n'est pas renseignée pour les requêtes d'ID client.
5. Ignorez les SKU qui ne sont pas censés être associés aux requêtes d'API (par exemple, les SKU d'abonnement).

Dépannage

Comment savoir si notre demande échoue ou non ?

Vous pouvez consulter vos statistiques d'erreurs 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 sur 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" et ajoutez votre domaine à la clé API.

Erreur OverQuotaMapError ou OVER_QUERY_LIMIT

Vous verrez OverQuotaMapError ou OVER_QUERY_LIMIT si le quota que vous avez 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"
}