Messages d'erreur dans l'API Maps Static

L'API Maps Static peut envoyer une erreur ou un avertissement en cas de problème faux. Ce guide décrit chaque message d'erreur et fournit des informations pour résoudre les erreurs.

Requêtes non valides

En cas de 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: Il ne s'agit pas une liste complète des erreurs possibles. 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 size ne se trouve pas dans la plage de valeurs numériques attendues 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. Par exemple, lorsque l'application dépasse ses limites d'utilisation, une telle condition d'erreur se produit.

Image d'erreur affichée à la place de la carte
Figure: 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 dans 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 liées à la clé sans contact et solutions
Erreur liée aux limites d'utilisation : limite de chargement de cartes quotidienne fournie dépassée Vous utilisez l'API Maps Static sans clé API. À vous devez:
  1. Obtenir une clé API
  2. Activer la facturation
  3. Signer votre URL
Erreur de limites d'utilisation: les URL de requête ne comportent pas de signature numérique. Il manque une signature numérique dans votre demande (obligatoire). Pour résoudre ce problème, Signer votre URL

Avertissements

Dans certaines conditions d'erreur, l'API renvoie une carte, mais certaines informations peuvent manquer. Lorsque cela se produit, deux conditions se produisent pour vous informer l'avertissement.

  • Premièrement, la carte s'affiche, mais avec une barre d'erreur jaune superposée en haut de la carte 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 sur l'image avec le message "Map error: g.co/staticmaperror" :

La carte s'affiche, mais avec l'erreur « Map error: 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 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 y a de nombreuses variantes de ce message, en fonction de l'élément où le geocoding d'échec (centre, repère, visible ou tracé) et le nombre d'éléments qui a échoué. X-Staticmap-API-Warning:Error geocoding: marker 1 est un exemple de cet avertissement, 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 s'applique uniquement aux repères spécifiés sous la forme d'une adresse lisible nécessite un geocoding. 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 un nombre supérieur au nombre maximal autorisé de polylignes avec une adresse lisible par l'homme. Le maximum est de 15. Notez que cette limite s'applique uniquement aux polylignes dont les sommets sont spécifiés en tant qu'adresses lisibles par l'homme qui qui nécessitent un geocoding. Il ne s'applique pas aux polylignes spécifiées avec de latitude et de longitude.

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