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 explique chaque message d'erreur et fournit des instructions supplémentaires pour les résoudre.

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: Cette liste n'est pas exhaustive. 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 au lieu 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. 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: la signature numérique est manquante dans les URL de requête Votre demande ne comporte pas de signature numérique (obligatoire). Pour résoudre ce problème, signez votre URL.

Avertissements

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 en haut de la carte avec le texte "Erreur de carte: 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 "Erreur de carte: 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 existe de nombreuses variantes de ce message, en fonction de l'élément pour lequel le géocodage a échoué (centre, repère, visible ou chemin) et du nombre d'éléments concernés. 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 que le nombre maximal autorisé de repères avec une adresse lisible par l'homme. Le maximum est de 15. Notez que cette limite ne s'applique qu'aux repères spécifiés sous la forme d'une 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/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 ne s'applique qu'aux polylignes dont les sommets sont spécifiés en tant qu'adresses lisibles qui nécessitent 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 des outils pour les développeurs Chrome, la console Web Firefox ou d'autres outils équivalents dans votre navigateur.