Street View-Kacheln

Street View-Kacheln ähneln 2D-Kacheln, enthalten aber Panoramabilder, die auf Straßenebene aufgenommen wurden. Mit Google Street View können Sie Sehenswürdigkeiten und Naturwunder auf der ganzen Welt entdecken sowie Museen, Sportstadien, Restaurants oder kleinen Geschäften einen virtuellen Besuch abstatten. Dieser API-Endpunkt bietet Zugriff auf:

• Google Maps Street View-Kacheln
• Street View-Metadaten
• Street View-Miniaturansichten

Sie können Bildkacheln aus der Straßenebene aus zusammenfügen, um einen realen Panoramaeffekt zu erzeugen. Außerdem können Sie bis zu 100 Panorama-IDs für eine Reihe von Orten (z. B. eine Route) abfragen und detailliertere Metadaten zur Kameraposition erhalten.

Street View-Kacheln müssen von einem Betrachter zusammengesetzt werden. Beispielsweise der benutzerdefinierte Panorama-Viewer von Street View.

Sobald Sie einen API-Schlüssel haben, können Sie mit den folgenden Schritten auf die Street View-Bilder zugreifen.

1. Rufe ein Sitzungstoken ab. Legen Sie für mapType den Wert streetview fest.

2. Verwenden Sie das Sitzungstoken, um die Panorama-ID (panoId) eines oder mehrerer geografischer Standorte abzurufen.

3. Verwenden Sie die Panorama-IDs aus der Antwort der Suche nach „panoId“, um Folgendes abzurufen:

   1. Street View-Metadaten: Sie können auch Metadaten für Street View abrufen, indem Sie Koordinaten und einen Radius übergeben.

   2. Street View-Miniaturansichten

   3. Street View-Kacheln

Street View-Methoden

Sie können auf Street View-Bilder und -Metadaten zugreifen, indem Sie eine der folgenden vier Methoden aufrufen.

Suche nach Street View-panoIds

Sie können die Panorama-ID eines oder mehrerer geografischer Standorte ermitteln, indem Sie die Koordinaten (lat, lng) an die panoIds-Methode übergeben. Der Anfragekörper ist ein JSON-Objekt, das ein locations-Array und optional eine radius enthält, wie im folgenden JSON-Codebeispiel gezeigt.

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

Das locations-Array muss mindestens einen Satz von Koordinatenwerten enthalten, Sie können aber auch mehr hinzufügen – bis zu maximal 100.

radius

Der Wert radius (gemessen in Metern) definiert den Radius des Kreises um den gegebenen Standort, in dem nach Panoramen gesucht wird. Der Standardwert ist 50 Meter.

Antwort mit PanoId

Die Map Tiles API versucht, das dem jeweiligen Standort am nächsten gelegene Panorama zu finden, und gibt dann die entsprechenden Panorama-IDs zurück. Eine erfolgreiche panoIds-Anfrage gibt ein JSON-Objekt zurück, das ein panoIds-Array enthält. Das Array enthält eine Liste von Panorama-IDs in der Reihenfolge, in der Sie sie angefordert haben. Wenn die Map Tiles API keine Panoramen für die von Ihnen angeforderten Standorte finden kann, wird an diesem Ort im Array ein leerer String zurückgegeben. Ein Beispiel finden Sie im folgenden JSON-Code.

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

Sie können panoIds für Folgendes verwenden:

• Street View-Metadaten anfordern
• Street View-Miniaturansichten anfordern
• Street View-Kacheln anfordern

Street View-Metadaten

Über Street View-Metadatenanfragen werden Informationen zu Panoramen abgerufen. Eine Anfrage für Street View-Metadaten ist eine HTTPS-GET-Anfrage. Sie haben zwei Möglichkeiten, Informationen zu Panoramen abzurufen:

• Wenn Sie eine pano_id übergeben, gibt die Map Tiles API die Metadaten für dieses Panorama zurück.

