Traiter les erreurs

Après avoir envoyé une requête, vous pouvez recevoir une réponse contenant les détails de l'erreur.

Tuiles 2D et images Street View

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

Erreur de référencement

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 en question et des 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 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 cinq. À ce stade, les valeurs maximales sont imageHeight ou imagewidth divisées 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 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 la section Utiliser des jetons de session.

badRequest

Votre demande était incorrecte. Les raisons les plus courantes sont les suivantes:

• 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 requête de métadonnées Street View.

quotaExceeded, rateLimitExceeded

Votre application a dépassé son 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 les requêtes échouent avec quotaExceeded et rateLimitExceeded, vous devez relancer votre requête de sorte que les requêtes interrompues ou les échecs à grande échelle n'inondent pas les serveurs Goodle, car de nombreux clients tentent de relancer rapidement les requêtes. Cela implique d'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 récupérer.

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

3D Tiles

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 responsable de la gestion des erreurs du serveur.

Erreurs du moteur de rendu de carte

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

La technique à utiliser pour déboguer les erreurs de 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. Vous pouvez par exemple 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 pourriez rencontrer.

400: argument non valide

Clés API, paramètres de requête, ID de tuiles/ensembles de tuiles non valides ou jeton de session arrivé à expiration.

403: Autorisation refusée

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

429: nombre de requêtes trop élevé

Votre quota est épuisé. Contactez l'assistance Google pour augmenter votre quota.