Traiter les erreurs

Après avoir effectué une requête, vous pouvez recevoir une réponse contenant une erreur plus de détails.

Tuiles 2D et images Street View

La liste suivante détaille les erreurs que vous pouvez rencontrer lors de l'utilisation de la 2D. Tuiles et images Street View.

Erreur lors de la création de la liste

La liste suivante détaille les erreurs que vous pouvez rencontrer lors de l'utilisation du API Map Tiles.

required

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

notFound, invalid

votre x, votre y ou Les valeurs z ne sont pas autorisées.

• Pour les tuiles de carte classiques, le niveau de zoom maximal dépend de la carte, ainsi que sur les options de carte que vous avez demandées.

• Pour les tuiles de carte classiques, la coordonnée X doit être comprise dans la plage [0, (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 zoom doit être compris entre 0 et 5 inclus.

• Pour les tuiles Street View, les plages des coordonnées X et Y sont les mêmes que pour les tuiles de carte normales, jusqu'au niveau de zoom 5. À ce stade, la valeur les valeurs sont imageHeight ou imagewidth divisés par tileHeight ou tileWidth

forbidden: Il manque une clé API valide dans la requête.

expired

Votre jeton session a expiré. Un jeton de session est valide pour deux semaines après sa création. Notez que cela peut changer sans préavis. Si vous recevez cette erreur, vous devez obtenir une nouvelle session , comme décrit dans la section Utilisez des jetons de session.

badRequest

Votre demande n'était pas rédigée correctement. Voici les principales raisons pouvant expliquer cette situation:

• 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 qu'une carte routière.

• Vous avez envoyé une valeur de latitude/longitude, ainsi qu'un identifiant de panorama dans une métadonnée Street View. requête.

quotaExceeded, rateLimitExceeded

Votre application a dépassé le quota autorisé ou le quota autorisé le nombre 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 relancer votre requête, par exemple à cause de requêtes erronées ou d'échecs à grande échelle ; n'inondent pas les serveurs Goodle, car de nombreux clients tentent de relancer les requêtes dans des succession. Cela signifie utiliser intervalle exponentiel entre les tentatives lorsque vous relancez vos requêtes. L'intervalle exponentiel entre les tentatives vous oblige à répandre requêtes à temps, pour laisser le temps au serveur de récupérer.

Par exemple, si une requête échoue, réessayez après une seconde. Mais si cela la requête échoue également, puis réessayez d'envoyer votre requête au bout de deux secondes. Si échouera également, puis réessayez après quatre secondes. Donc, vous répartissez 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 à des tuiles photoréalistes à l'aide d'un moteur de rendu, qui est chargé de gérer les erreurs de serveur.

Erreurs du moteur de rendu de carte

Par exemple, le moteur de rendu CesiumJS échoue généralement en mode silencieux lorsque des erreurs de serveur pouvant entraîner des plantages, des écrans vides, les vignettes ne se chargent pas.

La technique à utiliser pour déboguer les erreurs de serveur dépend de la 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 Outils pour les développeurs Chrome

Erreurs fréquentes

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

400: argument non valide

Clés API, paramètres de requête, ID d'emplacement/ensemble d'emplacements non valides, ou session expirée à partir de zéro.

403: Autorisation refusée

Clé API ou connexion SSL manquante, ou clé API n'a pas été ajoutée à la liste d'autorisation pour les tuiles 3D. Contacter Google de l'assistance avec l'ID de votre projet pour être ajouté à la liste d'autorisation pour la fonctionnalité 3D Tiles de l'API Map Tiles.

429: Trop de requêtes

Votre quota est épuisé. Contact Assistance Google pour augmenter votre quota.