Messages d'erreur dans l'API Maps Static

L'API Maps Static émet une erreur ou un avertissement lorsqu'une requête échoue. Ce guide explique les messages d'erreur et fournit des instructions pour les résoudre.

Requêtes non valides

Pour une requête non valide, l'API Maps Static renvoie un code d'état HTTP 4xx et un message décrivant le problème, comme indiqué dans la liste suivante. Vérifiez le code et le message d'erreur réels renvoyés par l'API pour obtenir des informations sur des problèmes spécifiques.

La requête inclut un paramètre non valide ou un paramètre obligatoire est manquant. Par exemple, le paramètre size ne se trouve pas dans la plage de valeurs numériques attendue 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 qui empêchent 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. Par exemple, une erreur se produit lorsque l'application dépasse ses limites d'utilisation.

Image d'erreur affichée à la place de la carte
Image d'erreur affichée à la place d'une carte

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. Par exemple, "g.co/staticmaperror/key."

Erreurs et solutions pour l'accès sans clé
Erreur liée aux limites d'utilisation : la limite de chargements de cartes quotidienne fournie a été dépassée Vous utilisez l'API Maps Static sans clé API. Pour résoudre ce problème, procédez comme suit :
  1. Obtenir une clé API
  2. Activer la facturation
  3. Signer votre URL
Erreur liée aux limites d'utilisation : les URL des requêtes ne comportent pas de signature numérique Il manque une signature numérique obligatoire dans votre demande. Pour résoudre cette erreur, signez votre URL.

Avertissements

Pour certaines conditions d'erreur, l'API renvoie une carte, mais il se peut que certaines informations y manquent. Dans ce cas, vous pouvez identifier l'avertissement à l'aide des conditions suivantes :

  • La carte s'affiche avec une barre d'erreur jaune superposée et le texte "Erreur de carte : g.co/staticmaperror".
  • 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 le texte "Erreur de carte : g.co/staticmaperror" :

La carte affiche l'erreur suivante : g.co/staticmaperror
Carte affichant une barre d'avertissement jaune

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 les en-têtes X-Staticmap-API-Warning
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 pour lequel le géocodage a échoué (center, marker, visible ou path, par exemple) et du nombre d'éléments ayant échoué. Un exemple de cet avertissement est X-Staticmap-API-Warning:Error geocoding: marker 1, comme indiqué dans l'exemple précédent.
Too many geocoded markers requested (max is 15). La requête spécifie un nombre de repères avec une adresse lisible par un humain supérieur au nombre maximal autorisé. Le maximum est de 15. Cette limite ne s'applique qu'aux repères spécifiés sous forme d'adresse lisible qui nécessite un géocodage. Elle ne s'applique pas aux repères spécifiés avec des coordonnées de latitude et de longitude.
Too many geocoded polyline vertices requested (max is 15). La requête spécifie un nombre de polylignes supérieur au nombre maximal autorisé avec une adresse lisible par un humain. Le maximum est de 15. Cette limite ne s'applique qu'aux polylignes dont les sommets sont spécifiés sous forme d'adresses lisibles par l'utilisateur et qui nécessitent un géocodage. Il ne s'applique pas aux polylignes spécifiées avec des coordonnées de latitude et de longitude.

Vous pouvez consulter les avertissements concernant les en-têtes HTTP dans la console des outils pour les développeurs Chrome, la console Web Firefox ou d'autres outils équivalents dans votre navigateur.