Messages d'erreur dans l'API Maps Static

L'API Maps Static peut générer une erreur ou un avertissement en cas de problème. Ce guide décrit chaque message d'erreur et fournit des instructions supplémentaires pour les résoudre.

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 n'est pas exhaustive. Pour en savoir plus sur des problèmes spécifiques, veuillez vérifier le code d'erreur réel et le message renvoyés par l'API.

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 attendue, ou il est absent de 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 au lieu de la carte, selon l'erreur. Ce type de condition d'erreur se produit, par exemple, lorsque l'application dépasse ses limites d'utilisation.

Image d'erreur affichée à la place de la carte
Figure: Une image d'erreur s'affiche au lieu 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 sans clé
Erreur de limites d'utilisation: limite quotidienne de chargements de cartes dépassée Vous utilisez l'API Maps Static sans clé API. Pour résoudre le problème, vous devez :
  1. Obtenir une clé API
  2. Activer la facturation
  3. Signer votre URL
Erreur de limites d'utilisation: signature numérique manquante dans les URL des requêtes Il manque une signature numérique à votre requête (obligatoire). Pour résoudre le problème, signez votre URL.

Warnings

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

  • Premièrement, la carte s'affiche, mais avec une barre d'erreur jaune superposée au-dessus de la carte avec le texte "Map error: g.co/staticmaperror".
  • Deuxièmement, 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 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 sous forme d'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 geocoding a échoué (centre, repère, visible ou tracé) et le nombre d'éléments ayant é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 ne s'applique qu'aux repères spécifiés en tant qu'adresses lisibles nécessitant 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 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 des sommets spécifiés en tant qu'adresses lisibles nécessitant un geocoding. Il 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 des outils pour les développeurs Chrome, la console Web Firefox ou d'autres outils équivalents dans votre navigateur.