Messages d'erreur

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.
En savoir plus

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.
En savoir plus

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.

En savoir plus

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.
Commencer

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 key avec votre clé API au lieu du paramètre client .

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.
Commencer

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 key avec une clé API valide. Pour en savoir plus, consultez Premiers pas avec Google Maps Platform.

Si vous avez souscrit un Forfait Premium, vous devez utiliser soit un paramètre client avec votre ID client, soit un paramètre key avec une clé API valide. Pour plus d'informations, consultez le guide sur les clés API et les ID client.

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 client. Si vous disposez d'un Forfait Premium ou d'une licence d'API Google Maps for Work, veuillez spécifier votre ID client comme paramètre client. Vous n'avez pas besoin d'utiliser votre clé cryptographique pour l'API Maps JavaScript.

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 client. Si vous disposez d'un Forfait Premium ou d'une licence d'API Google Maps for Work, veuillez spécifier votre ID client comme paramètre client. 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.

InvalidChannel Avertissement

Vous avez peut-être spécifié un paramètre channel non valide. La valeur de ce paramètre doit être une chaîne alphanumérique ASCII qui peut contenir des points (.), des traits de soulignement (_) et des traits d'union (-). Veillez à spécifier un paramètre channel valide.

Consultez Rapports | Forfait Premium Google Maps Platform.

InvalidClientId Avertissement

Le paramètre client ne semble pas contenir un ID client correct. Tout ID client doit commencer par "gme-".

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.
Commencer

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 key. Si vous disposez d'une licence correspondant au Forfait Premium ou aux API Google Maps for Work, spécifiez votre ID client comme paramètre client et supprimez le paramètre key de votre élément de script. La clé cryptographique n'est pas requise pour l'API Maps JavaScript. 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 pouvez obtenir une clé API dans la console Cloud.

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 key. Veillez à utiliser une clé API correcte. Vous pouvez générer une nouvelle clé API dans la console Cloud.

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 key. Vous pouvez générer une nouvelle clé API dans la console Cloud.

Pour obtenir une clé API, cliquez sur le bouton ci-dessous.
Commencer

Si vous chargez l'API Maps JavaScript à partir du chemin v2 obsolète, vous recevrez l'avertissement NoApiKeys, même si vous avez spécifié le paramètre key. Veuillez consulter le guide de mise à niveau de la v2 à la v3 et migrer votre application vers la version 3 de l'API Maps JavaScript.

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 sensor n'est plus nécessaire pour l'API Maps JavaScript. Il n'empêche pas l'API Maps JavaScript de fonctionner correctement, mais nous vous recommandons de supprimer le paramètre sensor de l'élément de script.

SignatureNotRequired Avertissement

Le paramètre signature n'est pas requis pour l'API Maps JavaScript. Il n'empêche pas l'API Maps JavaScript de fonctionner correctement, mais il peut représenter un risque de sécurité. Supprimez-le de l'élément de script.

SignedInNotSupported Avertissement

Le paramètre signed_in est obsolète et n'est pas compatible avec la version de l'API Maps JavaScript que vous utilisez. Il n'empêche pas l'API Maps JavaScript de fonctionner correctement, mais votre application changera peut-être de comportement si vous utilisez des fonctionnalités du mode avec connexion (signed-in).

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.

Pour consulter le résultat window.console dans Chrome, utilisez la console JavaScript comme suit.

  1. Pour ouvrir les outils de développeur, sélectionnez l'icône de menu > More Tools > Developer Tools.
  2. 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 et center 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.
    Reportez-vous à nos exemples, qui vous proposent une implémentation de référence.
  • 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.