Street View-Anfrage und -Antwort

Eine Street View-Bildanfrage ist eine HTTP-URL im folgenden 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 (&) 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- und Längengrad-Koordinatenpaar (40.457375,-80.009353) sein und sollte URL-codiert sein. Konvertieren Sie also Adressen wie „City Hall, New York, NY“ in „City+Hall,New+York,NY“, bevor Sie die Anfrage senden. Die Street View Static API verwendet dann das Panoramafoto, das dem Standort am nächsten ist. Wenn Sie einen Adresstextstring angeben, verwendet die API möglicherweise einen anderen Kamerastandort, um den angegebenen Standort besser anzuzeigen. Wenn Sie Breiten- und Längengrade angeben, sucht die API in einem Umkreis von 50 Metern nach einem Foto, das dem Standort am nächsten ist. Street View-Bilder werden regelmäßig aktualisiert und Fotos können jedes Mal an leicht anderen Positionen aufgenommen werden. Daher ist es möglich, dass location beim Aktualisieren von Bildern ein anderes Panorama annimmt.

Oder:

  • pano ist eine spezifische Panorama-ID. Die ID von Panoramen kann sich im Laufe der Zeit ändern. Behalten Sie diese ID daher nicht bei. Speichern Sie stattdessen die Standortadresse oder die Breiten- und Längengrade, damit Sie die Panorama-ID aktualisieren können. Weitere Informationen finden Sie unter Gelöschte Panorama-IDs aktualisieren.

Ebenso wie:

  • size gibt die Ausgabegröße des Bildes in Pixeln an. Die Größe wird als {width}x{height} angegeben. Beispielsweise gibt size=600x400 ein Bild mit einer Breite von 600 Pixeln und einem Bild mit einer Höhe von 400 Pixeln zurück.
  • Mit key können Sie die API-Nutzung Ihrer Anwendung in der Google Cloud Console beobachten und dafür sorgen, dass Google Sie bei Bedarf bezüglich Ihrer Anwendung kontaktieren kann. Weitere Informationen finden Sie unter Schlüssel und Signatur anfordern.

Gelöschte Panorama-IDs aktualisieren

Wenn Sie beim Abrufen einer Panorama-ID entweder ZERO_RESULTS oder keinen Wert erhalten, wurde die Panorama-ID gelöscht und muss aktualisiert werden.

  1. Speichern Sie die Standortadresse oder die Breiten- und Längengrade, die Sie zum Abrufen einer Panorama-ID verwendet haben, damit Sie sie bei Bedarf aktualisieren können.

  2. Wenn Sie feststellen, dass sich eine Panorama-ID geändert hat, suchen Sie anhand der ursprünglichen Standortadresse oder den Breiten- und Längengradkoordinaten noch einmal nach den nächstgelegenen Panoramen und rufen Sie eine neue Panorama-ID ab.

Optionale Parameter

  • signature (empfohlen) ist eine digitale Signatur, mit der geprüft wird, ob Anfragen zur Websitegenerierung, bei denen Ihr 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:Ehemalige Kunden der Google Maps Platform-Premiumoption benötigen die digitale Signatur. Weitere Informationen zu Authentifizierungsparametern für Nutzer 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 Sie keine Richtung angeben, wird ein Wert berechnet, der die Kamera von dem Punkt, an dem das nächstgelegene Foto aufgenommen wurde, zum angegebenen location-Wert führt.
  • fov (Standardwert 90) legt das horizontale Sichtfeld des Bildes in Grad fest. 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 die Zoomstufe dar, wobei kleinere Zahlen eine höhere Zoomstufe angeben.


    Screenshot eines Weitwinkel-Sichtfelds mit Decke, Wänden, Boden und einem Tankfenster im Inneren eines Aquariums. Screenshot des Sichtfelds einer Nahaufnahme mit herangezoomten Details 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 relativ 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, wobei -90 gerade nach unten zeigt.
  • Mit radius (Standardwert 50) wird ein in Metern angegebener Radius festgelegt, in dem nach einem Panorama gesucht werden soll. 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 dieser Wert auf true gesetzt 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.
  • source (Standardwert default) schränkt Street View-Suchanfragen auf ausgewählte Quellen ein. Gültige Werte:
    • Bei default werden die Standardquellen für Street View verwendet. Suchanfragen sind nicht auf bestimmte Quellen beschränkt.
    • outdoor schränkt die Suchanfragen auf Außenansichten ein. Indoor-Sammlungen werden nicht in die Suchergebnisse einbezogen. Unter Umständen sind für den angegebenen Ort keine Außenansichten vorhanden. Außerdem werden bei der Suche nur Panoramen zurückgegeben, bei denen festgestellt werden kann, ob sie sich im Innen- oder Außenbereich befinden. Beispielsweise werden PhotoSphere-Aufnahmen nicht zurückgegeben, da nicht bekannt ist, ob sie sich im Innen- oder Außenbereich 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 Fotos von einem Aussichtspunkt auf Straßenebene, auf dem elektrisierte 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 generisches Bild mit dem Text „Leider haben wir hier keine Bilder“ zurück. Beispiel:

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

Nur gültige Bilder anzeigen

Gehen Sie so vor, damit nicht das generische Bild angezeigt wird und auf Ihrer Webseite nur gültige Bilder der Street View Static API zu sehen sind:

  • Legen Sie den return_error_code-Parameter auf true fest. Dadurch gibt die Street View Static API anstelle des generischen grauen Bildes den Fehler „404 NOT FOUND“ zurück, wenn für den angegebenen Ort kein Bild verfügbar ist.
  • Sie können vor dem Senden einer Anfrage Metadaten für Street View-Bilder anfordern, um festzustellen, ob für den angegebenen Ort Bilder verfügbar sind.