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 Google Maps API. Ce guide vous explique comment passer des ID client aux clés API.
Pour commencer, procédez comme suit :
- Vérifier l'utilisation actuelle de l'ID client
- Préparer les clés API
- Vérifier les paramètres de quota
- Modifier votre code
- Surveiller le trafic de votre ID client
- 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é 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 :
- Ouvrez la page Métriques dans la console Cloud.
- Filtrez votre utilisation avec les paramètres suivants :
- Identifiants : sélectionnez uniquement "project_number:<identifiant numérique>".
- 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 :
- Ouvrez la page Métriques dans la console Cloud.
- Sélectionnez un service Maps Platform dans le menu déroulant.
- Filtrez votre utilisation avec les paramètres suivants :
- Identifiants : sélectionnez uniquement "project_number:<identifiant numérique>".
- Définissez le filtre suivant.
- Grouper par : plate-forme ou domaine
- Répétez l'opération à partir de 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.
- Trouvez le projet Cloud auquel votre ID client est associé :
- Assurez-vous que votre projet Cloud est associé à un compte de facturation ouvert.
- Créez une clé API pour la migration de l'ID client.
- Vous pouvez réutiliser les clés API existantes dans le 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.). Pour connaître les bonnes pratiques de gestion des clés API, consultez le guide de sécurité.
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é pour Google Maps Platform.
Pour les API Maps JavaScript, Maps Static et Street View Static, vous pouvez migrer les URL de provenance de confiance de votre ID client vers les restrictions de clé API. Vous trouverez la liste des domaines de provenance fiables 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 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 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.
- 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 :
- Regroupé par : méthode API
- Identifiants : sélectionnez uniquement "project_number:<identifiant numérique>".
- Vous verrez ensuite une liste des noms de méthodes avec leur trafic dans le graphique "Trafic par méthode d'API".
Méthode API |
Service côté client |
Service pour lequel 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.
- 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 obtenir le quota par minute supplémentaire nécessaire.
- 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 avez trouvé à 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 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 des valeurs numériques compatibles.
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. Ne supprimez le paramètre de signature que 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.
Signature secrète 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 ils commencent à échouer une fois qu'ils atteignent le seuil 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. Il s'agit de protéger vos identifiants contre tout trafic involontaire et de confirmer que toute utilisation restante de votre ID client n'est pas critique (par exemple, tests, caches, robots, etc.) et peut renvoyer des erreurs sans avoir d'impact sur votre activité. Vous pouvez suspendre 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 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 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" et ajoutez votre domaine à la clé API.
Erreur OverQuotaMapError ou OVER_QUERY_LIMIT
Vous verrez le message 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"
}