Cette page décrit les messages d'erreur que peut renvoyer l'API Maps Embed. Lorsqu'une erreur se produit, 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 à filigrane plus sombre.
Requêtes non valides
En cas de 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. Veuillez vérifier le code d'erreur et le message réels renvoyés par l'API pour en savoir plus sur les problèmes spécifiques.
| 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 de valeurs numériques attendue, 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 quota
Les erreurs liées à la clé API et aux quotas sont traitées comme des requêtes non valides. Voici les causes possibles:
- 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 d'en-tête HTTP
Une carte plus sombre ou une image Street View "négative", portant le filigrane"à des fins de développement uniquement", est renvoyée dans les cas suivants:
- La facturation n'a pas été activée sur votre compte. Activez la facturation.
- Le mode de facturation fourni 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 assurez-vous d'avoir fourni un mode de paiement valide.
- La 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.
- Il manque un référent HTTP dans la requête, et vous utilisez une clé API soumise à des restrictions de référent. En savoir plus sur l'ajout de sites référents
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 quota), 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, voici une liste d'outils permettant de consulter 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
Dans Chrome, vous pouvez utiliser la console JavaScript pour vérifier la sortie de la console comme suit.
- Pour ouvrir les outils de développement, sélectionnez l'icône de menu > 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 pour les développeurs. Vous pouvez également utiliser la touche ÉCHAP pour activer/désactiver la console JavaScript.