Tuiles Street View

Les tuiles Street View sont semblables aux tuiles 2D, à la différence qu'elles contiennent des images panoramiques prises au niveau de la rue. Street View vous permet de découvrir des monuments du monde entier et des merveilles naturelles, et de 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 également 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 la caméra.

Une visionneuse est requise pour assembler les tuiles Street View. (par exemple, la visionneuse de panoramas personnalisés Street View).

Conseil :Pour en savoir plus, consultez les pages API Street View Static et Service Street View.

Une fois que vous disposez d'une clé API, vous pouvez accéder aux images Street View en procédant comme suit.

1. Permet d'obtenir un jeton de session. Veillez à définir la valeur de mapType sur streetview.

2. Utilisez le jeton de session pour obtenir l'identifiant de panorama (panoId) d'un ou de plusieurs emplacements géographiques.

3. Utilisez les identifiants de panorama issus de la réponse de recherche panoId pour obtenir:

   1. 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.

   2. Vignettes Street View.

   3. Street View Tiles

Remarque :Vous devez afficher les informations de 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 des métadonnées Street View. Vous pouvez ensuite consulter le champ copyright de la réponse.

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	Affiche les tuiles Street View individuelles. Vous pouvez récupérer des tuiles Street View à six niveaux de zoom: de 512 à 13 312 pixels.
https://tile.googleapis.com/v1/streetview/panoIds	Vous permet de rechercher de manière groupée jusqu'à 100 zones géographiques. Renvoie les identifiants de panorama pour tous les lieux comportant des images.
https://tile.googleapis.com/v1/streetview/thumbnail	Renvoie une vignette au format JPEG d'une scène Street View. Vous permet de fournir un en-tête, un inclinaison, 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 informations incluent l'adresse associée et des liens vers les panoramas adjacents.

Recherche d'identifiants de panorama 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 illustré 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 qui aboutit renvoie un objet JSON contenant un tableau panoIds. Le tableau contient une liste d'identifiants de panoramas, dans l'ordre dans lequel vous les avez demandés. Si l'API Map Tiles ne trouve aucun panorama pour les emplacements demandés, une chaîne vide est renvoyée à cet emplacement 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

Remarque :Les ID de panorama sont temporaires. Autrement dit, elles ne durent pas très longtemps. En règle générale, ne vous basez pas sur la validité des ID de panorama au-delà d'une seule session utilisateur.

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 GET HTTPS. Vous pouvez récupérer des informations sur les panoramas de deux manières:

• Si vous transmettez un pano_id, l'API Map Tiles renvoie les métadonnées de ce panorama.

• Toutefois, si vous transmettez un lat et un lng, 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"

Les ID de panorama étant 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 le panoId 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 dans le corps de la réponse.

panoId

Identifiant unique de ce panorama. Vous ne devez pas compter sur la validité des ID de panorama 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 renvoie 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

Direction de la boussole, mesurée en degrés, dans le sens des aiguilles d'une montre à partir du nord. Les en-têtes sont renvoyés dans la plage [0,360], où 0 représente le nord dû.

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é à l'équateur du panorama.

roll

Rotation dans le sens des aiguilles d'une montre autour de la ligne de vision 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 et outdoor.

date

Date à laquelle l'image a été prise. Toutes les images ne contiennent 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 du copyright que vous devez afficher en tant qu'attribution avec l'image Street View.

reportProblemLink

Lien hypertexte permettant à vos utilisateurs de signaler des problèmes liés à cette tuile Street View. Vous devez afficher ce lien hypertexte dans l'angle inférieur droit de l'image. Il doit inclure un texte de lien du type "Signaler un problème concernant cette image".

addressComponent

Géocode structuré contenant des détails sur l'adresse du panorama. Pour en savoir plus, consultez la section 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 l'en-tête où se trouve le lien. Par exemple, si l'orientation est de 180°, le panorama lié est dû au sud du panorama actuel. Notez qu'en raison de la nature temporaire des identifiants 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 en mosaïque qui ont une taille, un titre, un ton et un champ de vision définis par l'utilisateur. Les vignettes ont une résolution inférieure à celle des tuiles et une taille de fichier inférieure. Vous effectuez une requête de vignette en envoyant une requête GET au point de terminaison thumbnail, comme illustré dans le prototype de code suivant.

Remarque :Les valeurs de champ entre crochets dans cet exemple indiquent des plages. Par exemple, la taille de height est comprise entre 16 et 250 pixels.

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 les valeurs des ID de panorama à partir du point de terminaison panoIds ou du point de terminaison metadata, qui acceptent tous deux les coordonnées géographiques et renvoient le panoId approprié.

session

Un 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 par défaut est définie sur la valeur maximale autorisée de 250 pixels. Si vous spécifiez une valeur hors plage, la vignette s'aligne sur la valeur valide la plus proche.

width

Spécifie la largeur de la vignette en pixels, entre 16 et 600 pixels. Si vous ne spécifiez pas de largeur, la largeur par défaut est définie sur la valeur maximale autorisée de 600 pixels. Si vous spécifiez une valeur hors plage, la vignette s'aligne sur la valeur valide la plus proche.

pitch

Spécifie l'angle de l'appareil photo le long de l'axe vertical. Les valeurs valides sont comprises entre -90 et 90 (inclus). La valeur par défaut est 0.

yaw

Spécifie la direction de l'appareil photo le long de l'axe horizontal. Les valeurs valides sont comprises entre -360 et 360 (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 inférieures 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'une 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 tuile de la tuile Street View souhaitée. Les niveaux de zoom des 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°
2	90°
3	7 °
4	22,5 °
5	11,25°

Remarque : Les images Street View proviennent de deux sources ; Google (images non contrôlées par les développeurs) et les contributeurs publics (contenu généré par l'utilisateur). Notez qu'il n'est pas possible d'utiliser une seule source d'images Street View plutôt que l'autre. En savoir plus sur nos Règles de confidentialité des images Street View

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, l'ensemble du panorama est redimensionné en une tuile de dimensions tileWidth par tileHeight. Comme les panoramas sont plus grands dans la dimension x, la tuile contiendra un espace vide en dimension y:

Au niveau de zoom 5, le panorama en taille réelle est utilisé et divisé en tuiles.

Conseil :Vous pouvez calculer les valeurs maximales de x et y en divisant imageHeight et imageWidth par tileHeight et tileWidth.

Informations sur les droits d'auteur

Vous devez afficher les informations de 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 des métadonnées Street View. Vous pouvez ensuite vous reporter au champ copyright de la réponse. Pour en savoir plus, consultez la section Attributions de données.