Tuiles Street View

Exemple Street ViewLes tuiles Street View sont similaires aux Tuiles 2D sauf qu'elles contiennent des images panoramiques prises au niveau de la rue. Avec Street View, vous pouvez explorer des sites célèbres du monde entier et des merveilles de la nature, à l'intérieur de 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. Et vous pouvez interroger jusqu'à 100 identifiants de panorama pour un ensemble. (un itinéraire, par exemple) et obtenir des métadonnées plus détaillées sur la caméra la position de votre annonce.

Une visionneuse est requise pour assembler les tuiles Street View. Par exemple, Street View Visionneuse de panoramas personnalisées.

Une fois que vous disposez d'une clé API, vous pouvez accéder aux images Street View en effectuant les étapes suivantes.

  1. Permet d'obtenir un jeton de session. Assurez-vous que pour définir la valeur de mapType sur streetview.

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

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

    1. Métadonnées Street View : Vous pouvez aussi obtenir des images Street View Affichez les métadonnées en transmettant un ensemble de coordonnées et un rayon.

    2. Vignettes Street View.

    3. Street View Tiles

Méthodes Street View

Vous pouvez accéder aux images et aux métadonnées Street View en appelant l'une des méthodes suivantes : quatre méthodes.

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.

Vous pouvez trouver l'identifiant de panorama d'un ou de plusieurs emplacements géographiques en en transmettant leurs coordonnées (lat, lng) à la méthode panoIds. La demande "body" est un objet JSON contenant 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 (en mètres) définit le rayon du cercle. autour du lieu donné pour 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 identifiants de panorama. Une requête panoIds réussie renvoie une Objet JSON contenant un tableau panoIds. Le tableau contient une liste de les identifiants de panorama, dans l'ordre dans lequel vous les avez demandés. Si l'API Map Tiles aucun panorama trouvé pour les emplacements demandés, un fichier vide est renvoyée à cet emplacement dans le tableau. Pour voir un exemple, consultez la suivant le code JSON.

{
  "panoIds": [
    "ACfH-n2HcBvRry_3oc9grw",
    "f5DJZatBAAAXHlooS2wKbw",
    ""
  ]
}

Vous pouvez utiliser panoIds pour:

Métadonnées Street View

Les requêtes de métadonnées Street View récupèrent des informations sur les panoramas. Une rue La requête de métadonnées d'affichage est une requête GET HTTPS. Vous pouvez récupérer des informations sur les panoramas. Deux possibilités s'offrent à vous:

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

  • Toutefois, si vous transmettez un lat et un lng, l'API Map Tiles renvoie les métadonnées pour le panorama le plus proche dans le rayon de recherche spécifié.

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 identifiants de panorama étant temporaires, nous vous recommandons de transmettre un ensemble de et une valeur radius dans votre requête initiale de métadonnées Street View. L'extrait de code ci-dessous présente un exemple.

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. Ne vous attendez pas à ce que les ID de panorama valable pendant plus d'une session utilisateur.
lat, lng
Coordonnées (latitude et longitude) du panorama. Ces valeurs peuvent être est différente des coordonnées que vous avez transmises dans la requête, car le la position 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ée dans la plage [0,360], où 0 représente l'échéance nord.
tilt
Inclinaison du panorama, mesurée en degrés à partir du pôle Sud du un panorama à 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 de le panorama.
roll
Rotation dans le sens des aiguilles d'une montre autour de la ligne de vision appliquée au 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. Mais quand s'il est disponible, ce champ combine l'année (AAAA) et le mois (MM). Par exemple: 2023-05 ou 2024.
copyright
Texte du copyright que vous devez afficher en tant qu'attribution avec le nom Affichez l'image.
reportProblemLink
Lien hypertexte permettant à vos utilisateurs de signaler des problèmes liés à cette vue Street View . Vous devez afficher ce lien hypertexte dans l'angle inférieur droit de la image et elle doit inclure un texte de lien du type "Signaler un problème" avec cette image".
addressComponent
Une structure Géocode contenant des détails sur l'adresse du panorama. Pour plus d'informations, voir 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 sur où se trouve le lien. Par exemple, si l'orientation est de 180°, le le panorama associé doit se trouver au sud du panorama actuel. Notez qu'en raison de du fait de la nature temporaire des identifiants de panorama, ne vous fiez pas à ceux-ci pour qu'une seule session utilisateur.

Miniatures Street View

Vous pouvez demander des images Street View au format thumbnail. Les miniatures sont des images non en mosaïque avec une taille, un en-tête, un ton et un champ de vision définis par l'utilisateur. Les vignettes ont une résolution inférieure à celle des tuiles et sont plus petites dans le fichier la taille de l'image. Vous effectuez une requête de vignette en envoyant une requête GET à thumbnail. comme le montre 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 de Street View. des images 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

Vignette Street View de Whistler, Canada

Paramètres obligatoires

panoId
ID unique de la miniature souhaitée. Vous pouvez obtenir les valeurs des identifiants des panoramas depuis le point de terminaison panoIds ou depuis le metadata point de terminaison, qui acceptent tous deux des éléments géographiques coordonnées, puis renvoyez 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 valeur par défaut est la la valeur maximale autorisée est de 250 pixels. Si vous spécifiez une valeur hors plage, puis la vignette renvoie à la valeur valide la plus proche.
width
Indique la largeur de la vignette en pixels, comprise entre 16 et 600 pixels. de pixels. Si vous ne spécifiez pas de largeur, la valeur par défaut est la largeur maximale. la valeur autorisée est de 600 pixels. Si vous spécifiez une valeur hors plage, alors la vignette renvoie à la valeur valide la plus proche.
pitch
Spécifie l'angle de l'appareil photo le long de l'axe vertical. Les valeurs valides se trouvent dans La plage -90 à 90 (incluse) La valeur par défaut est 0.
yaw
Spécifie la direction de l'appareil photo le long de l'axe horizontal. Valeurs valides sont compris 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 de 120. Dans le cas d'une fenêtre d'affichage de taille fixe, comme dans le cas d'une vue Street View image d'une taille définie, le champ de vision représente le zoom ; où des valeurs inférieures spécifient 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. Mosaïque 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 correspond au niveau de zoom, et x et y sont les coordonnées des tuiles de la tuile Street View souhaitée. Les niveaux de zoom des panoramas Street View doivent doit être comprise 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°

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é dans votre réponse createSession.

Résultat d'une requête Tile réussie

À un niveau de zoom zéro, le panorama est entièrement redimensionné en tuile de dimensions tileWidth par tileHeight. Comme les panoramas sont plus grands dans la dimension x, la vignette contiendra un espace vide dans la dimension y:

Niveau de zoom zéro

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

Vous devez afficher les informations de droits d'auteur sur chaque panorama Street View. La 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. reportez-vous au champ copyright de la réponse. Pour en savoir plus, consultez Attributions de données :