Street View-Anfrage und -Antwort

Entwickler im Europäischen Wirtschaftsraum (EWR)

Eine Street View-Bildanfrage ist eine HTTP-URL in diesem Format:

https://maps.googleapis.com/maps/api/streetview?parameters

Das Bild wird mithilfe von Anforderungsparametern angegeben. Wie in URLs üblich, werden alle Parameter mit dem Und-Zeichen (&) getrennt. Die zulässigen Parameter mit ihren möglichen Werten sind unten aufgeführt.

Erforderliche Parameter

Entweder:

  • location kann entweder ein Textstring (z. B. Chagrin Falls, OH) oder ein Paar aus Längen- und Breitengradkoordinaten (40.457375,-80.009353) sein und sollte URL-codiert sein. Wandeln Sie daher Adressen wie „City Hall, New York, NY“ vor dem Senden der Anfrage in „City+Hall,New+York,NY“ um. Die Street View Static API verwendet das Panoramafoto, das dem Standort am nächsten ist. Wenn Sie einen Adressstring angeben, kann die API einen anderen Kamerastandort verwenden, um den angegebenen Ort besser darzustellen. Wenn Sie Breiten- und Längengradkoordinaten angeben, sucht die API in einem Radius von 50 Metern nach einem Foto, das dem Standort am nächsten ist. Da Street View-Bilder regelmäßig aktualisiert werden und Fotos jedes Mal aus leicht unterschiedlichen Positionen aufgenommen werden können, kann es sein, dass Ihr location bei der Aktualisierung der Bilder an ein anderes Panorama ausgerichtet wird.

Oder:

  • pano ist eine bestimmte Panorama-ID. Die ID von Panoramen kann sich im Laufe der Zeit ändern. Speichern Sie sie daher nicht. Speichern Sie stattdessen die Adresse des Standorts oder die Breiten- und Längengradkoordinaten, 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, z. B. size=600x400. Dadurch wird ein Bild mit einer Breite von 600 Pixeln und einer Höhe von 400 Pixeln zurückgegeben.
  • 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.

Gelöschte Panorama-IDs aktualisieren

Wenn Sie versuchen, eine Panorama-ID abzurufen, und entweder ZERO_RESULTS oder keinen Wert erhalten, wurde die Panorama-ID gelöscht und muss aktualisiert werden.

  1. Speichern Sie die Adresse 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 mit der ursprünglichen Standortadresse oder den Breiten- und Längengradkoordinaten noch einmal nach den nächstgelegenen Panoramen für diesen Standort und rufen Sie eine neue Panorama-ID ab.

Optionale Parameter

  • signature (empfohlen) ist eine digitale Signatur, mit der überprüft wird, ob eine Website, die Anfragen mit Ihrem API-Schlüssel generiert, dazu autorisiert ist. Anfragen ohne digitale Signatur können fehlschlagen. Weitere Informationen finden Sie unter Schlüssel und Signatur abrufen.

    Hinweis:Für ehemalige Kunden der Google Maps Platform-Premiumoption ist die digitale Signatur erforderlich. Weitere Informationen zu Authentifizierungsparametern für Kunden mit Premiumoption

  • heading gibt den Kompasskurs der Kamera an. Zulässige Werte sind 0 bis 360 (beide Werte geben Norden an, 90 Osten und 180 Süden). Wenn Sie keine Richtung angeben, wird ein Wert berechnet, der die Kamera vom Punkt, an dem das nächste Foto aufgenommen wurde, in Richtung des angegebenen location ausrichtet.
  • fov (Standardwert: 90) bestimmt das horizontale Sichtfeld des Bildes in Grad. 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, entspricht das Sichtfeld im Wesentlichen dem Zoom. Kleinere Zahlen bedeuten einen höheren Zoomfaktor.


    Screenshot mit einem weiten Sichtfeld, das die Decke, Wände, den Boden und ein Fenster in einem Aquarium zeigt. Screenshot einer Nahaufnahme, die einen herangezoomten Ausschnitt eines Street View-Fotos in einem Aquarium zeigt.
    (Links: fov=120; Rechts: fov=20)

  • pitch (Standardwert: 0) gibt den Winkel der Kamera nach oben oder unten relativ zum Street View-Fahrzeug an. Dieser ist häufig, aber nicht immer, flach horizontal. Bei positiven Werten wird die Kamera nach oben geneigt (90 Grad entspricht einer senkrechten Ausrichtung nach oben). Bei negativen Werten wird die Kamera nach unten geneigt (-90 entspricht einer senkrechten Ausrichtung nach unten).
  • Mit radius (Standardwert: 50) wird ein Umkreis in Metern 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 Reaktion auf eine ungültige Anfrage (400 BAD REQUEST). Gültige Werte sind true und false. Wenn der Wert auf true gesetzt ist, wird anstelle des generischen grauen Bildes eine Fehlermeldung zurückgegeben. Dadurch ist kein separater Aufruf mehr erforderlich, um die Bildverfügbarkeit zu prüfen.
  • source (Standardwert: default) beschränkt Street View-Suchanfragen auf ausgewählte Quellen. Gültige Werte sind:
    • 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 den Suchergebnissen angezeigt. Es kann deshalb vorkommen, dass als Panoramen für den angegebenen Ort keine Außenansichten vorhanden sind. Bei der Suche werden nur Panoramen zurückgegeben, bei denen sich feststellen lässt, ob sie im Innen- oder Außenbereich aufgenommen wurden. PhotoSpheres werden beispielsweise nicht zurückgegeben, da nicht bekannt ist, ob sie im Innen- oder Außenbereich aufgenommen wurden.

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 Standpunkt auf Straßenebene, auf dem elektrifizierte Eisenbahngleise 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 „Sorry, we have no imagery here.“ zurück, wie in diesem Beispiel zu sehen ist:

Ein Screenshot des generischen Bildes, das angezeigt wird, wenn für den angegebenen Ort keine Bilder verfügbar sind. Der Hintergrund ist hellbraun und es wird der Text „Leider sind hier keine Bilder verfügbar.“ angezeigt.
Abbildung: Allgemeines Bild, das angezeigt wird, wenn für den angegebenen Ort keine Bilder verfügbar sind.

Nur gültige Bilder anzeigen

Damit das generische Bild nicht angezeigt wird und auf Ihrer Webseite nur gültige Street View Static API-Bilder zu sehen sind, sollten Sie die folgenden Vorschläge beachten:

  • Setzen Sie den Parameter return_error_code auf true. 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.
  • Rufen Sie Metadaten von Street View-Bildern ab, um vor dem Senden einer Anfrage zu ermitteln, ob für den angegebenen Ort Bilder verfügbar sind.