Messages d'erreur

Cette page décrit les messages d'erreur que l'API Maps Embed peut renvoyer. En cas d'erreur, l'API Maps Embed affiche 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 n'est pas exhaustive. Pour en savoir plus sur des problèmes spécifiques, veuillez vérifier le code d'erreur réel et le message renvoyés par l'API.

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

Erreurs de clé API et 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 plus sombre, ou une image "négative" Street View, portant le filigrane "à des fins de développement uniquement", est renvoyée si l'une des conditions suivantes est remplie:

Vérifier les erreurs dans votre navigateur

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

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

  1. Pour ouvrir les outils de développement, sélectionnez l'icône de menu > More Tools > Developer Tools (Plus d'outils > Outils de développement).
  2. Pour ouvrir la console JavaScript, cliquez sur l'onglet Console en haut de la fenêtre des outils de développement. Vous pouvez également utiliser la touche ÉCHAP pour activer/désactiver la console JavaScript.