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:
- Clé API manquante ou non valide. Pour résoudre cette erreur, assurez-vous que votre requête inclut une clé API valide. Obtenez une clé API.
- L'API Maps Embed n'est pas activée pour votre projet. Découvrez comment activer et désactiver des API.
- La clé API ne respecte pas les restrictions. En savoir plus sur les bonnes pratiques concernant les clés API
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:
- La facturation n'a pas été activée sur votre compte. Activez la facturation.
- La méthode de facturation fournie n'est pas valide (par exemple, une carte de crédit arrivée à expiration). Pour résoudre ce problème, accédez à la console Google Cloud et vérifiez que vous avez indiqué un mode de paiement valide.
- Une limite quotidienne que vous avez définie vous-même a été dépassée. Découvrez comment afficher ou modifier les limites facturables quotidiennes.
- La requête ne comporte pas de référent HTTP et vous utilisez une clé API restreinte à ce type d'URL. En savoir plus sur l'ajout d'URL de provenance
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.
- Console pour Internet Explorer
- Console Web pour Firefox
- Débogage à distance pour Android
- Inspecteur Web pour iOS
Pour consulter le résultat de la console dans Chrome, utilisez la console JavaScript comme suit.
- 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).
- 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.