Street View-Kacheln

Street View-BeispielStreet View-Kacheln ähneln den 2D-Kacheln mit Ausnahme von Panoramabildern, die auf Straßenebene aufgenommen wurden. Mit Mit Street View können Sie Sehenswürdigkeiten und Naturwunder auf der ganzen Welt erkunden innerhalb von Museen, Sportstadien, Restaurants oder kleinen Unternehmen. Dieser API-Endpunkt bietet Zugriff auf:

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

Sie können Bildkacheln, die Sie auf Straßenebene aufgenommen haben, zu einem wie ein echter Panoramaeffekt. Außerdem können Sie bis zu 100 Panorama-IDs für eine Reihe von Standorten (z. B. einer Route) abrufen und detailliertere Metadaten zur Kamera abrufen .

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

Sobald Sie einen API-Schlüssel haben, können Sie folgendermaßen auf die Street View-Bilder zugreifen: führen Sie die folgenden Schritte aus.

  1. Rufen Sie ein Sitzungstoken ab. Achten Sie darauf, um den Wert von mapType auf streetview zu setzen.

  2. Verwenden Sie das Sitzungstoken, um Rufen Sie die Panoramakennung (panoId) für mindestens einen geografischen Standort ab. Standorte.

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

    1. Street View-Metadaten: Du kannst auch „Street View“ Sie können Metadaten aufrufen, indem Sie einen Satz von 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 Optionen aufrufen: vier Methoden.

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.

Sie können die Panoramakennung für einen oder mehrere geografische Standorte ermitteln, indem Sie und übergeben ihre Koordinaten (lat, lng) an die Methode panoIds. Die Anfrage body ist ein JSON-Objekt, das ein locations-Array und optional ein radius, 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, aber Sie können bis zu 100 weitere angeben.
radius
Der Wert radius (gemessen in Metern) definiert den Radius des Kreises. um den Standort herum, in dem nach Panoramen gesucht werden soll. Der Standardwert 50 Meter.

PanoId-Antwort

Die Map Tiles API versucht, das Panorama zu finden, das dem jeweiligen Standort am nächsten ist, und gibt er ihre Panorama-IDs zurück. Bei einer erfolgreichen panoIds-Anfrage wird ein JSON-Objekt, 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 Map Tiles API keine Panoramen für die von Ihnen angeforderten Standorte finden können, erscheint ein leeres an dieser Stelle im Array zurückgegeben. Ein Beispiel finden Sie in der folgenden JSON-Code.

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

Sie können panoIds für Folgendes verwenden:

Street View-Metadaten

Street View-Metadatenanfragen rufen Informationen über Panoramen ab. Eine Straße Die Anfrage zur Metadatenansicht ist eine HTTPS-GET-Anfrage. Sie können Informationen abrufen, zu Panoramen. Dazu haben Sie zwei Möglichkeiten:

  • Wenn Sie einen pano_id übergeben, gibt die Map Tiles API die Metadaten dafür zurück. -Panorama.

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

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, eine Reihe von Koordinaten und einen radius-Wert. 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 von den Koordinaten unterscheidet, die Sie in der Anfrage übergeben haben, Der Standort wird auf das nächstgelegene Panorama angedockt.
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 sind wird 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 bis zum Horizont. Die zurückgegebenen Werte liegen im Bereich [0, 180]. Ein Wert 90 Grad bedeutet, dass der Horizont bereits am Äquator von ausgerichtet ist. Panoramabild zu machen.
roll
Die Drehung im Uhrzeigersinn um die Sichtlinie, die auf das 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 Sie 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 der Straße als Namensnennung angezeigt werden muss Bild ansehen.
reportProblemLink
Ein Hyperlink, über den Nutzer Probleme mit dieser Street View melden können . Dieser Hyperlink muss in der unteren rechten Ecke des Außerdem muss es einen Linktext wie „Problem melden“ enthalten. mit diesem Bild“.
addressComponent
Eine strukturierte Geocode der Details zur Adresse des Panoramas enthält. Weitere Informationen Siehe Geocoding-Anfragen und -Antworten in der Dokumentation zur Geocoding API.
links
Eine Liste der Panorama-IDs, die mit diesem Panorama verknüpft sind. Enthält auch die Überschrift auf in dem der Link gefunden wird. Wenn die Richtung beispielsweise 180° beträgt, dann ist der liegt südlich des aktuellen Panoramas. Beachten Sie, dass die vorübergehende Panorama-IDs sind, sollten Sie sich nicht auf diese IDs verlassen, als eine einzelne Nutzersitzung.

Street View-Miniaturansichten

Sie können Street View-Bilder im Format thumbnail anfordern. Thumbnails sind nicht gekachelte Bilder mit benutzerdefinierter Größe, Ausrichtung, Neigung und Sichtfeld. Miniaturansichten haben eine niedrigere Auflösung als Kacheln und sind in der Datei kleiner. Größe. Wenn du eine Thumbnail-Anfrage stellen möchtest, sende eine GET-Anfrage an thumbnail wie im folgenden Codeprototyp 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"

Sehen Sie sich das folgende Codebeispiel an, mit dem eine Miniaturansicht von Street View heruntergeladen wird. 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

Street View-Miniaturansicht von Whistler, Kanada

Erforderliche Parameter

panoId
Die eindeutige ID des gewünschten Thumbnails. Sie können Panorama-ID-Werte abrufen. vom panoIds-Endpunkt oder vom metadata-Endpunkt – beide akzeptieren geografische -Koordinaten und geben die entsprechenden panoId-Werte 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 16 Pixeln) 250 Pixel. Wenn Sie keine Höhe angeben, wird für die Höhe standardmäßig die Der maximal zulässige Wert beträgt 250 Pixel. Wenn Sie einen Wert angeben, der außerhalb des zulässigen Bereichs liegt, wird die Miniaturansicht an den nächsten gültigen Wert angedockt.
width
Gibt die Breite der Miniaturansicht in Pixeln an (zwischen 16 und 600 Pixeln) Pixel. Wenn Sie keine Breite angeben, wird standardmäßig die maximale zulässigen Wert von 600 Pixeln. Wenn du einen Wert angibst, der außerhalb des zulässigen Bereichs liegt, Die Miniaturansicht wird an den nächsten gültigen Wert angedockt.
pitch
Gibt den Winkel der Kamera entlang der vertikalen Achse an. Gültige Werte sind in den Bereich -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 Maximum an Wert 120 haben. Bei einem Darstellungsbereich mit fester Größe, wie bei Street View Bild einer festgelegten Größe; das Sichtfeld repräsentiert den Zoom; wobei kleinere Werte Zoomstufen erhöhen. Der Standardwert ist 90.

Street View-Bildkacheln

Sobald du ein panoId hast, kannst du eine Street View-Bildkachel anfordern. Fliesen/Kacheln -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 sind die Kachelkoordinaten der gewünschten Street View-Kachel. 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
4 22,5°
5 11,25°

Antworten auf Street View-Kacheln

Eine erfolgreiche Street View-Kachelanforderung gibt ein Bild mit dem Format und der Größe zurück. die Sie in Ihrer createSession-Antwort angegeben haben.

Das Ergebnis einer erfolgreichen Tile-Anforderung

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

Zoomstufe 0

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

Sie müssen Urheberrechtsinformationen für jedes Street View-Panorama anzeigen. Die kann je nach Panorama variieren. Um die Urheberrechtsinformationen zu erhalten, müssen Sie Street View-Metadaten anfordern. Anschließend können Sie sich auf das Feld copyright der Antwort beziehen. Weitere Informationen finden Sie unter Quellenangaben für Daten: