L'image est spécifiée à l'aide des paramètres de la requête. Comme c'est la norme pour les URL, les différents paramètres sont séparés par une esperluette (&).
Vous trouverez ci-dessous la liste des paramètres autorisés et leurs différentes valeurs possibles.
Paramètres obligatoires
L'une des options ci-dessous :
location peut être une chaîne de texte (comme Chagrin Falls, OH) ou une paire de coordonnées de latitude et de longitude (40.457375,-80.009353). Il doit être encodé au format URL. Par conséquent, convertissez les adresses telles que "City Hall, New York, NY" en "City+Hall,New+York,NY" avant d'envoyer la requête.
L'API Street View Static s'aligne sur le panorama photographié le plus proche de la position. Lorsque vous fournissez une chaîne de texte d'adresse, l'API peut utiliser un emplacement de caméra différent pour mieux afficher l'emplacement spécifié.
Lorsque vous fournissez des coordonnées de latitude et de longitude, l'API recherche la photo la plus proche de l'emplacement dans un rayon de 50 mètres.
Étant donné que les images Street View sont actualisées régulièrement et que les photos peuvent être prises à partir de positions légèrement différentes à chaque fois, il est possible que votre location soit associé à un autre panorama lorsque les images sont mises à jour.
soit :
pano correspond à un ID de panorama spécifique. Les ID des panoramas peuvent changer au fil du temps. Ne les conservez donc pas. Enregistrez plutôt l'adresse ou les coordonnées de latitude et de longitude de l'emplacement pour pouvoir actualiser l'ID de panorama. Pour en savoir plus, consultez Actualiser les ID de panoramas supprimés.
Ainsi que :
size spécifie la taille de sortie de l'image en pixels. La taille est spécifiée sous la forme {width}x{height}. Par exemple, size=600x400 renvoie une image de 600 pixels de large et 400 pixels de haut.
key vous permet de surveiller l'utilisation des API de votre application dans la console Google Cloud et de vous assurer que Google peut vous contacter au sujet de votre application si nécessaire.
Pour en savoir plus, consultez Obtenir une clé et une signature.
Actualiser les identifiants de panorama supprimés
Si vous essayez de récupérer un ID de panorama et que vous obtenez ZERO_RESULTS ou aucune valeur, cela signifie que l'ID de panorama a été supprimé et doit être actualisé.
Enregistrez l'adresse ou les coordonnées de latitude et de longitude que vous avez utilisées pour obtenir un ID de panorama. Vous pourrez ainsi actualiser le panorama si nécessaire.
Lorsque vous détectez qu'un ID de panorama a changé, utilisez l'adresse ou les coordonnées de latitude et de longitude d'origine pour rechercher à nouveau les panoramas les plus proches de cet emplacement et obtenir un nouvel ID de panorama.
Paramètres facultatifs
signature (recommandé) est une signature numérique utilisée pour vérifier que tous les sites qui génèrent des requêtes à l'aide de votre clé API sont autorisés à le faire. Les requêtes qui n'incluent pas de signature numérique peuvent échouer.
Pour en savoir plus, consultez Obtenir une clé et une signature.
heading indique la direction prise par la boussole dans la vue de l'appareil photo. Les valeurs peuvent varier de 0 à 360, celles-ci indiquant toutes deux le nord. 90 indique l'est et 180 indique le sud. Si vous ne spécifiez pas de direction, une valeur est calculée de façon à diriger l'appareil photo vers le location spécifié, selon l'angle de vue de la photo prise au plus près.
fov (valeur par défaut : 90) détermine le champ de vision horizontal de l'image exprimé en degrés, avec une valeur maximale autorisée de 120.
Lorsque vous utilisez une fenêtre d'affichage de taille fixe, comme une image Street View de taille définie, le champ de vision représente essentiellement le zoom, avec des nombres plus petits indiquant un niveau de zoom plus élevé.
(Gauche : fov=120 ; Droite : fov=20)
pitch (par défaut : 0) indique l'angle d'inclinaison vers le haut ou vers le bas de la caméra par rapport au véhicule Street View. Le plus souvent, il s'agit d'un angle plat, horizontal. Une valeur positive oriente l'appareil photo vers le haut (90 degrés indiquant l'inclinaison maximale vers le haut), tandis qu'une valeur négative oriente l'appareil photo vers le bas (-90 indiquant l'inclinaison maximale vers le bas).
radius (valeur par défaut : 50) définit un rayon, spécifié en mètres, dans lequel rechercher un panorama, centré sur la latitude et la longitude données. Les valeurs valides sont des entiers non négatifs.
return_error_code indique si l'API doit renvoyer un code d'erreur lorsqu'aucune image n'est trouvée (404 NOT FOUND) ou en réponse à une requête non valide (400 BAD REQUEST). Les valeurs valides sont true et false. Si la valeur est définie sur true, un message d'erreur s'affiche à la place de l'image grise générique. Cela évite d'avoir à effectuer un appel distinct pour vérifier la disponibilité des images.
source (par défaut : default) limite les recherches Street View aux sources sélectionnées. Les valeurs possibles sont les suivantes :
default utilise les sources par défaut pour Street View. Les recherches ne sont pas limitées à des sources spécifiques.
outdoor limite les recherches aux collections extérieures. Les collections en intérieur ne sont pas incluses dans les résultats de recherche. Notez qu'il est possible que les panoramas extérieurs ne soient pas disponibles pour le lieu spécifié. Notez également que la recherche ne renvoie que les panoramas pour lesquels il est possible de déterminer s'ils sont en intérieur ou en extérieur. Par exemple, les photos sphériques ne sont pas renvoyées, car on ne sait pas si elles ont été prises à l'intérieur ou à l'extérieur.
Pour les lieux où les images Street View ne sont pas disponibles, l'API Street View Static renvoie une image générique grise avec le texte "Désolé, nous n'avons aucune image ici", comme dans cet exemple :
Figure : Image générique affichée lorsqu'aucune image n'est disponible pour l'emplacement spécifié.
Afficher uniquement les images valides
Pour éviter d'afficher l'image générique et vous assurer que votre page Web n'affiche que des images valides de l'API Street View Static, suivez ces suggestions :
Définissez le paramètre return_error_code sur true.
L'API Street View Static renvoie alors une erreur 404 NOT FOUND à la place de l'image grise générique, si aucune image n'est disponible pour le lieu spécifié.
Demandez les métadonnées des images Street View pour déterminer si des images sont disponibles pour l'emplacement spécifié avant d'envoyer une requête.
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\u003eAccess Street View images via HTTP URL using specified parameters for location, size, and API key.\u003c/p\u003e\n"],["\u003cp\u003eYou can use either a text string location like "Chagrin Falls, OH" or latitude/longitude coordinates like "40.457375,-80.009353" to specify the location for Street View image requests.\u003c/p\u003e\n"],["\u003cp\u003eCustomize Street View image requests by adjusting parameters such as \u003ccode\u003eheading\u003c/code\u003e, \u003ccode\u003efov\u003c/code\u003e, \u003ccode\u003epitch\u003c/code\u003e, and \u003ccode\u003eradius\u003c/code\u003e to control the camera's view.\u003c/p\u003e\n"],["\u003cp\u003eIf Street View imagery is unavailable for the specified location, the API returns a generic gray image, which you can prevent by using the \u003ccode\u003ereturn_error_code\u003c/code\u003e parameter or checking image metadata beforehand.\u003c/p\u003e\n"],["\u003cp\u003eTo avoid misuse, it's recommended to use a digital signature (\u003ccode\u003esignature\u003c/code\u003e parameter) with your API key, especially for former Google Maps Platform Premium Plan customers.\u003c/p\u003e\n"]]],[],null,["# Streetview request and response\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nA Street View Image request is an HTTP URL in this format: \n\n```text\nhttps://maps.googleapis.com/maps/api/streetview?parameters\n```\n\nThe image is specified using request parameters. As is standard in\nURLs, all parameters are separated using the ampersand (\\&) character.\nAllowed parameters and their possible values are listed below.\n\nRequired parameters\n-------------------\n\nEither:\n\n- `location` can be either a text string (such as `Chagrin Falls, OH`) or a latitude and longitude coordinates pair (`40.457375,-80.009353`), and should be [URL-encoded](/maps/url-encoding). So convert addresses such as \"City Hall, New York, NY\" to \"City+Hall,New+York,NY\" before you send the request. The Street View Static API snaps to the panorama photograph closest to the location. When you provide an address text string, the API may use a different camera location to better display the specified location. When you provide latitude and longitude coordinates, the API searches a 50 meter radius for a photograph closest to the location. Because Street View imagery is periodically refreshed, and photographs may be taken from slightly different positions each time, it's possible that your `location` may snap to a different panorama when imagery is updated.\n\nOr:\n\n- `pano` is a specific panorama ID. Panoramas may change ID over time, so don't persist this ID. Instead, save the location address or latitude and longitude coordinates so you can refresh the panorama ID. For details, see [Refresh deleted panorama IDs](#refresh-pano).\n\nAs well as:\n\n- `size` specifies the output size of the image in pixels. Size is specified as `{width}x{height}` - for example, `size=600x400` returns an image 600 pixels wide, and 400 high.\n- `key` lets you monitor your application's API usage in the [Google Cloud console](https://console.cloud.google.com), and ensures that Google can contact you about your application if necessary. For more information, see [Get a Key and Signature](/maps/documentation/streetview/get-api-key).\n\n### Refresh deleted panorama IDs\n\nIf you attempt to retrieve a panorama ID and get either `ZERO_RESULTS` or\nno value, then the panorama ID has been deleted and needs to be refreshed.\n\n1. Save the location address or latitude and longitude coordinates you used to\n get a panorama ID so you can refresh when needed.\n\n2. When you detect that a panorama ID has changed, use the original location\n address or latitude and longitude coordinates to search again for the nearest\n panoramas to that location and get a new panorama ID.\n\n| **Note:** Because Street View imagery is periodically refreshed, and photographs may be taken from slightly different positions each time, a given panorama ID may snap to a different panorama when imagery or the panorama ID is updated.\n\nOptional parameters\n-------------------\n\n- `signature` (*recommended* ) is a digital signature used to verify that any site generating requests using your API key is authorized to do so. Requests that don't include a digital signature might fail. For more information, see [Get a Key and Signature](/maps/documentation/streetview/get-api-key).\n\n **Note:** for former Google Maps Platform Premium Plan customers, the **digital\n signature is required** . Get more information on\n [authentication parameters for\n Premium Plan customers](/maps/documentation/streetview/get-api-key#premium-auth).\n- `heading` indicates the compass heading of the camera. Accepted values are from `0` to `360` (both values indicating North, with `90` indicating East, and `180` South). If you don't specify a heading, a value is calculated that directs the camera towards the specified `location`, from the point at which the closest photograph was taken.\n- `fov` (*default is* `90`) determines the horizontal field of view of the image expressed in degrees, with a maximum allowed value of `120`. When dealing with a fixed-size viewport, as with a Street View image of a set size, field of view in essence represents zoom, with smaller numbers indicating a higher level of zoom.\n\n \u003cbr /\u003e\n\n\n \u003cbr /\u003e\n\n *(Left: `fov=120`; Right: `fov=20`)*\n\n\n- `pitch` (*default is* `0`) specifies the up or down angle of the camera relative to the Street View vehicle. This is often, but not always, flat horizontal. Positive values angle the camera up (with `90` degrees indicating straight up); negative values angle the camera down (with `-90` indicating straight down).\n- `radius` (*default is* `50`) sets a radius, specified in meters, in which to search for a panorama, centered on the given latitude and longitude. Valid values are non-negative integers.\n- `return_error_code` indicates whether the API should return an error code when no image is found (404 NOT FOUND), or in response to an invalid request (400 BAD REQUEST). Valid values are `true` and `false`. If set to `true`, an error message is returned in place of the generic gray image. This eliminates the need to make a separate call to check for image availability.\n- `source` (*default is* `default`) limits Street View searches to selected sources. Valid values are:\n - `default` uses the default sources for Street View; searches are not limited to specific sources.\n - `outdoor` limits searches to outdoor collections. Indoor collections are not included in search results. Note that outdoor panoramas may not exist for the specified location. Also note that the search only returns panoramas where it's possible to determine whether they're indoors or outdoors. For example, PhotoSpheres are not returned because it's unknown whether they are indoors or outdoors.\n\nThis is an example request. \n\n```html\nhttps://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE\n```\n\nNo imagery available\n--------------------\n\nFor locations where Street View imagery is not available, the Street View Static API\nreturns a gray generic image, with the text \"Sorry, we have no imagery\nhere.\", as shown in this example:\nFigure: Generic image displayed when no imagery is available for the specified location.\n\n### Show only valid images\n\nTo avoid displaying the generic image, and ensure that your web page\ndisplays only valid Street View Static API images, follow these\nsuggestions:\n\n- Set the `return_error_code` parameter to `true`. This causes the Street View Static API to return a 404 NOT FOUND error in place of the generic gray image, if no image is available for the specified location.\n- Request [Street View image metadata](/maps/documentation/streetview/metadata) to determine if there is imagery available for the specified location prior to sending a request."]]
