Messages d'erreur

Cette page décrit les messages d'erreur pouvant être renvoyés par l'API Maps Embed. Lorsqu'une erreur se produit, l'API Maps Embed présente le texte du message d'erreur à la place de la carte. Certaines conditions d'erreur peuvent également se produire, ce qui entraîne l'affichage d'une carte en filigrane plus sombre.

Requêtes non valides

Dans le cas d'une requête non valide, l'API Maps Embed renvoie un code d'état HTTP 4xx et un message décrivant le problème. Vous trouverez ci-dessous quelques exemples de ces conditions d'erreur. Remarque: Cette liste d'erreurs n'est pas exhaustive. Veuillez vérifier le code d'erreur réel et le message renvoyé par l'API pour en savoir plus sur des problèmes spécifiques.

Exemple de condition d'erreur Code d'état
La requête inclut un paramètre non valide ou il manque un paramètre obligatoire. Par exemple, le paramètre zoom n'est pas compris dans la plage prévue de valeurs numériques, ou un paramètre obligatoire est manquant dans la requête. 400 BAD REQUEST
La clé d'API incluse dans la requête n'est pas valide. 403 FORBIDDEN

Clé API et erreurs de RPS

Les erreurs de clé API et de RPS sont traitées comme des requêtes non valides. Les causes possibles sont les suivantes:

Erreurs de facturation et de référent HTTP

Une carte sombre ou une image Street View négative avec un filigrane à des fins de développement uniquement est renvoyée lorsque l'une des conditions suivantes est remplie:

Vérifier les erreurs dans votre navigateur

Pour les erreurs de facturation et de provenance HTTP, l'API Maps Embed écrit des messages d'erreur dans window.console. Pour les requêtes non valides (y compris les erreurs liées à la clé API et au RPS), seul le code d'état HTTP 4xx est signalé dans la console. Cette section explique comment vérifier le résultat de la 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 le résultat de la console dans certains autres navigateurs.

Dans Chrome, vous pouvez utiliser la console JavaScript pour vérifier le résultat de la 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, cliquez sur l'onglet Console en haut de la fenêtre des outils pour les développeurs. Vous pouvez également utiliser la touche Échap pour activer ou désactiver la console JavaScript.