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. Über diesen API-Endpunkt erhalten Sie Zugriff auf:

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

Sie können Bildkacheln, die auf Straßenebene aufgenommen wurden, zusammenfügen, um einen realistischen Panoramaeffekt zu erzielen. 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.

Methode	Beschreibung
https://tile.googleapis.com/v1/streetview/tiles	Die einzelnen Street View-Kacheln werden zurückgegeben. Sie können Street View-Kacheln in sechs Zoomstufen abrufen: von 512 Pixeln bis 13.312 Pixeln.
https://tile.googleapis.com/v1/streetview/panoIds	Sie können nach bis zu 100 Standorten gleichzeitig suchen. Gibt Panorama-IDs für alle Orte mit Bildern zurück.
https://tile.googleapis.com/v1/streetview/thumbnail	Ein JPEG-Miniaturbild einer Street View-Szene. Hier können Sie eine Richtung, einen Neigungswinkel, Abmessungen und ein Sichtfeld angeben. Die Mindestabmessungen sind 16 × 16 Pixel. Die maximalen Abmessungen sind 250 × 600 Pixel.
https://tile.googleapis.com/v1/streetview/metadata	Enthält detaillierte Informationen zum angegebenen Panorama. Zu den Details gehören die zugehörige Adresse und Links zu benachbarten Panoramen.

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 (in Metern) definiert den Radius des Kreises um den angegebenen Ort, in dem nach Panoramen gesucht werden soll. 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 Panoramas für die angeforderten Orte findet, wird an dieser Stelle im Array ein leerer String zurückgegeben. Ein Beispiel finden Sie im folgenden JSON-Code.

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

Mit panoIds können Sie Folgendes tun:

• 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ächste 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 nicht dauerhaft sind, empfehlen wir Ihnen, in Ihrer ersten Street View-Metadatenanfrage Koordinaten und einen radius-Wert anzugeben. 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 von den Koordinaten abweichen, die Sie in der Anfrage übergeben haben, da der Standort an das nächste 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. Die Richtungen werden im Bereich [0,360] zurückgegeben, wobei 0 den wahren Norden darstellt.

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 Datumsdaten. Wenn es verfügbar ist, enthält dieses Feld jedoch 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 des Thumbnails in Pixeln an. Sie kann zwischen 16 und 250 Pixel betragen. 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 des Thumbnails in Pixeln an. Sie kann zwischen 16 und 600 Pixel betragen. 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, steht das Sichtfeld für den Zoom. Kleinere Werte geben einen höheren Zoom an. 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.

Zoomfaktor	Ungefähres Sichtfeld
0	360°
1	180°
2	90°
3	7°
4	22,5°
5	11,25°

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. Wenn Sie die Urheberrechtsinformationen abrufen möchten, müssen Sie Street View-Metadaten anfordern. Sie finden sie dann im Feld copyright der Antwort. Weitere Informationen finden Sie unter Datenzuordnungen.