Les tuiles Street View sont semblables aux tuiles 2D, si ce n'est qu'elles contiennent des images panoramiques prises au niveau de la rue. Grâce à Street View, vous pouvez explorer des sites célèbres dans le monde entier, découvrir des merveilles naturelles et visiter des lieux tels que des musées, des stades, des restaurants ou des petites entreprises. Ce point de terminaison d'API vous donne accès aux éléments suivants:
- Google Maps Street View Tiles
- Métadonnées Street View
- Miniatures Street View
Vous pouvez assembler des tuiles d'images prises au niveau de la rue pour créer un effet panoramique réel. Vous pouvez interroger jusqu'à 100 identifiants de panorama pour un ensemble de lieux (par exemple, un itinéraire) et obtenir des métadonnées plus détaillées sur la position de l'appareil photo.
Une visionneuse est nécessaire pour assembler les tuiles Street View. (par exemple, la visionneuse de panoramas personnalisés Street View).
Une fois que vous disposez d'une clé API, vous pouvez accéder aux images Street View en procédant comme suit.
Obtenez un jeton de session. Veillez à définir la valeur de
mapType
surstreetview
.Utilisez le jeton de session pour obtenir l'identifiant de panorama (panoId) d'un ou de plusieurs emplacements géographiques.
Utilisez les identifiants de panorama de la réponse à la recherche panoId pour obtenir:
Métadonnées Street View : Vous pouvez également obtenir des métadonnées Street View en transmettant un ensemble de coordonnées et un rayon.
Méthodes Street View
Vous pouvez accéder aux images et aux métadonnées Street View en appelant l'une des quatre méthodes suivantes.
Méthode | Description |
---|---|
https://tile.googleapis.com/v1/streetview/tiles |
Renvoie les tuiles Street View individuelles. Vous pouvez récupérer les tuiles Street View à six niveaux de zoom: de 512 pixels à 13 312 pixels. |
https://tile.googleapis.com/v1/streetview/panoIds |
Vous permet d'effectuer une recherche groupée sur un maximum de 100 établissements. Renvoie les ID de panorama de tous les lieux comportant des images. |
https://tile.googleapis.com/v1/streetview/thumbnail |
Renvoie une image JPEG miniature d'une scène Street View. Vous permet de fournir un titre, un argumentaire, des dimensions et un champ de vision. Les dimensions minimales sont de 16 x 16 pixels. Les dimensions maximales sont de 250 x 600 pixels. |
https://tile.googleapis.com/v1/streetview/metadata |
Fournit des informations détaillées sur le panorama spécifié. Les détails incluent l'adresse associée et les liens vers les panoramas adjacents. |
Recherche de panoramas Street View
Vous pouvez trouver l'identifiant de panorama d'un ou de plusieurs emplacements géographiques en transmettant leurs coordonnées (lat
, lng
) à la méthode panoIds
. Le corps de la requête est un objet JSON qui contient un tableau locations
et éventuellement un radius
, comme indiqué dans l'exemple de code JSON suivant.
curl -X POST -d '{ "locations": [ {"lat": -33.883837, "lng": 151.209307}, {"lat": -33.883700, "lng": 151.210307}, {"lat": 0, "lng": 0} ], "radius": 50 }' \ -H 'Content-Type: application/json' \ "https://tile.googleapis.com/v1/streetview/panoIds?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY"
locations
- Le tableau
locations
doit contenir au moins un ensemble de valeurs de coordonnées, mais vous pouvez en inclure davantage (jusqu'à 100). radius
- La valeur
radius
(mesurée en mètres) définit le rayon du cercle autour du lieu donné, dans lequel rechercher des panoramas. La valeur par défaut est de 50 mètres.
Réponse PanoId
L'API Map Tiles tente de trouver le panorama le plus proche de chaque point géographique, puis renvoie leurs ID de panorama. Une requête panoIds
réussie renvoie un objet JSON contenant un tableau panoIds
. Le tableau contient une liste d'identifiants de panorama, dans l'ordre dans lequel vous les avez demandés. Si l'API Map Tiles ne trouve aucun panorama pour les lieux que vous avez demandés, une chaîne vide est renvoyée à cet endroit dans le tableau. Pour obtenir un exemple, consultez le code JSON suivant.
{
"panoIds": [
"ACfH-n2HcBvRry_3oc9grw",
"f5DJZatBAAAXHlooS2wKbw",
""
]
}
Vous pouvez utiliser panoIds
pour:
- Demander des métadonnées Street View
- Demander des miniatures Street View
- Demander des tuiles Street View
Métadonnées Street View
Les requêtes de métadonnées Street View récupèrent des informations sur les panoramas. Une requête de métadonnées Street View est une requête HTTPS GET. Vous pouvez récupérer des informations sur les panoramas de l'une des deux manières suivantes:
Si vous transmettez un
pano_id
, l'API Map Tiles renvoie les métadonnées de ce panorama.Toutefois, si vous transmettez
lat
etlng
, l'API Map Tiles renvoie les métadonnées du panorama le plus proche dans le rayon de recherche donné.
Transmettre un ensemble de coordonnées et un rayon
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY &lat=lat &lng=lng &radius=meters"
Étant donné que les ID de panorama sont temporaires, nous vous recommandons de transmettre un ensemble de coordonnées et une valeur radius
dans votre requête initiale de métadonnées Street View.
Pour obtenir un exemple, consultez l'extrait de code suivant.
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &lat=47.62066 &lng=-122.34923 &radius=50"
Transmettre l'ID de panorama d'une image Street View
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId"
Réponse de métadonnées
Le code JSON suivant est un exemple de réponse de métadonnées type.
{
"panoId": "rZ9KeTyhA11i0VppYNzsSg",
"lat": 37.420864219339165,
"lng": -122.08446528377291,
"imageHeight": 6656,
"imageWidth": 13312,
"tileHeight": 512,
"tileWidth": 512,
"heading": 94.35,
"tilt": 88.39652,
"roll": 1.7181772,
"imageryType": "outdoor",
"date": "2023-01",
"copyright": "© 2023 Google",
"reportProblemLink": "https://cbks0.googleapis.com/cbk?output=report&panoid=rZ9KeTyhA11i0VppYNzsSg&cb_client=api&cbp=1,0,,0,0&hl=en-US&gl=us",
"addressComponents": [
{
"longName": "United States",
"shortName": "United States",
"types": [
"country"
]
},
{
"longName": "Mountain View, California",
"shortName": "Mountain View, California",
"types": [
"locality"
]
},
{
"longName": "Charleston Rd",
"shortName": "Charleston Rd",
"types": [
"route"
]
},
{
"longName": "1635",
"shortName": "1635",
"types": [
"street_number"
]
}
],
"links": [
{
"panoId": "Yw4pqzA4FEq1qs-BwZSvSQ",
"heading": 274.47998046875,
"text": "Charleston Rd"
},
{
"panoId": "1cODYwFRw1aZ45IignDIMw",
"heading": 94.47999572753906,
"text": "Charleston Rd"
}
]
}
La liste suivante contient les définitions des champs présents dans le corps de la réponse.
panoId
- Identifiant unique de ce panorama. Ne vous attendez pas à ce que les ID de panorama soient valides au-delà d'une seule session utilisateur.
lat
,lng
- Coordonnées (latitude et longitude) du panorama. Ces valeurs peuvent être différentes des coordonnées que vous avez transmises dans la requête, car le lieu s'accroche au panorama le plus proche.
imageHeight
,imageWidth
- Dimensions de l'image de panorama assemblée.
tileHeight
,tileWidth
- Dimensions d'une seule tuile de panorama.
heading
- Cap de la boussole, mesuré en degrés et dans le sens des aiguilles d'une montre à partir du nord. Les en-têtes sont renvoyés dans la plage [0 360], 0 représentant le nord géographique.
tilt
- Inclinaison du panorama, mesurée en degrés entre le pôle Sud du panorama et l'horizon. Les valeurs renvoyées sont comprises dans la plage [0, 180]. Une valeur de 90 degrés indique que l'horizon est déjà aligné sur l'équateur du panorama.
roll
- Rotation dans le sens des aiguilles d'une montre autour de la ligne de vue appliquée au panorama pour niveler l'horizon. Les valeurs renvoyées sont comprises dans la plage [0, 360].
imageryType
- Indique le type d'image. Les valeurs valides sont
indoor
etoutdoor
. date
- Date à laquelle l'image a été prise. Toutes les images ne comportent pas de données de date. Toutefois, lorsqu'il est disponible, ce champ contient une combinaison de l'année (AAAA) et du mois (MM). par exemple 2023-05 ou 2024.
copyright
- Texte des droits d'auteur que vous devez présenter comme attribution avec l'image Street View.
reportProblemLink
- Lien hypertexte permettant aux utilisateurs de signaler les problèmes liés à cette tuile Street View. Vous devez afficher ce lien hypertexte en bas à droite de l'image et inclure un texte du type "Signaler un problème concernant cette image".
addressComponent
- Géocode structuré qui contient des détails sur l'adresse du panorama. Pour en savoir plus, consultez Requêtes et réponses Geocoding dans la documentation de l'API Geocoding.
links
- Liste des identifiants de panorama associés à celui-ci. Contient également le titre sur lequel se trouve le lien. Par exemple, si la direction est à 180°, le panorama lié est dû au sud du panorama actuel. Notez qu'en raison de la nature temporaire des ID de panorama, vous ne devez pas vous en servir pour plusieurs sessions utilisateur.
Miniatures Street View
Vous pouvez demander des images Street View au format thumbnail
. Les miniatures sont des images non juxtaposées dont la taille, le titre, la hauteur et le champ de vision sont définis par l'utilisateur.
Les vignettes ont une résolution inférieure à celle des tuiles et la taille de leur fichier. Pour effectuer une requête de vignette, envoyez une requête GET au point de terminaison thumbnail
, comme illustré dans le prototype de code suivant.
curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId &height=FROM_16_TO_250 &width=FROM_16_TO_600 &pitch=FROM-90_TO_90 &yaw=FROM-360_TO_360 &fov=FROM_30_TO_120"
Prenons l'exemple de code suivant, qui télécharge une vignette d'images Street View prises à Whistler, au Canada.
curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=Zzl28rqGJgaL2IdkUleP8A &height=200 &width=200 &pitch=0 &yaw=250 &fov=80" --output /tmp/example_thumbnail.png
Paramètres obligatoires
panoId
- ID unique de la miniature souhaitée. Vous pouvez obtenir des valeurs d'ID de panorama à partir du point de terminaison
panoIds
ou du point de terminaisonmetadata
, qui acceptent les coordonnées géographiques et renvoient lepanoId
approprié. session
- Jeton de session valide.
key
- Votre clé API.
Paramètres facultatifs
height
- Spécifie la hauteur de la vignette en pixels, comprise entre 16 et 250 pixels. Si vous ne spécifiez pas de hauteur, la hauteur maximale autorisée est de 250 pixels par défaut. Si vous spécifiez une valeur hors plage, la vignette snapse à la valeur valide la plus proche.
width
- Spécifie la largeur de la vignette en pixels, comprise entre 16 et 600 pixels. Si vous ne spécifiez pas de largeur, la largeur est définie par défaut sur la valeur maximale autorisée de 600 pixels. Si vous spécifiez une valeur hors plage, la vignette snapse à la valeur valide la plus proche.
pitch
- Spécifie l'angle de la caméra le long de l'axe vertical. Les valeurs valides sont comprises entre
-90
et90
(inclus). La valeur par défaut est 0. yaw
- Spécifie la direction de la caméra le long de l'axe horizontal. Les valeurs valides sont comprises entre
-360
et360
(inclus). La valeur par défaut est 0. fov
- Spécifie le champ de vision horizontal, exprimé en degrés, avec une valeur maximale de 120. Dans le cas d'une fenêtre d'affichage de taille fixe, comme pour une image Street View d'une taille définie, le champ de vision représente le zoom. Les valeurs plus faibles indiquent un niveau de zoom plus élevé. La valeur par défaut est 90.
Mosaïques d'images Street View
Une fois que vous disposez d'un panoId
, vous pouvez demander une tuile d'image Street View. Les requêtes de tuiles sont des requêtes HTTPS GET. Voici un exemple.
curl "https://tile.googleapis.com/v1/streetview/tiles/z/x/y?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId"
Dans cet exemple de code, z
est le niveau de zoom, et x
et y
sont les coordonnées de tuiles de la tuile Street View qui vous intéresse. Les niveaux de zoom dans les panoramas Street View doivent être compris dans la plage [0,5], 0 représentant le champ de vision le plus large.
Niveau de zoom | Champ de vision approximatif |
---|---|
0 | 360° |
1 | 180 °C |
2 | 90° |
3 | 7 ° |
4 | 22,5 °C |
5 | 11,25 ° |
Réponses Street View Tiles
Une requête de tuile Street View réussie renvoie une image au format et à la taille que vous avez spécifiés dans votre réponse createSession
.
À un niveau de zoom zéro, le panorama entier est redimensionné en une tuile aux dimensions tileWidth
par tileHeight
. Les panoramas étant plus grands dans la dimension x, la tuile contiendra un espace vide en dimension y:
Au niveau de zoom cinq, le panorama en taille réelle est utilisé et divisé en tuiles.
Informations sur les droits d'auteur
Vous devez afficher des informations sur les droits d'auteur sur chaque panorama Street View. La chaîne à afficher peut varier d'un panorama à l'autre. Pour obtenir les informations sur les droits d'auteur, vous devez demander les métadonnées Street View, puis vous pouvez vous référer au champ copyright
de la réponse. Pour en savoir plus, consultez la section Attributions de données.