Eine Street View-Bildanfrage ist eine HTTP-URL in folgendem Format:
https://maps.googleapis.com/maps/api/streetview?parameters
Das Bild wird mithilfe von Anforderungsparametern angegeben. Wie bei URLs üblich, werden alle Parameter durch kaufmännische Und-Zeichen (&) voneinander getrennt. Die zulässigen Parameter und deren mögliche Werte sind unten aufgeführt.
Erforderliche Parameter
Entweder:
location
kann entweder ein Textstring (z. B.Chagrin Falls, OH
) oder ein Breiten-/Längenwert (40.457375,-80.009353
) sein und sollte URL-codiert sein. Adressen wie „City Hall, New York, NY“ sollten daher in „City+Hall,New+York,NY“ konvertiert werden, bevor die Anfrage signiert wird. Die Street View Static API fängt das Panorama an, das diesem Standort am nächsten ist. Wenn ein Adresstextstring angegeben wird, kann die API einen anderen Kamerastandort verwenden, um den angegebenen Standort besser anzuzeigen. Wenn ein Längen-/Breitengrad angegeben wird, sucht die API in einem Radius von 50 Metern nach einem Foto, das diesem Standort am nächsten ist. Da die Street View-Bilder regelmäßig aktualisiert werden und Fotos jedes Mal an leicht unterschiedlichen Positionen aufgenommen werden können, ist es möglich, dasslocation
bei der Aktualisierung der Bilder zu einem anderen Panorama wechselt.
Oder:
pano
ist eine spezifische Panorama-ID. Diese sind in der Regel stabil.
Ebenso wie:
size
gibt die Ausgabegröße des Bildes in Pixeln an. Die Größe wird als{width}x{height}
angegeben. Zum Beispiel gibtsize=600x400
ein Bild mit einer Breite von 600 Pixeln und einer Höhe von 400 Pixeln zurück.- Mit
key
können Sie die API-Nutzung Ihrer Anwendung in der Google Cloud Console überwachen und dafür sorgen, dass Google Sie bei Bedarf bezüglich Ihrer Anwendung kontaktieren kann. Weitere Informationen finden Sie unter Schlüssel und Signatur abrufen.
Optionale Parameter
signature
(empfohlen) ist eine digitale Signatur, mit der geprüft wird, ob Anfragen zur Websitegenerierung, bei denen dein API-Schlüssel verwendet wird, entsprechend autorisiert sind. Anfragen ohne digitale Signatur können fehlschlagen. Weitere Informationen finden Sie unter Schlüssel und Signatur anfordern.Hinweis:Für Nutzer der Google Maps Platform-Premiumoption ist die digitale Signatur erforderlich. Weitere Informationen zu Authentifizierungsparametern für Kunden mit der Premiumoption
heading
gibt die Kompassausrichtung der Kamera an. Zulässige Werte sind0
bis360
(beide Werte geben Norden an,90
gibt Osten und180
Süden an). Wenn keine Richtung angegeben ist, wird ein Wert berechnet, der die Kamera zum angegebenenlocation
leitet, und zwar von dem Punkt, an dem das nächstgelegene Foto aufgenommen wurde.fov
(Standardeinstellung ist90
) bestimmt das horizontale Sichtfeld des Bilds. Das Sichtfeld wird in Grad ausgedrückt. Der maximal zulässige Wert ist120
. Bei einem Darstellungsbereich mit fester Größe, wie bei einem Street View-Bild mit einer festgelegten Größe, stellt das Sichtfeld im Wesentlichen den Zoom dar, wobei kleinere Zahlen eine höhere Zoomstufe angeben.
(Links:fov=120
; Rechts:fov=20
)pitch
(Standardwert0
) gibt den Aufwärts- oder Abwärtswinkel der Kamera im Verhältnis zum Street View-Fahrzeug an. Der Winkel ist häufig (aber nicht immer) flach horizontal. Positive Werte versetzen den Winkel der Kamera nach oben (wobei90
Grad gerade nach oben zeigt); negative Werte versetzen den Winkel der Kamera nach unten (-90
zeigt gerade nach unten).- Mit
radius
(Standardeinstellung50
) wird ein in Metern angegebener Radius festgelegt, in dem nach einem Panorama gesucht wird. Der Mittelpunkt ist dabei der angegebene Breiten- und Längengrad. Gültige Werte sind nicht negative Ganzzahlen. return_error_code
gibt an, ob die API einen Fehlercode zurückgeben soll, wenn kein Bild gefunden wird (404 NOT FOUND), oder als Antwort auf eine ungültige Anfrage (400 BAD REQUEST). Gültige Werte sindtrue
undfalse
. Wenntrue
festgelegt ist, wird anstelle des generischen grauen Bildes eine Fehlermeldung zurückgegeben. Dadurch entfällt die Notwendigkeit, einen separaten Aufruf zur Prüfung der Image-Verfügbarkeit durchzuführen.- Bei
source
(Standardeinstellungdefault
) werden Street View-Suchanfragen auf ausgewählte Quellen beschränkt. Gültige Werte:default
verwendet die Standardquellen für Street View. Suchanfragen sind nicht auf bestimmte Quellen beschränkt.outdoor
schränkt die Suchanfragen auf Außenansichten ein. Indoor-Sammlungen werden nicht in die Suchergebnisse aufgenommen. Möglicherweise sind für den angegebenen Ort keine Außenansichten vorhanden. Bei der Suche werden nur Panoramen zurückgegeben, bei denen festgestellt werden kann, ob sie sich im Innen- oder Außenbereich befinden. 360°-Fotos werden beispielsweise nicht zurückgegeben, weil nicht bekannt ist, ob sie sich drinnen oder draußen befinden.
Dies ist eine Beispielanfrage.
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Kein Bild verfügbar
Für Orte, für die keine Street View-Bilder verfügbar sind, gibt die Street View Static API ein graues allgemeines Bild mit dem Text „Leider haben wir keine Bilder hier.“ zurück, wie in diesem Beispiel:
Nur gültige Bilder anzeigen
Gehen Sie so vor, um das allgemeine Bild zu vermeiden und dafür zu sorgen, dass auf Ihrer Webseite nur gültige Street View Static API-Bilder zu sehen sind:
- Legen Sie den Parameter
return_error_code
auftrue
fest. Wenn für den angegebenen Ort kein Bild verfügbar ist, gibt die Street View Static API anstelle des generischen grauen Bildes den Fehler 404 NOT FOUND zurück. - Fordern Sie vor dem Senden einer Anfrage die Street View-Bildmetadaten an, um festzustellen, ob für den angegebenen Ort Bilder verfügbar sind.