Cette page décrit les messages d'erreur que peut renvoyer l'API Maps JavaScript. L'API Maps JavaScript écrit des messages d'erreur et d'avertissement dans la console JavaScript. Certaines conditions d'erreur peuvent également se produire, ce qui entraîne l'affichage d'une carte à filigrane plus sombre.
Clé API et erreurs de facturation
Dépannage
Dans certains cas, une carte plus sombre ou une image "négative" Street View, portant le filigrane "à des fins de développement uniquement", peut s'afficher. Cela indique généralement des problèmes liés à une clé API ou à la facturation. Pour que vous puissiez utiliser les produits Google Maps Platform, la facturation doit être activée sur votre compte, et toutes les requêtes doivent inclure une clé API valide. Pour savoir comment identifier les messages d'erreur, consultez la section sur la vérification des erreurs dans le navigateur.
La procédure suivante vous aidera à résoudre le problème.
Codes d'erreur de l'API Maps JavaScript pour les développeurs et les propriétaires de site
Les tableaux ci-dessous répertorient les codes d'erreur que peut renvoyer l'API Maps JavaScript, en décrivent les causes et expliquent comment y remédier. Pour savoir comment identifier les messages d'erreur, consultez la section sur la vérification des erreurs dans le navigateur.
Erreurs de chargement de carte
Si vous recevez un message d'erreur lorsque vous chargez l'API Maps JavaScript, consultez le tableau ci-dessous pour obtenir les explications sur le code d'erreur indiqué.
Code d'erreur | Message | Description |
---|---|---|
NotLoadingAPIFromGoogleMapsError
|
L'API Maps JavaScript doit être téléchargée directement des serveurs de Google. |
L'élément de script qui charge l'API Maps JavaScript n'est pas inclus correctement sur votre page. Pour que l'API fonctionne correctement, elle doit être chargée directement à partir du site https://maps.googleapis.com. Consultez Charger l'API Maps JavaScript. |
TOSViolationMapError
|
Il semble que ce site Web ne respecte pas les conditions d'utilisation de l'API Google Maps. L'API Google Maps a été désactivée sur ce site Web. |
Votre application a été bloquée pour non-respect des Conditions d'utilisation de Google Maps Platform, après plusieurs e-mails de notification. Pour envoyer une demande de déblocage et de révision de votre implémentation, remplissez ce formulaire. Vous recevrez une réponse par e-mail sous quelques jours ouvrés. Si vous possédez une licence Forfait Premium Google Maps Platform, veuillez utiliser les identifiants associés pour résoudre cette erreur. Consultez le guide sur l'authentification via le Forfait Premium. |
UnauthorizedURLForClientIdMapError
|
Cette URL n'est pas autorisée à utiliser l'ID client Google Maps fourni. |
L'ID client du Forfait Premium ou de l'API Google Maps for Work inclus dans le chargement du script n'est pas valide ou a expiré, ou bien l'adresse actuellement utilisée pour charger l'API Maps JavaScript n'a pas été ajoutée à la liste des URL autorisées. Consultez la section Enregistrer des URL autorisées. |
Codes d'erreur de l'API Maps JavaScript
Si vous rencontrez une erreur dans la console JavaScript Chrome, la console Web Firefox ou d'autres outils équivalents dans votre navigateur, consultez le tableau ci-dessous pour obtenir des explications sur chaque code d'erreur.
L'API Maps JavaScript renvoie à la fois des erreurs et des avertissements. Une erreur indique un problème grave survenu lors du chargement de l'API Maps JavaScript. Votre page ne peut pas charger l'API correctement et l'API ne fonctionnera pas sur cette page. Un avertissement est un message supplémentaire concernant le chargement de l'API Maps JavaScript. Il décrit les raisons possibles d'une erreur ou suggère des problèmes potentiels dans le code utilisé pour charger l'API Maps JavaScript. Si vous n'obtenez que des avertissements (sans aucune erreur), l'API fonctionnera correctement sur la page. Toutefois, nous vous recommandons d'également résoudre ces problèmes potentiels.
Code d'erreur de développeur | Type | Description |
---|---|---|
ApiNotActivatedMapError
|
Erreur |
L'API Maps JavaScript n'est pas activée dans votre projet d'API. Vous devrez peut-être activer l'API Maps JavaScript sous "API" dans la console Google Cloud. Pour activer l'API Maps JavaScript pour votre projet, cliquez sur le bouton ci-dessous.
|
ApiTargetBlockedMapError
|
Erreur |
Cette clé API n'est pas autorisée à utiliser ce service ou cette API. Veuillez vérifier les paramètres des restrictions d'API pour votre clé API dans la console Google Cloud afin de vous assurer que tous les services et API nécessaires sont correctement spécifiés dans la liste des API activées. Consultez Clés API dans la console Cloud. Pour en savoir plus, consultez les bonnes pratiques concernant les clés API. |
DeletedApiProjectMapError
|
Erreur |
Votre projet d'API a peut-être été supprimé de la console Cloud. Vérifiez pour quel projet vous avez généré la clé API incluse dans JavaScript API Loader. Vous pouvez créer un projet d'API et obtenir une nouvelle clé dans la console Cloud. Pour créer un projet et obtenir une clé API pour celui-ci, cliquez sur le bouton ci-dessous.
|
ClientBillingNotEnabledMapError
|
Erreur |
Vous n'avez pas activé la facturation pour votre projet. Vous devez activer la facturation sur le projet Google Cloud associé à cet ID client en cliquant ici. |
BillingNotEnabledMapError
|
Erreur |
Vous n'avez pas activé la facturation sur votre projet, ce qui génère cette erreur. Vous devez activer la facturation sur le projet Google Cloud en cliquant ici. |
ExpiredKeyMapError
|
Erreur |
La clé API incluse dans l'élément de script qui charge l'API a expiré ou n'est pas reconnue par le système. Cette erreur peut se produire après avoir créé une clé API si vous essayez d'utiliser la clé avant qu'elle ne soit reconnue par le système. Patientez quelques minutes, puis réessayez. Vous devrez peut-être générer une nouvelle clé API dans la console Cloud. Pour obtenir une clé API, cliquez sur le bouton ci-dessous.
|
InvalidAppCheckTokenMapError
|
Erreur |
Le jeton App Check fourni n'est pas valide ou a expiré. Cette erreur ne peut se produire que si la validation App Check est utilisée. Consultez le guide sur la vérification App Check. |
InvalidClientIdMapError
|
Erreur |
L'ID client inclus dans l'élément de script qui charge l'API n'est pas valide ou a expiré. Veillez à utiliser correctement votre ID client. L'ID client doit commencer par le préfixe "gme-". Si cette erreur s'affiche alors que vous utilisez votre ID client correctement, l'ID client a peut-être expiré. Contactez votre responsable de compte Google.
Si vous ne disposez pas d'un Forfait Premium ou d'une licence d'API Google Maps for Work, vous devez utiliser un paramètre Consultez le guide sur l'authentification via le Forfait Premium. |
InvalidKeyMapError
|
Erreur |
La clé API incluse dans l'élément de script qui charge l'API est introuvable. Veillez à utiliser une clé API correcte. Vous pouvez générer une nouvelle clé API dans la console Cloud. Pour obtenir une clé API, cliquez sur le bouton ci-dessous.
|
MalformedCredentialsMapError
|
Erreur |
Votre application utilise un schéma d'URI non compatible. Vérifiez que l'application utilise un format d'URI valide, tel que défini dans la RFC 3986. |
MissingKeyMapError
|
Erreur |
Il manque le paramètre d'authentification requis pour l'élément de script qui charge l'API. Si vous utilisez l'API Maps JavaScript standard, vous devez utiliser un paramètre Si vous avez souscrit un Forfait Premium, vous devez utiliser soit un paramètre Si vous n'êtes PAS le propriétaire du site Web, vous ne pouvez pas corriger cette erreur. Toutefois, nous vous conseillons d'en informer le propriétaire, si possible. |
ProjectDeniedMapError
|
Erreur |
La requête n'a pas abouti. Vous trouverez peut-être plus d'informations sur l'erreur dans la console Cloud. Consultez console Cloud. |
RefererDeniedMapError
|
Erreur |
Votre application a été bloquée pour non-respect des Conditions d'utilisation de Google Maps Platform, après plusieurs e-mails de notification. Pour envoyer une demande de déblocage et de révision de votre implémentation, remplissez ce formulaire. Vous recevrez une réponse par e-mail sous quelques jours ouvrés. |
RefererNotAllowedMapError
|
Erreur |
L'URL qui charge actuellement l'API Maps JavaScript n'a pas été ajoutée à la liste des URL de provenance autorisées. Vérifiez les paramètres d'URL de provenance de votre clé API dans la console Cloud. Consultez l'API Maps JavaScript et obtenez une clé API. |
OverQuotaMapError
|
Erreur |
Le nombre de requêtes a dépassé les limites d'utilisation de l'API Maps JavaScript. Les requêtes de votre application fonctionneront de nouveau à la prochaine réinitialisation du quota journalier. Si vous n'êtes PAS le propriétaire du site Web, vous ne pouvez pas corriger cette erreur. Toutefois, nous vous conseillons d'en informer le propriétaire, si possible. Pour en savoir plus, consultez le guide sur les limites d'utilisation. Cette page explique également comment accroître vos limites d'utilisation. |
ApiProjectMapError
|
Erreur |
Impossible de résoudre la clé API fournie ou le projet d'API auquel elle est associée. Cette erreur peut être temporaire. Si ce message d'erreur persiste, vous devrez peut-être obtenir une nouvelle clé API ou recréer un projet d'API. Pour en savoir plus, consultez Premiers pas avec Google Maps Platform. |
ClientIdLooksLikeCryptoKey
|
Avertissement |
Vous avez peut-être fourni une clé cryptographique dans le paramètre Consultez le guide sur les ID client pour le Forfait Premium et l'API Google Maps for Work. |
ClientIdLooksLikeKey
|
Avertissement |
Vous avez peut-être fourni une clé API dans le paramètre Consultez le guide sur l'authentification via le Forfait Premium. |
InvalidChannel
|
Avertissement |
Vous avez peut-être spécifié un paramètre |
InvalidClientId
|
Avertissement |
Le paramètre Consultez le guide sur l'authentification via le Forfait Premium. |
InvalidKey
|
Avertissement |
La clé API incluse dans l'élément de script qui charge l'API semble incorrecte. Veillez à utiliser une clé API correcte. Vous pouvez générer une nouvelle clé API dans la console Cloud. Pour obtenir une clé API, cliquez sur le bouton ci-dessous.
|
InvalidVersion
|
Avertissement |
Vous avez peut-être spécifié un numéro de version incorrect dans l'élément de script. Veillez à utiliser un numéro de version correct. Consultez Gestion des versions | API Google Maps JavaScript. |
KeyLooksLikeClientId
|
Avertissement |
Vous avez peut-être spécifié un ID client comme paramètre key . Si vous disposez d'une license correspondant au Forfait Premium ou aux API Google Maps for Work, spécifiez votre ID client comme paramètre client plutôt que key . Si vous disposez d'un Forfait Premium Google Maps Platform, vous pouvez utiliser un paramètre client ou key . Si vous ne disposez d'aucune licence, vous devez utiliser un paramètre key au lieu d'un paramètre client
.
Consultez le guide sur l'authentification via le Forfait Premium. |
KeyLooksLikeCryptoKey
|
Avertissement |
Vous avez peut-être fourni une clé cryptographique ou une signature secrète en tant que paramètre Consultez le guide Spécifier un ID client lors du chargement de l'API. |
KeyLooksLikeProjectNumber
|
Avertissement |
Vous avez peut-être fourni un numéro de projet en tant que paramètre Découvrez comment obtenir une clé API. |
NoApiKeys
|
Avertissement |
L'élément de script qui charge l'API ne possède pas de clé API. Veillez à inclure une clé API valide en tant que paramètre
Pour obtenir une clé API, cliquez sur le bouton ci-dessous.
Si vous chargez l'API Maps JavaScript à partir du chemin v2 obsolète, vous recevrez l'avertissement |
RetiredVersion
|
Avertissement |
Vous avez peut-être spécifié une version obsolète de l'élément de script. Mettez l'application à jour pour utiliser l'une des versions disponibles. Consultez Gestion des versions | API Google Maps JavaScript. |
SensorNotRequired
|
Avertissement |
Le paramètre |
SignatureNotRequired
|
Avertissement |
Le paramètre |
SignedInNotSupported
|
Avertissement |
Le paramètre |
UrlAuthenticationCommonError
|
Erreur |
Il s'est produit une erreur qui ne correspond à aucune autre catégorie de cette page. Elle peut être due à un problème temporaire. Relancez la requête après un court délai. Si le problème persiste, consultez le guide du développeur pour vérifier que le format de la requête est correct. |
Vérification des erreurs dans le navigateur
L'API Maps JavaScript affiche des messages d'erreur via window.console
. Cette section explique comment consulter le résultat window.console
dans Google Chrome. Si vous utilisez un autre navigateur, consultez la documentation pour les développeurs correspondant à votre navigateur. Pour référence, les outils suivants permettent de consulter le résultat window.console
dans d'autres navigateurs.
- Console Web pour Firefox
- Débogage à distance pour Android
- Inspecteur Web pour iOS
Pour consulter le résultat window.console
dans Chrome, utilisez la console JavaScript comme suit.
- Pour ouvrir les outils de développeur, sélectionnez l'icône de menu > More Tools > Developer Tools.
- Pour ouvrir la console JavaScript, appuyez sur la touche ÉCHAP du clavier. La touche ÉCHAP active la console JavaScript. Si vous fermez la console, appuyez de nouveau sur la touche ÉCHAP pour la rouvrir.
Si des erreurs ou des avertissements se produisent lors du chargement de l'API Maps JavaScript, ils s'affichent sous la forme d'une ou plusieurs lignes dans la console. Le format des messages d'erreur et d'avertissement est le suivant :
Google Maps API error: [ERROR CODE] [Link to API document]
or
Google Maps API warning: [ERROR CODE] [Link to API document]
Consultez le tableau des codes d'erreur ci-dessus pour identifier le code d'erreur fourni dans le message d'erreur. Pour plus de détails sur le message d'erreur, cliquez sur le lien vers la documentation d'API fournie dans le message.
Remarque : Vous pouvez écouter les erreurs d'authentification programmatiquement.
Gérer les navigateurs non compatibles
Vérifiez que la version du navigateur que vous utilisez est actuellement compatible avec l'API Maps JavaScript.
Si vous développez une application Windows native qui s'exécute dans une WebView, assurez-vous d'utiliser WebView2, basée sur Edge. Les versions précédentes de WebView, basées sur Internet Explorer, ne sont plus compatibles.
Si votre code ne fonctionne toujours pas
Pour vous aider à configurer votre code Maps, Brendan Kenny et Mano Marks vous présentent dans cette vidéo quelques-unes des erreurs les plus courantes et la façon de les corriger.
- Vérifiez qu'il ne contient pas de fautes de frappe. Rappelez-vous que le langage JavaScript est sensible à la casse.
- Vérifiez les bases. Certains des problèmes les plus courants surviennent en effet lors de la création initiale de la carte. Par exemple :
- Vérifiez que vous avez spécifié les propriétés
zoom
etcenter
dans les options de votre carte. - Assurez-vous d'avoir déclaré un élément div dans lequel la carte s'affichera à l'écran.
- Assurez-vous d'avoir défini une hauteur dans l'élément div pour la carte. Par défaut, les éléments div sont créés avec une hauteur de 0 et sont donc invisibles.
- Vérifiez que vous avez spécifié les propriétés
- Utilisez un débogueur JavaScript pour identifier les problèmes, par exemple celui disponible dans les outils pour les développeurs Chrome. Commencez par rechercher d'éventuelles erreurs dans la console JavaScript.
- Posez vos questions sur Stack Overflow. Pour savoir comment poser des questions de qualité, consultez la page d'assistance.