Street View-Kacheln

Street View-Kacheln ähneln 2D-Kacheln mit dem Unterschied, dass sie Panoramabilder auf Straßenebene enthalten. Mit Street View können Sie Sehenswürdigkeiten und Naturwunder auf der ganzen Welt erkunden und Orte wie Museen, Sportstadien, Restaurants oder kleine Unternehmen betreten. Dieser API-Endpunkt bietet Zugriff auf:

• Street View-Kacheln in Google Maps
• 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 verschiedene Orte (z. B. eine Route) abfragen und so detailliertere Metadaten zur Kameraposition abrufen.

Ein Viewer muss Street View-Kacheln zusammenfügen. Beispiel: den Viewer für benutzerdefinierte Street View-Panoramen

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

Sobald Sie einen API-Schlüssel haben, können Sie mit den folgenden Schritten 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 zu erhalten:

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

   2. Street View-Miniaturansichten:

   3. Street View-Kacheln:

Hinweis :Sie müssen für jedes Street View-Panorama Urheberrechtsinformationen anzeigen. Die anzuzeigende Zeichenfolge kann je nach Panorama unterschiedlich sein. Wenn du Urheberrechtsinformationen abrufen möchtest, musst du Street View-Metadaten anfordern und im Feld copyright der Antwort nachsehen.

Street View-Methoden

Sie können mit einer der folgenden vier Methoden auf Street View-Bilder und -Metadaten zugreifen.

Methode	Beschreibung
https://tile.googleapis.com/v1/streetview/tiles	Gibt die einzelnen Street View-Kacheln zurück. Street View-Kacheln können in sechs Zoomstufen abgerufen werden: von 512 bis 13.312 Pixeln.
https://tile.googleapis.com/v1/streetview/panoIds	Bulk-Suche nach bis zu 100 Standorten möglich. Gibt Panorama-IDs für alle Standorte mit Bildern zurück.
https://tile.googleapis.com/v1/streetview/thumbnail	Gibt ein JPEG-Thumbnail einer Street View-Szene zurück. Hier können Sie eine Überschrift, Neigung, Abmessungen und ein Sichtfeld angeben. Mindestabmessungen sind 16 x 16 Pixel. Die maximal zulässigen Abmessungen betragen 250 x 600 Pixel.
https://tile.googleapis.com/v1/streetview/metadata	Liefert detaillierte Informationen zum angegebenen Panorama. Zu den Details gehören die zugehörige Adresse und Links zu angrenzenden Panoramabildern.

Suche mit panoIds in Street View

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

PanoId-Antwort

Die Map Tiles API versucht, das Panorama zu finden, das dem jeweiligen Standort am nächsten liegt, 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 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-Thumbnails anfordern
• Street View-Kacheln anfordern

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

Street View-Metadaten

Street View-Metadatenanfragen rufen Informationen über Panoramen ab. Eine Street View-Metadatenanfrage ist eine HTTPS-GET-Anfrage. Sie haben zwei Möglichkeiten, Informationen zu Panoramen abzurufen:

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

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

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 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 ausgehend von Norden. Ü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 bis 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 auszugleichen. 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 Urheberrechtstext, 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 wie „Problem mit diesem Bild melden“ enthalten.

addressComponent

Ein strukturierter Geocode mit Details zur Adresse des Panoramas. Weitere Informationen finden Sie in der Dokumentation zur Geocoding API 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 der Link zu finden ist. Wenn die Richtung beispielsweise 180 ° beträgt, liegt das verknüpfte Panorama südlich des aktuellen Panoramas. Aufgrund der vorübergehenden Natur von Panorama-IDs sollten Sie sich nicht auf länger als eine einzelne Nutzersitzung verlassen.

Street View-Miniaturansichten

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

Hinweis: Die in diesem Beispiel in eckigen Klammern eingeschlossenen Feldwerte stellen Bereiche dar. Beispielsweise kann height 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"

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

session

Ein gültiges Sitzungstoken.

key

Ihren 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 die Höhe standardmäßig auf den maximal zulässigen Wert von 250 Pixeln festgelegt. Wenn Sie einen Wert angeben, der außerhalb des Bereichs liegt, wird die Miniaturansicht auf den nächsten gültigen Wert angedockt.

width

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

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

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

fov

Gibt das horizontale Sichtfeld in Grad mit einem Höchstwert von 120 an. Bei einem Darstellungsbereich mit fester Größe, wie bei einem Street View-Bild mit festgelegter 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 ein panoId hast, kannst du eine Street View-Bildkachel anfordern. Tile-Anfragen 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 das breiteste Sichtfeld darstellt.

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 auf Street View-Kacheln

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

Bei Zoomstufe 0 wird die Größe des gesamten Panoramas auf eine Kachel mit den Abmessungen tileWidth x tileHeight angepasst. Da Panoramen in der x-Dimension größer sind, enthält die Kachel Leerraum in der y-Dimension:

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

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

Informationen zum Urheberrecht

Sie müssen Urheberrechtsinformationen für jedes Street View-Panorama anzeigen. Die anzuzeigende Zeichenfolge kann je nach Panorama unterschiedlich sein. Zum Abrufen der Urheberrechtsinformationen müssen Sie Street View-Metadaten anfordern und im Feld copyright der Antwort nachsehen. Weitere Informationen finden Sie unter Datenattribution.