Street View-Anfrage und -Antwort

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, dass location 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 gibt size=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 sind 0 bis 360 (beide Werte geben Norden an, 90 gibt Osten und 180 Süden an). Wenn keine Richtung angegeben ist, wird ein Wert berechnet, der die Kamera zum angegebenen location leitet, und zwar von dem Punkt, an dem das nächstgelegene Foto aufgenommen wurde.
  • fov (Standardeinstellung ist 90) bestimmt das horizontale Sichtfeld des Bilds. Das Sichtfeld wird in Grad ausgedrückt. Der maximal zulässige Wert ist 120. 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.


    Screenshot eines breiten Sichtfelds mit Decke, Wänden, Boden und einem Panzerfenster in einem Aquarium. Screenshot eines Sichtfelds in der Nahaufnahme mit einem herangezoomten Detail eines Street View-Fotos in einem Aquarium.
    (Links: fov=120; Rechts: fov=20)

  • pitch (Standardwert 0) 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 (wobei 90 Grad gerade nach oben zeigt); negative Werte versetzen den Winkel der Kamera nach unten (-90 zeigt gerade nach unten).
  • Mit radius (Standardeinstellung 50) 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 sind true und false. Wenn true 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 (Standardeinstellung default) 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
Screenshot eines Aussichtspunkts auf Straßenebene, auf dem elektrifizierte Bahngleise zu sehen sind

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:

Screenshot des allgemeinen Bildes, das angezeigt wird, wenn für den angegebenen Ort kein Bild verfügbar ist Der Hintergrund ist hellbraun und es wird der Text "Leider haben wir hier kein Bildmaterial" angezeigt.
Abbildung: Allgemeines Bild, das angezeigt wird, wenn für den angegebenen Ort kein Bild verfügbar ist

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 auf true 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.