Messages d'erreur

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Cette page décrit les messages d'erreur pouvant être renvoyés par 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 en filigrane plus sombre.

Clé API et erreurs de facturation

Dépannage

Dans certains cas, une carte plus sombre ou une image Street View négative avec le texte en "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 obtenir de l'aide sur la recherche de messages d'erreur, consultez la section Vérifier les erreurs dans votre 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 suivants répertorient les codes d'erreur possibles renvoyés par l'API Maps JavaScript, ainsi qu'une description de la cause et de la façon de résoudre le problème. Pour savoir comment trouver les messages d'erreur, consultez la section Vérifier les erreurs dans votre navigateur.

Erreurs de chargement de la carte

Si vous rencontrez une erreur lors du chargement de l'API Maps JavaScript, consultez le tableau ci-dessous pour obtenir des explications sur les codes d'erreur.

Code d'erreur Message Description
NotLoadingAPIFromGoogleMapsError L'API Maps JavaScript doit être téléchargée directement à partir des serveurs 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 depuis https://maps.googleapis.com.

Consultez Charger l'API Maps JavaScript.

TOSViolationMapError This website appears to violate the Google Maps API Terms of Service. The Google Maps API has been disabled for this website.

Votre application a été bloquée, car elle ne respectait pas les conditions d'utilisation de Google Maps Platform suite à plusieurs notifications par e-mail. Pour faire appel du blocage et faire examiner votre mise en œuvre, veuillez remplir ce formulaire. Vous recevrez une réponse par e-mail sous quelques jours ouvrables.

Si vous possédez une licence du forfait Premium Google Maps Platform, veuillez utiliser vos identifiants de forfait Premium Google Maps Platform pour résoudre cette erreur. Consultez le guide sur l'authentification via le forfait Premium.

UnauthorizedURLForClientIdMapError This URL is not authorized to use the Google Maps Client ID provided.

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 l'adresse de chargement actuelle de 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 les codes 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 elle ne fonctionnera pas sur cette page. Un avertissement est un message supplémentaire concernant le chargement de l'API Maps JavaScript. Cet avertissement décrit les raisons possibles d'une erreur ou suggère des problèmes potentiels dans le code qui charge l'API Maps JavaScript. Si vous ne recevez que des avertissements sans erreur, l'API fonctionnera correctement sur cette page. Toutefois, nous vous recommandons de résoudre également ces problèmes potentiels.

Code d'erreur de développeur Type Description
ApiNotActivatedMapError Error

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 Google Cloud Console.

Pour activer l'API Maps JavaScript pour votre projet, cliquez sur le bouton ci-dessous.
En savoir plus

ApiTargetBlockedMapError Error

Cette clé API n'est pas autorisée à utiliser ce service ou cette API. Veuillez vérifier les paramètres des restrictions d'API de votre clé API dans Google Cloud Console pour vous assurer que toutes les API et tous les services que vous avez besoin d'utiliser sont correctement spécifiés dans la liste des API activées.

Consultez la section Clés API dans Cloud Console. Pour plus d'informations, consultez les bonnes pratiques concernant la sécurité des API.

DeletedApiProjectMapError Error

Votre projet d'API a peut-être été supprimé de Cloud Console. Veuillez vérifier le projet pour lequel vous avez généré la clé API incluse dans le chargeur d'API JavaScript. Vous pouvez créer un projet d'API et obtenir une nouvelle clé dans Cloud Console.

Pour créer un projet et obtenir une clé API pour celui-ci, cliquez sur le bouton ci-dessous.
En savoir plus

ClientBillingNotEnabledMapError Error

Vous n'avez pas activé la facturation pour votre projet. Vous devez activer la facturation sur le projet Google Cloud associé à cet ID client (cliquez ici).

BillingNotEnabledMapError Error

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 Error

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. Vous pouvez recevoir cette erreur après avoir créé une clé API si vous essayez d'utiliser la clé avant qu'elle ne soit reconnue par le système. Attendez quelques minutes, puis réessayez. Vous devrez peut-être générer une nouvelle clé API dans Cloud Console.

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

InvalidClientIdMapError Error

L'ID client inclus dans l'élément de script qui charge l'API n'est pas valide ou a expiré. Veuillez vous assurer que vous utilisez correctement votre ID client. L'ID client doit commencer par le préfixe "&gt". Si vous rencontrez cette erreur même si vous utilisez correctement votre ID client, il est possible qu'il ait expiré. Contactez votre gestionnaire de compte Google.

Si vous ne disposez pas d'un forfait Premium ou 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 Error

La clé API incluse dans l'élément de script qui charge l'API est introuvable. Veillez à utiliser une clé d'API correcte. Vous pouvez générer une nouvelle clé API dans Cloud Console.

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

MalformedCredentialsMapError Error

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 Error

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 êtes client Premium Plan, vous devez utiliser un paramètre client avec votre ID client ou 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 avertir le propriétaire, si possible.

ProjectDeniedMapError Error

La requête n'a pas abouti. Vous trouverez peut-être plus de détails sur l'erreur dans Cloud Console.

Consultez Cloud Console.

RefererDeniedMapError Error

Votre application a été bloquée, car elle ne respectait pas les conditions d'utilisation de Google Maps Platform suite à plusieurs notifications par e-mail. Pour faire appel du blocage et faire examiner votre mise en œuvre, veuillez remplir ce formulaire. Vous recevrez une réponse par e-mail sous quelques jours ouvrables.

RefererNotAllowedMapError Error

