Cette page a été traduite par l'API Cloud Translation.

Traiter les erreurs

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

Après avoir effectué une requête, vous pourriez 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 pourriez rencontrer lors de l'utilisation de tuiles 2D et d'images Street View.

Liste d'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 demande. Notez que le message d'erreur indique le paramètre manquant.

notFound, invalid

Vos valeurs x, y ou z sont hors plage.

Pour les tuiles de carte standards, le niveau de zoom maximal dépend de la tuile de carte spécifique 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 classiques, la coordonnée y doit être comprise dans la plage [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 classiques, 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 valable deux semaines à compter de sa date de création. Notez que ces informations peuvent changer 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 demande é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 demande de métadonnées Street View.

quotaExceeded, rateLimitExceeded

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

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 des requêtes échouent avec quotaExceeded et rateLimitExceeded, vous devez réessayer votre requête de manière à ce que les requêtes défectueuses ou les échecs à grande échelle n'inondent pas les serveurs Google, car de nombreux clients tentent de réessayer les requêtes rapidement. 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 pour laisser au serveur le temps de récupérer.

Par exemple, si une requête échoue, réessayez après une seconde. Mais si cette tentative échoue également, réessayez votre requête au bout de deux secondes. Si cette demande échoue également, réessayez au bout de quatre secondes. Vous répartissez donc efficacement chaque requête successive en doublant simplement le temps qui les sépare.

Tuiles 3D

Les erreurs du serveur Google peuvent ne pas être évidentes pour vous, car vous accédez aux tuiles photoréalistes via un moteur de rendu, qui est responsable de la gestion des erreurs de serveur.

Erreurs du moteur de rendu des vignettes

Par exemple, le moteur de rendu CesiumJS échoue généralement en mode silencieux lorsque des erreurs de serveur se produisent, ce qui peut entraîner des plantages, des écrans vides ou des tuiles spécifiques qui ne se chargent pas.

La technique que vous utilisez pour déboguer les erreurs de serveur dépend du moteur de rendu spécifique que vous utilisez. Pour les moteurs de rendu basés sur un navigateur, comme CesiumJS, vous pouvez inspecter le trafic réseau à l'aide des 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 fournit des informations détaillées 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/jeu de tuiles non valides ou jeton de session expiré.
400 : Valeur incorrecte: Assurez-vous que le mapType avec lequel la requête createSessionToken a été effectuée correspond à mapType utilisé dans le point de terminaison de tuile suivant. Par exemple, un jeton de session streetview ne peut pas être utilisé pour demander un bloc roadmap.

403 : Permission refusée