Street View-Kacheln

Street View-Kacheln ähneln 2D-Kacheln, enthalten jedoch Panoramabilder, die auf Straßenebene aufgenommen wurden. Mit Street View können Sie Sehenswürdigkeiten auf der ganzen Welt erkunden, Naturwunder bestaunen und Orte wie Museen, Sportstadien, Restaurants oder kleine Geschäfte besichtigen. Dieser API-Endpunkt bietet Zugriff auf:

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

Sie können von Straßen aus aufgenommene Bildkacheln zu einem realen Panoramaeffekt zusammenfügen. Außerdem können Sie bis zu 100 Panorama-IDs für einen Satz von Orten (z. B. eine Route) abfragen und detailliertere Metadaten zur Kameraposition abrufen.

Zum Zusammenfügen von Street View-Kacheln ist ein Viewer erforderlich. Das kann z. B. der benutzerdefinierte Street View-Panorama-Viewer sein.

Tipp :Weitere Informationen finden Sie unter Street View Static API und Street View-Dienst.

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

1. Rufen Sie ein Sitzungstoken ab. Legen Sie den Wert von mapType auf streetview fest.

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

3. Verwenden Sie die Panoramakennungen aus der panoId-Suchantwort, um Folgendes abzurufen:

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

   2. Street View-Thumbnails:

   3. Street View-Kacheln

Hinweis :Urheberrechtsinformationen müssen für jedes Street View-Panorama angezeigt werden. Der anzuzeigende String kann je nach Panorama variieren. Um die Urheberrechtsinformationen zu erhalten, müssen Sie Street View-Metadaten anfordern. Anschließend können Sie auf das Feld copyright der Antwort verweisen.

Street View-Methoden

Sie haben die folgenden vier Methoden, um auf Street View-Bilder und -Metadaten zuzugreifen.

Methode	Beschreibung
https://tile.googleapis.com/v1/streetview/tiles	Gibt die einzelnen Street View-Kacheln zurück. Sie können Street View-Kacheln in sechs Zoomstufen abrufen: von 512 bis 13.312 Pixel.
https://tile.googleapis.com/v1/streetview/panoIds	Ermöglicht die gleichzeitige Suche nach bis zu 100 Standorten. Gibt Panorama-IDs für alle Standorte mit Bildern zurück.
https://tile.googleapis.com/v1/streetview/thumbnail	Gibt eine JPEG-Miniaturansicht einer Street View-Szene zurück. Hier können Sie eine Überschrift, Neigung, Abmessungen und ein Sichtfeld angeben. Die Mindestgröße beträgt 16 x 16 Pixel. Die maximale Größe beträgt 250 x 600 Pixel.
https://tile.googleapis.com/v1/streetview/metadata	Liefert detaillierte Informationen über das angegebene Panorama. Die Details umfassen die zugehörige Adresse und Links zu angrenzenden Panoramabildern.

Street View panoIds-Suche

Sie können die Panorama-ID eines oder mehrerer geografischer Standorte ermitteln, indem Sie deren Koordinaten (lat, lng) an die Methode panoIds übergeben. Der Anfragetext ist ein JSON-Objekt, das ein locations-Array und optional ein radius-Objekt 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 Array locations muss mindestens einen Satz von Koordinatenwerten enthalten. Sie können aber auch weitere Koordinatenwerte angeben – bis zu 100.

radius

Der Wert radius (gemessen in Metern) definiert den Radius des Kreises um den angegebenen Ort, in dem nach Panoramen gesucht werden soll. Der Standardwert ist 50 Meter.

PanoId-Antwort

Die Map Tiles API versucht, das Panorama zu finden, das jedem Standort am nächsten ist, und gibt dann die zugehörigen 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 mit Panorama-IDs in der Reihenfolge, in der Sie sie angefordert haben. Wenn die Map Tiles API für die von Ihnen angeforderten Standorte keine Panoramen finden kann, wird an diesem Standort im Array ein leerer String zurückgegeben. Ein Beispiel findest du im folgenden JSON-Code.

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

Sie können panoIds für Folgendes verwenden:

• Street View-Metadaten anfordern
• Street View-Thumbnails anfordern
• Street View-Kacheln anfordern

Hinweis :Panorama-IDs sind vorübergehend. Das heißt, sie gelten nur kurz. Generell sollten Sie sich nicht darauf verlassen, dass Panorama-IDs länger als eine einzelne Nutzersitzung gültig sind.

Street View-Metadaten

Mit Street View-Metadatenanfragen werden Informationen zu Panoramen abgerufen. Eine Street View-Metadatenanfrage ist eine HTTPS GET-Anfrage. Es gibt zwei Möglichkeiten, Informationen zu Panoramabildern abzurufen:

• Wenn Sie ein 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.

Einen Satz von Koordinaten und einen 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 der ersten Street View-Metadatenanfrage einen Satz 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"
  }
 ]
}

Die folgende Liste enthält Definitionen der Felder im Antworttext.

panoId

Die eindeutige ID dieses Panoramas. Sie sollten sich nicht darauf verlassen, 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 Ort auf das nächstgelegene Panorama angedockt wird.

