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:
- 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 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:
- La facturation n'a pas été activée pour votre compte. Activez la facturation.
- La méthode de facturation fournie n'est pas valide (une carte de crédit arrivée à expiration, par exemple). Pour résoudre ce problème, accédez à Google Cloud Console et assurez-vous d'avoir indiqué un mode de paiement valide.
- Une limite quotidienne que vous avez définie 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 avec restriction d'URL de provenance. En savoir plus sur l'ajout d'URL de provenance
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.
- 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 le résultat 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 ou désactiver la console JavaScript.