• Wenn Sie jedoch lat und lng übergeben, gibt die Map Tiles API die Metadaten für das nächstgelegene Panorama innerhalb des angegebenen Suchradius zurück.

Koordinaten und Radius übergeben

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&lat=lat&lng=lng&radius=meters"

Da Panorama-IDs vorübergehend sind, empfehlen wir, in Ihrer ersten Street View-Metadatenanfrage eine Reihe von Koordinaten und einen radius-Wert zu übergeben. Ein Beispiel finden Sie im folgenden Code-Snippet.

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&lat=47.62066&lng=-122.34923&radius=50"

PanoId eines Street View-Bilds übergeben

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId"

Metadatenantwort

Der folgende JSON-Code ist ein Beispiel für eine typische Metadatenantwort.

{
 "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"
  }
 ]
}

In der folgenden Liste sind die Felder im Antworttext definiert.

panoId

Die eindeutige ID dieses Panoramas. Sie sollten nicht davon ausgehen, dass Panorama-IDs länger als eine einzelne Nutzersitzung gültig sind.

lat, lng

Die Koordinaten (Breiten- und Längengrad) des Panoramas. Diese Werte können sich von den Koordinaten unterscheiden, die Sie in der Anfrage übergeben haben, da der Standort auf das nächstgelegene Panorama angedockt wird.

imageHeight, imageWidth

Die Abmessungen des zusammengefügten Panoramabilds.

tileHeight, tileWidth

Die Abmessungen einer einzelnen Panoramakachel.

heading

Die Kompassrichtung, gemessen in Grad im Uhrzeigersinn von Norden aus. Überschriften werden im Bereich [0,360] zurückgegeben, wobei 0 für den Norden steht.

tilt

Die Neigung des Panoramas, gemessen in Grad vom Südpol des Panoramas zum Horizont. Die zurückgegebenen Werte liegen im Bereich [0, 180]. Ein Wert von 90 Grad gibt an, dass der Horizont bereits am Äquator des Panoramas ausgerichtet ist.

roll

Die Drehung im Uhrzeigersinn um die Sichtlinie, die auf das Panorama angewendet wurde, um den Horizont zu nivellieren. Die zurückgegebenen Werte liegen im Bereich [0, 360].

imageryType

Gibt den Bildtyp an. Gültige Werte sind indoor und outdoor.

date

Das Datum, an dem das Bild aufgenommen wurde. Nicht alle Bilder haben Datumsangaben. Wenn es jedoch verfügbar ist, enthält dieses Feld eine Kombination aus Jahr (JJJJ) und Monat (MM). Beispiel: 2023-05 oder 2024.

copyright

Der Urheberrechtshinweis, der zusammen mit dem Street View-Bild als Quellenangabe angezeigt werden muss.

reportProblemLink

Ein Hyperlink, über den Nutzer Probleme mit dieser Street View-Kachel melden können. Dieser Hyperlink muss rechts unten im Bild angezeigt werden und einen Linktext enthalten, der etwa „Problem mit diesem Bild melden“ lautet.

addressComponent

Ein strukturierter Geocode mit Details zur Adresse des Panoramas. Weitere Informationen finden Sie in der Geocoding API-Dokumentation unter Geocoding-Anfragen und ‑Antworten.

links

Eine Liste der Panorama-IDs, die mit diesem Panorama verknüpft sind. Enthält auch die Überschrift, unter der sich der Link befindet. Wenn die Richtung beispielsweise 180 Grad beträgt, liegt das verknüpfte Panorama genau südlich des aktuellen Panoramas. Aufgrund der vorübergehenden Natur von Panorama-IDs sollten Sie diese nicht für mehr als eine Nutzersitzung verwenden.

Street View-Miniaturansichten

Sie können Street View-Bilder im thumbnail-Format anfordern. Thumbnails sind nicht gekachelte Bilder mit benutzerdefinierter Größe, Überschrift, Neigung und Sichtfeld. Thumbnails haben eine niedrigere Auflösung als Kacheln und sind kleiner. Du sendest eine GET-Anfrage an den Endpunkt thumbnail, um ein Thumbnail anzufordern, wie im folgenden Code-Prototyp gezeigt.

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"