imageHeight, imageWidth

Die Abmessungen des zusammengefügten Panoramabilds

tileHeight, tileWidth

Die Abmessungen einer einzelnen Panoramakachel

heading

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

tilt

Die Neigung des Panoramas, gemessen in Grad vom Südpol des Panoramas bis zum Horizont. Die zurückgegebenen Werte liegen im Bereich [0, 180]. Ein Wert von 90 Grad bedeutet, 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 auszugleichen. Die zurückgegebenen Werte liegen im Bereich [0, 360].

imageryType

Gibt den Typ des Bildes an. Gültige Werte sind indoor und outdoor.

date

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

copyright

Der Urheberrechtstext, den Sie zusammen mit dem Street View-Bild als Quellenangabe angeben müssen

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 wie zum Beispiel „Problem mit diesem Bild melden“ enthalten.

addressComponent

Ein strukturierter Geocode, der Details zur Adresse des Panoramas enthält. Weitere Informationen finden Sie in der Dokumentation zur Geocoding API unter Geocoding-Anfragen und -Antworten.

links

Eine Liste mit Panorama-IDs, die mit diesem Panorama verknüpft sind. Enthält auch die Überschrift, in der sich der Link befindet. Wenn die Ausrichtung beispielsweise 180° beträgt, liegt das verknüpfte Panorama südlich des aktuellen Panoramas. Da Panorama-IDs nur vorübergehend verwendet werden, sollten Sie sich nicht für mehr als eine einzelne Nutzersitzung auf sie verlassen.

Street View-Miniaturansichten

Sie können Street View-Bilder im thumbnail-Format anfordern. Miniaturansichten sind nicht gekachelte Bilder mit benutzerdefinierter Größe, Richtung, Neigung und Sichtfeld. Miniaturansichten haben eine geringere Auflösung als Kacheln und sind kleiner. Sie stellen eine Miniaturansichtsanfrage, indem Sie eine GET-Anfrage an den Endpunkt thumbnail senden, wie im folgenden Codeprototyp gezeigt.

Hinweis: Die in diesem Beispiel in eckigen Klammern eingeschlossenen Feldwerte beziehen sich auf Bereiche. height kann beispielsweise zwischen 16 und 250 Pixeln liegen.

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 eine Miniaturansicht 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 vom Endpunkt panoIds oder vom Endpunkt metadata abrufen. Beide akzeptieren geografische Koordinaten und geben den entsprechenden panoId-Wert zurück.

session

Ein gültiges Sitzungstoken.

key

Ihren API-Schlüssel.

Optionale Parameter

height

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

width

Gibt die Breite der Miniaturansicht in Pixeln an (zwischen 16 und 600 Pixeln). Wenn Sie keine Breite angeben, wird standardmäßig der maximal zulässige Wert von 600 Pixeln verwendet. Wenn Sie einen Wert angeben, der außerhalb des Bereichs liegt, wird die Miniaturansicht am nächsten gültigen Wert angedockt.

pitch

Gibt den Winkel der Kamera entlang der vertikalen Achse an. Gültige Werte liegen im Bereich -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 -360 bis 360 (einschließlich). Der Standardwert ist 0.

fov

Gibt das horizontale Sichtfeld in Grad an, mit einem Höchstwert von 120. Bei einem Darstellungsbereich mit fester Größe, wie bei einem Street View-Bild einer festgelegten Größe, stellt das Sichtfeld den Zoom dar, wobei kleinere Werte eine höhere Zoomstufe angeben. Der Standardwert ist 90.

Street View-Bildkacheln

Sobald du eine panoId hast, kannst du 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 die Kachelkoordinaten der gewünschten Street View-Kachel. Die Zoomstufen in Street View-Panoramen müssen im Bereich [0,5] liegen, wobei 0 für das größte Sichtfeld steht.

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

Hinweis: Street View-Bilder stammen aus zwei Quellen: von Google (nicht öffentliche, vom Entwickler verwaltete Bilder) und von Beitragenden (öffentliche, von Nutzern erstellte Inhalte). Es ist nicht möglich, nur eine Quelle von Street View-Bildern zu verwenden. Weitere Informationen zur Datenschutzerklärung von Street View

Antworten für Street View-Kacheln

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

Bei Zoomstufe 0 wird die Größe des gesamten Panoramas in eine Kachel der Abmessungen tileWidth x tileHeight umgewandelt. Da Panoramen in der x-Dimension größer sind, enthält die Kachel in der y-Dimension einen leeren Raum:

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

Tipp: Sie können die maximalen Werte für x und y berechnen, indem Sie imageHeight und imageWidth durch tileHeight und tileWidth teilen.

Informationen zum Urheberrecht

Urheberrechtsinformationen müssen für jedes Street View-Panorama angezeigt werden. Der anzuzeigende String kann je nach Panorama variieren. Um die Urheberrechtsinformationen zu erhalten, müssen Sie Street View-Metadaten anfordern. Anschließend können Sie im Feld copyright der Antwort darauf zurückgreifen. Weitere Informationen finden Sie unter Datenattributionen.