Traiter les erreurs

Après avoir envoyé une requête, 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 cartes 2D et des 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 de 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 en question et des options de carte que vous avez demandées.

  • Pour les tuiles de carte standards, la coordonnée X doit se trouver dans la plage [0, (2^zoom)-1].

  • Pour les tuiles de carte standards, 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 zéro et cinq, 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 de 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 pendant deux semaines à compter de sa 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 la section 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 qu'une carte routière.

  • 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é son quota autorisé ou le nombre de requêtes autorisé 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 la relancer de manière à ce que les requêtes interrompues ou les échecs à grande échelle n'inondent pas les serveurs Goodle, car de nombreux clients tentent de relancer les requêtes à la suite. 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 à étaler vos requêtes dans le temps pour laisser au serveur le temps de se rétablir.

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

Tuiles 3D

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

Erreurs du moteur de rendu des cartes

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

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

Erreurs fréquentes

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

400: Argument incorrect
Clés API, paramètres de requête, ID d'emplacement/ensemble de vignettes non valides ou jeton de session expiré.
403: autorisation refusée
Clé API ou connexion SSL manquantes, ou votre clé API n'a pas été ajoutée à la liste d'autorisation pour les tuiles 3D. Contactez l'assistance Google en indiquant votre ID de projet pour être ajouté à la liste d'autorisation de la fonctionnalité 3D Tiles de l'API Map Tiles.
429: Trop de requêtes
Votre quota est épuisé. Contactez l'assistance Google pour augmenter votre quota.