Codes d'erreur API Google Maps : guide de dépannage complet
Quand votre carte Google ne se charge pas, la console du navigateur contient un code d'erreur qui vous dit exactement ce qui ne va pas. Ce guide couvre chaque erreur courante, sa cause et la solution.
ApiNotActivatedMapError
Cause : Une ou plusieurs API requises ne sont pas activées sur votre projet Google Cloud.
Solution : Cliquez sur ce lien pour activer les quatre API requises d'un coup : Activer les API. Assurez-vous de sélectionner le bon projet.
InvalidKeyMapError
Cause : La clé API fournie n'est pas valide. Elle peut être mal orthographiée, supprimée ou appartenir à un autre projet.
Solution : Allez dans Console Google Cloud → Credentials et vérifiez que votre clé existe. Copiez-la à nouveau et collez-la dans WP Google Street View → Settings.
RefererNotAllowedMapError
Cause : Votre clé API a des restrictions de référent HTTP et votre domaine n'est pas dans la liste autorisée.
Solution : Modifiez votre clé API dans la Console Cloud. Sous Application restrictions → HTTP referrers, ajoutez :
https://votredomaine.com/*
https://www.votredomaine.com/*Les changements prennent jusqu'à 5 minutes pour se propager.
MissingKeyMapError
Cause : Aucune clé API n'a été fournie dans la requête.
Solution : Allez dans WP Google Street View → Settings et entrez votre clé API. Si le champ est déjà rempli, la clé peut ne pas se sauvegarder correctement — vérifiez qu'il n'y a pas d'espaces en fin de chaîne.
Filigrane « For development purposes only »
Cause : La facturation n'est pas activée sur le projet, ou l'essai gratuit a expiré sans compte de facturation associé.
Solution : Activez la facturation. Google offre 200 $/mois en crédits gratuits, donc vous ne paierez probablement rien.
OverQueryLimitMapError
Cause : Vous avez dépassé votre quota API Google Maps pour la période en cours.
Solution : Vérifiez votre utilisation dans Console Cloud → APIs & Services → Dashboard. Pour la plupart des sites, cette erreur signifie que la facturation n'est pas activée (Google traite ça comme un quota de 0 $).
Carte grise ou vide
Cause : Causes multiples possibles : clé invalide, API manquante, conflit JavaScript avec un plugin de cache, ou facturation absente.
Solution : Ouvrez les outils de développement de votre navigateur (F12), allez dans l'onglet Console et cherchez l'un des codes d'erreur ci-dessus. Corrigez l'erreur spécifique rapportée.
La carte se charge dans l'admin mais pas côté visiteur
Cause : Un plugin de cache ou d'optimisation JavaScript interfère.
Solution : Excluez maps.googleapis.com de la minification et du report JS. Voir notre guide de compatibilité cache.
L'erreur persiste après la correction
Si vous avez corrigé la configuration mais que l'erreur persiste :
- Videz tous les caches (navigateur, plugin de cache WordPress, CDN)
- Attendez 5 minutes (les changements de restrictions de clé ne sont pas instantanés)
- Testez dans une fenêtre de navigation privée
- Vérifiez à nouveau la console du navigateur pour une erreur différente