L'API Maps Static peut générer une erreur ou un avertissement en cas de problème. Ce guide explique chaque message d'erreur et fournit des instructions supplémentaires pour résoudre les erreurs.
Requêtes non valides
Dans le cas d'une requête non valide, l'API Maps Static 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 size n'est pas compris dans la plage attendue de valeurs numériques ou est manquant dans la requête. |
400 BAD REQUEST |
La clé d'API incluse dans la requête n'est pas valide. | 403 FORBIDDEN |
Erreurs empêchant l'affichage d'une carte
Si la requête est valide, mais qu'une autre erreur empêche l'affichage de la carte, l'API Maps Static renvoie du texte ou une image d'erreur à la place de la carte, en fonction de l'erreur. Ce type de situation peut se produire, par exemple, lorsque l'application dépasse ses limites d'utilisation.

Erreurs liées aux clés API et à la facturation
Si vous utilisez l'API Maps Static sans clé API ou si la facturation n'est pas activée sur votre compte, la page affiche une image d'erreur au lieu d'une carte, avec un lien indiquant le type d'erreur. Exemple : >co/staticmaperror/key".
Erreurs et solutions sans clé | |
---|---|
![]() |
Vous utilisez l'API Maps Static sans clé API. Pour résoudre ce problème, vous devez : |
![]() |
Il manque une signature numérique dans votre demande (obligatoire). Pour résoudre le problème : Signez votre URL |
Warnings
Pour certaines conditions d'erreur, l'API renvoie une carte, mais certaines informations peuvent être manquantes. Lorsque cela se produit, deux conditions se produisent pour vous informer de l'avertissement.
- Un, la carte s'affiche, mais avec une barre d'erreur jaune superposée au texte avec le texte "Erreur de carte: g.co/staticmaperror".
- Ensuite, l'API renvoie un avertissement sous la forme d'un en-tête HTTP nommé
X-Staticmap-API-Warning
.
Par exemple, l'URL suivante contient une valeur inattendue dans le paramètre markers
:
https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY
L'API renvoie une carte, mais affiche une barre d'erreur jaune superposée à l'image avec la mention "Map Map: g.co/staticmaperror":

L'API renvoie également l'en-tête HTTP suivant :
X-Staticmap-API-Warning:Error geocoding: marker 1
Le tableau suivant décrit les avertissements que l'API peut émettre en tant qu'en-têtes HTTP:
Avertissements dans X-Staticmap-API-Warning en-têtes
|
|
---|---|
Error geocoding:
[center, ][marker #number, ][visible #num, ][path #num, ]* |
Une erreur est survenue pendant la tentative de géocodage de la requête. Il existe de nombreuses variantes de ce message, en fonction de l'élément où le geocoding a échoué (centre, repère, visible ou chemin) et du nombre d'éléments ayant échoué. Un exemple de cet avertissement est X-Staticmap-API-Warning:Error geocoding: marker 1 , comme illustré dans l'exemple ci-dessus. |
Too many geocoded markers requested (max is 15). |
La requête spécifie plus de repères que le nombre maximal autorisé avec une adresse lisible. Le maximum est de 15. Notez que cette limite ne s'applique qu'aux repères spécifiés en tant qu'adresses lisibles nécessitant un géocodage. Elle ne s'applique pas aux repères spécifiés avec des coordonnées de latitude/longitude. |
Too many geocoded polyline vertices requested (max is 15). |
La requête spécifie plus de polylignes que le nombre maximal autorisé de polylignes avec une adresse lisible. Le maximum est de 15. Notez que cette limite ne s'applique qu'aux polylignes avec sommets spécifiées en tant qu'adresses lisibles nécessitant un géocodage. Elle ne s'applique pas aux polylignes spécifiées avec des coordonnées de latitude/longitude. |
Vous pouvez consulter les avertissements d'en-tête HTTP dans la console Chrome DevTools, la console Web Firefox ou d'autres outils équivalents dans votre navigateur.