Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
L'API Street View Static peut générer une erreur ou un avertissement en cas de problème. Ce guide décrit chaque message d'erreur et fournit des instructions supplémentaires pour les résoudre.
Requêtes non valides
Dans le cas d'une requête non valide, l'API Street View Static renvoie un code d'état HTTP 4xx et un message décrivant le problème. Vous trouverez ci-dessous quelques exemples de ces conditions d'erreur. Remarque: Cette liste n'est pas exhaustive. Pour en savoir plus sur des problèmes spécifiques, veuillez vérifier le code d'erreur réel et le message renvoyés par l'API.
Exemple de condition d'erreur
Code d'état
La requête inclut un paramètre non valide ou un paramètre obligatoire est manquant. Par exemple, le paramètre size ne se trouve pas dans la plage de valeurs numériques attendue, ou il est absent de la requête.
400 BAD REQUEST
La clé d'API incluse dans la requête n'est pas valide.
403 FORBIDDEN
Erreurs qui empêchent l'affichage d'une image Street View
Si la requête est valide, mais qu'une autre erreur empêche l'affichage de l'image Street View, l'API Street View Static renvoie du texte ou une image d'erreur au lieu de l'image Street View, selon l'erreur. Ce type de condition d'erreur se produit, par exemple, lorsque l'application dépasse ses limites d'utilisation.
Figure: Une image d'erreur s'affiche à la place d'une image Street View
Erreurs liées aux clés API et à la facturation
Si vous utilisez l'API Street View Static sans clé API ou si la facturation n'est pas activée sur votre compte, la page affiche une image d'erreur au lieu d'une image Street View, avec un lien indiquant le type d'erreur. (par exemple, "g.co/streetviewerror/key").
Erreurs et solutions sans clé
Vous utilisez l'API Street View Static sans clé API. Pour résoudre le problème, vous devez :
Il manque une signature numérique à votre requête (obligatoire). Pour résoudre le problème,
signez votre URL.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[[["\u003cp\u003eThis guide explains error messages returned by the Street View Static API and provides instructions for resolving them.\u003c/p\u003e\n"],["\u003cp\u003eInvalid requests result in a \u003ccode\u003e4xx\u003c/code\u003e status code with a descriptive message, such as errors related to parameters or invalid API keys.\u003c/p\u003e\n"],["\u003cp\u003eWhen a valid request cannot display a street view image due to issues like usage limits, either text or an error image is returned.\u003c/p\u003e\n"],["\u003cp\u003eUsing the API without a key or billing enabled leads to an error image with a link to further information and solutions.\u003c/p\u003e\n"]]],[],null,["# Error Messages in Street View Static API\n\nThe Street View Static API may issue an error or warning when something goes\nwrong. This guide explains each error message, and provides further\ninstructions for resolving errors.\n\nInvalid requests\n----------------\n\nIn the case of an invalid request, the Street View Static API returns\nan HTTP `4xx` status code and a message describing the\nproblem. Below are examples of such error conditions. Note: This is not\na complete list of the possible errors. Please check the actual error code\nand message returned by the API for details of specific problems.\n\n| Example of error condition | Status code |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|\n| The request includes an invalid parameter, or a required parameter is missing. For example, the `size` parameter is not within the expected range of numeric values, or is missing from the request. | `400 BAD REQUEST` |\n| The API key included in the request is invalid. | `403 FORBIDDEN` |\n\nErrors that prevent a street view image from being displayed\n------------------------------------------------------------\n\nIf the request is valid, but another error occurs that prevents the street view image from\nbeing displayed, the Street View Static API returns either text or an error\nimage instead of the street view image, depending on the error. An example of such an error\ncondition is when the application exceeds its\n[usage limits](/maps/documentation/streetview/usage-limits).\n\nFigure: An error image displayed instead of a street view image\n\n### Errors related to API keys and billing\n\nIf you use the Street View Static API without an API key, or if billing\nis not enabled on your account, the page displays an error image instead of a\nstreet view image, with a link indicating the type of error. For example\n\"g.co/streetviewerror/key\".\n\n| Keyless errors and solutions ||\n|---|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | You are using the Street View Static API without an API key. To resolve, you must: 1. [Get an API key](/maps/documentation/streetview/get-api-key#get-an-api-key) 2. [Enable billing](https://console.cloud.google.com/project/_/billing/enable?utm_source=Docs_BillingNudge) 3. [Sign your URL](/maps/documentation/streetview/get-api-key#digital-signature) |\n| | Your request is missing a digital signature (required). To resolve, [Sign your URL](/maps/documentation/streetview/get-api-key#digital-signature) |"]]
