Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Traiter les erreurs

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

Une fois votre requête envoyée, vous pouvez recevoir une réponse contenant des informations 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 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 requête. 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 classiques, 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 classiques, 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 entre 0 et (2^(zoom-1))-1.
Pour les tuiles Street View, le 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 :

Il manque une clé API valide dans la requête.
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 cela peut 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 requête était mal formée. Exemples de motifs courants :

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 lat/lng, 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 quotaExceeded et rateLimitExceeded, vous devez réessayer votre requête de manière à ce que les requêtes interrompues 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, afin de 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 après deux secondes. Si cette requête échoue également, réessayez après quatre secondes. Vous espacez donc efficacement chaque requête successive en doublant simplement le délai entre elles.

Tuiles 3D

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

Erreurs du moteur de rendu de tuiles

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 l'échec du chargement de tuiles spécifiques.

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 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 informations 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 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