Rejoignez-nous pour notre prochain Google Maps Platform Developer Community Day à San Francisco en décembre ! Inscrivez-vous pour participer.

Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Traiter les erreurs

Développeurs de l'Espace économique européen (EEE)

Après avoir effectué une requête, vous pouvez recevoir une réponse contenant des détails sur l'erreur.

Tuiles 2D et images Street View

La liste suivante détaille les erreurs que vous pouvez rencontrer lorsque vous utilisez des tuiles 2D et des images Street View.

Liste des erreurs

La liste suivante détaille les erreurs que vous pouvez rencontrer lorsque vous utilisez l'API Map Tiles.

required

Il manque un paramètre d'URL dans votre requête. Notez que le message d'erreur indique quel paramètre est manquant.

notFound, invalid

Vos valeurs x, y ou z sont hors de la plage autorisée.

Pour les tuiles de carte standards, le niveau de zoom maximal dépend de la tuile de carte concernée et des options de carte que vous avez demandées.
Pour les tuiles de carte standards, la coordonnée x doit être comprise entre 0 et (2^zoom)-1.
Pour les tuiles de carte standards, la coordonnée y doit être comprise entre [0, (2^(zoom-1))-1].
Pour les tuiles Street View, le niveau de zoom doit être compris entre 0 et 5 inclus.
Pour les tuiles Street View, les plages de coordonnées X et Y sont les mêmes que pour les tuiles de carte standards, jusqu'au niveau de zoom 5. À ce stade, les valeurs maximales sont imageHeight ou imagewidth divisées par tileHeight ou tileWidth.

forbidden :

Causes possibles :

La requête ne contient pas de clé API valide.
Message : Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

Les tuiles satellite 2D ne sont pas disponibles dans les projets associés à un compte de facturation dont l'adresse se trouve dans l'Espace économique européen (EEE). Pour en savoir plus, consultez Ajustements de l'API Map Tiles pour les clients de l'EEE.

expired

Votre jeton session a expiré. Un jeton de session est valide pendant deux semaines à compter de sa date de création. Notez que ces informations sont susceptibles d'être modifiées sans préavis. Si vous recevez cette erreur, vous devez obtenir un nouveau jeton de session, comme décrit dans Utiliser des jetons de session.

badRequest

Votre requête était incorrecte. Voici quelques raisons courantes :

Vous avez spécifié un type de carte terrain sans inclure de calque roadmap.
Vous avez inclus un tableau styles pour un type de carte autre que "roadmap".
Vous avez envoyé une valeur de latitude/longitude, ainsi qu'un ID de panorama dans une requête de métadonnées Street View.

quotaExceeded, rateLimitExceeded

Votre application a dépassé le quota autorisé ou le nombre autorisé de requêtes par seconde.

Exemple d'erreur

{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "errors": [
      {
        "message": "The request is missing a valid API key.",
        "domain": "global",
        "reason": "forbidden"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

Réessayer d'exécuter des requêtes

Lorsque les requêtes échouent avec les codes quotaExceeded et rateLimitExceeded, vous devez les relancer de manière à ce que les requêtes défectueuses ou les défaillances à grande échelle ne submergent pas les serveurs Google, car de nombreux clients tentent de relancer les requêtes en succession rapide. Cela signifie que vous devez utiliser un intervalle exponentiel entre les tentatives lorsque vous relancez vos requêtes. L'intervalle exponentiel entre les tentatives vous oblige à espacer vos requêtes dans le temps, afin de laisser au serveur le temps de récupérer.

Par exemple, si une requête échoue, réessayez après une seconde. Si cette tentative échoue également, relancez votre requête après deux secondes. Si cette requête échoue également, réessayez après quatre secondes. Vous répartissez ainsi efficacement chaque requête successive en doublant simplement le délai entre elles.

Tuiles 3D

Les erreurs du serveur de Google peuvent ne pas être évidentes pour vous, car vous accédez aux tuiles photoréalistes via un moteur de rendu, qui est chargé de gérer les erreurs du serveur.

Erreurs du moteur de rendu des tuiles

Par exemple, le moteur de rendu CesiumJS échoue généralement de manière silencieuse lorsque des erreurs de serveur se produisent, ce qui peut entraîner des plantages, des écrans vides ou le non-chargement de tuiles spécifiques.

La technique que vous utilisez pour déboguer les erreurs du serveur dépend du moteur de rendu que vous utilisez. Pour les moteurs de rendu basés sur un navigateur comme CesiumJS, vous pouvez inspecter le trafic réseau à l'aide d'outils intégrés à la plupart des navigateurs. Par exemple, vous pouvez utiliser les Outils pour les développeurs Chrome.

Erreurs fréquentes

La liste suivante contient des détails sur les erreurs les plus courantes que vous pouvez rencontrer.

400 : Argument non valide: Clés API, paramètres de requête, ID de tuile/tileset non valides ou jeton de session expiré.
400 : Valeur non valide: Assurez-vous que le mapType avec lequel la requête createSessionToken a été effectuée correspond au mapType utilisé dans le point de terminaison de tuile suivant. Par exemple, un jeton de session streetview ne peut pas être utilisé pour demander une tuile roadmap.

403 : Autorisation refusée