Im folgenden Codebeispiel wird ein Thumbnail von Street View-Bildern heruntergeladen, die in Whistler, Kanada, aufgenommen wurden.

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

Erforderliche Parameter

panoId

Die eindeutige ID des gewünschten Thumbnails. Sie können Panorama-ID-Werte über den panoIds-Endpunkt oder den metadata-Endpunkt abrufen. Beide akzeptieren geografische Koordinaten und geben die entsprechende panoId zurück.

session

Ein gültiges Sitzungstoken.

key

Ihr API-Schlüssel.

Optionale Parameter

height

Gibt die Höhe der Miniaturansicht in Pixeln zwischen 16 und 250 Pixeln an. Wenn Sie keine Höhe angeben, wird standardmäßig der maximal zulässige Wert von 250 Pixeln verwendet. Wenn Sie einen Wert außerhalb des zulässigen Bereichs angeben, wird das Thumbnail auf den nächstgelegenen gültigen Wert gesetzt.

width

Gibt die Breite der Miniaturansicht in Pixeln zwischen 16 und 600 Pixeln an. Wenn Sie keine Breite angeben, wird standardmäßig der maximal zulässige Wert von 600 Pixeln verwendet. Wenn Sie einen Wert außerhalb des zulässigen Bereichs angeben, wird das Thumbnail auf den nächstgelegenen gültigen Wert gesetzt.

pitch

Gibt den Winkel der Kamera entlang der vertikalen Achse an. Gültige Werte liegen im Bereich von -90 bis 90 (einschließlich). Der Standardwert ist 0.

yaw

Gibt die Richtung der Kamera entlang der horizontalen Achse an. Gültige Werte liegen im Bereich von -360 bis 360 (einschließlich). Der Standardwert ist „0“.

fov

Gibt das horizontale Sichtfeld in Grad an, mit einem Maximalwert von 120. Bei einem Darstellungsbereich mit fester Größe, z. B. bei einem Street View-Bild mit einer festgelegten Größe, entspricht das Sichtfeld dem Zoom. Kleinere Werte stehen dabei für einen höheren Zoom. Der Standardwert ist 90.

Street View-Bildkacheln

Sobald Sie eine panoId haben, können Sie eine Street View-Bildkachel anfordern. Kachelanfragen sind HTTPS-GET-Anfragen. Dazu ein Beispiel:

curl "https://tile.googleapis.com/v1/streetview/tiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId"

In diesem Codebeispiel ist z die Zoomstufe und x und y sind die Kachelkoordinaten der gewünschten Street View-Kachel. Die Zoomstufen in Street View-Panoramas müssen im Bereich [0,5] liegen. Dabei steht 0 für das größte Sichtfeld.

Antworten von Street View-Kacheln

Bei einer erfolgreichen Anfrage für Street View-Kacheln wird ein Bild im Format und in der Größe zurückgegeben, die Sie in Ihrer createSession-Antwort angegeben haben.

Bei Zoomstufe 0 wird das gesamte Panorama auf eine Kachel mit den Abmessungen tileWidth × tileHeight skaliert. Da Panoramen in der X-Achse größer sind, enthält die Kachel in der Y-Achse einen leeren Bereich:

Bei Zoomstufe 5 wird das Panorama in Originalgröße verwendet und in Kacheln unterteilt.

Informationen zum Urheberrecht

Sie müssen bei jedem Street View-Panorama Urheberrechtshinweise angeben. Der anzuzeigende String kann sich von Panorama zu Panorama unterscheiden. Zum Abrufen der Urheberrechtsinformationen müssen Sie Street View-Metadaten anfordern und im Feld copyright der Antwort nachsehen. Weitere Informationen finden Sie unter Datenattribution.