L'URL qui charge actuellement l'API Maps JavaScript n'a pas été ajoutée à la liste des URL de provenance autorisées. Veuillez vérifier les paramètres de votre clé API dans Cloud Console.

Consultez l'API Maps JavaScript et obtenez une clé API.

OverQuotaMapError Error

Le nombre de requêtes a dépassé les limites d'utilisation pour l'API Maps JavaScript. Les requêtes de votre application fonctionneront à nouveau lors de la prochaine réinitialisation du quota quotidien.

Si vous n'êtes PAS le propriétaire du site Web, vous ne pouvez pas corriger cette erreur. Toutefois, vous pouvez en avertir le propriétaire du site, si possible.

Pour en savoir plus, consultez le guide sur les limites d'utilisation. Elle explique également comment obtenir des limites d'utilisation plus élevées.

ApiProjectMapError Error

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 cré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'une licence correspondant au forfait Premium ou aux API Google Maps for Work, veuillez spécifier votre ID client en tant que 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'une licence correspondant au forfait Premium ou aux API Google Maps for Work, veuillez spécifier votre ID client en tant que 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 du 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. Le canal doit être une chaîne alphanumérique ASCII qui peut contenir des points (.), des traits de soulignement (_) et des traits d'union (-). Veuillez vous assurer de 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. L'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é d'API correcte. Vous pouvez générer une nouvelle clé API dans Cloud Console.

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 la section Gestion des versions | API Google Maps JavaScript.

KeyLooksLikeClientId Avertissement Vous avez peut-être fourni un ID client en tant que paramètre key. Si vous disposez d'un forfait Premium ou d'API Google Maps for Work, veuillez spécifier votre ID client en tant que paramètre client au lieu du paramètre 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 du paramètre client .

Consultez le guide sur l'authentification via le forfait Premium.

KeyLooksLikeCryptoKey Avertissement

Vous avez peut-être fourni une clé cryptographique ou un secret de signature en tant que paramètre key. Si vous disposez d'une licence correspondant au forfait Premium ou aux API Google Maps for Work, veuillez spécifier votre ID client en tant que paramètre client et supprimer 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 Cloud Console.

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é d'API correcte. Vous pouvez générer une nouvelle clé API dans Cloud Console.

Découvrez comment obtenir une clé API.

NoApiKeys Avertissement

L'élément de script qui charge l'API ne possède pas de clé d'API. Assurez-vous d'inclure une clé API valide en tant que paramètre key. Vous pouvez générer une nouvelle clé API dans Cloud Console.

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

Si vous chargez l'API Maps JavaScript à partir du chemin obsolète v2, 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 version 2 à la version 3 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 la section Gestion des versions | API Google Maps JavaScript.

SensorNotRequired Avertissement

Le paramètre sensor n'est plus nécessaire pour l'API Maps JavaScript. Elle n'empêchera 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 nécessaire pour l'API Maps JavaScript. Elle n'empêche pas l'API Maps JavaScript de fonctionner correctement, mais elle peut présenter des risques 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. Cela n'empêchera pas l'API Maps JavaScript de fonctionner, mais le comportement de votre application pourra changer si vous utilisez des fonctionnalités de connexion.

UrlAuthenticationCommonError Error

Une erreur s'est produite. Celle-ci ne correspond pas aux autres catégories de cette page. Elle peut être due à un problème temporaire. Veuillez réessayer dans un court délai. Si le problème persiste, veuillez consulter le guide du développeur pour vous assurer que le format de la requête est correct.

Vérification des erreurs dans le navigateur

L'API Maps JavaScript écrit les messages d'erreur dans window.console. Cette section explique comment vérifier la sortie window.console dans Google Chrome. Si vous utilisez un autre navigateur, reportez-vous à sa documentation pour les développeurs. Pour référence, voici une liste d'outils permettant de vérifier la sortie window.console dans d'autres navigateurs.

Dans Chrome, vous pouvez utiliser la console JavaScript pour vérifier la sortie window.console comme suit.

  1. Pour ouvrir les outils de développement, sélectionnez l'icône de menu &gt ; Plus d'outils &gt ; Outils de développement.
  2. Pour ouvrir la console JavaScript, appuyez sur la touche ECHAP du clavier. La touche ECHAP active la console JavaScript. Si vous fermez la console, appuyez de nouveau sur la touche Échap pour l'ouvrir.

Si des erreurs ou des avertissements se sont produits lors du chargement de l'API Maps JavaScript, ils apparaissent sous la forme d'une ou de 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]
ou
Google Maps API warning: [ERROR CODE] [Link to API document]

Vous pouvez consulter le tableau des codes d'erreur ci-dessus pour trouver le code d'erreur dans le message d'erreur. Vous trouverez également les détails du message d'erreur dans le document d'API accessible via le lien du message.

Remarque:Vous pouvez écouter les erreurs d'authentification de manière automatisée.

Gérer les navigateurs non compatibles

Assurez-vous que la version du navigateur que vous utilisez est actuellement compatible avec l'API Maps JavaScript.

Si votre code ne fonctionne toujours pas

Pour vous aider à configurer votre code de carte, 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. JavaScript est un langage sensible à la casse.
  • Vérifiez les principes de base. Certains des problèmes les plus courants surviennent lors de la création initiale de la carte. Exemples :
    • Vérifiez que vous avez spécifié les propriétés zoom et center dans vos options de carte.
    • Assurez-vous d'avoir déclaré un élément div dans lequel la carte apparaîtra à 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.
    Consultez nos exemples de mise en œuvre 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. Les consignes pour publier des questions pertinentes sont disponibles sur la page Assistance.