Street View-Anfrage und -Antwort

Eine Anfrage für ein Street View-Bild ist eine HTTP-URL in folgendem Format:

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

Das Bild wird mithilfe von Anforderungsparametern angegeben. Wie in 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 Paar aus Breiten- und Längengradkoordinaten (40.457375,-80.009353) sein und sollte URL-codiert werden. 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 fotografiert 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 Radius von 50 Metern nach einem Foto, das dem Standort am nächsten ist. Da die Street View-Bilder regelmäßig aktualisiert werden und jedes Mal Fotos an leicht unterschiedlichen Positionen aufgenommen werden können, ist es möglich, dass die location bei der Aktualisierung von Bildern zu einem anderen Panorama wechselt.

Oder:

  • pano ist eine spezifische Panorama-ID. Die ID von Panoramen kann sich im Laufe der Zeit ändern. Behalten Sie diese ID also nicht bei. Speichern Sie stattdessen die Adresse des Standorts oder die Koordinaten des Breiten- und Längengrads, 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. size=600x400 gibt beispielsweise ein Bild mit einer Breite von 600 Pixeln und einer Höhe von 400 Pixeln zurück.
  • key ermöglicht es Ihnen, die API-Nutzung Ihrer Anwendung in der Google Cloud Console zu überwachen, und stellt sicher, 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 versuchen, eine Panorama-ID abzurufen und entweder ZERO_RESULTS oder keinen Wert abrufen, wurde die Panorama-ID gelöscht und muss aktualisiert werden.

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

  2. Wenn Sie feststellen, dass sich eine Panorama-ID geändert hat, verwenden Sie die ursprüngliche Standortadresse oder die Breiten- und Längengradkoordinaten, um noch einmal nach dem nächstgelegenen Panorama zu suchen und eine neue Panorama-ID zu erhalten.

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 schlagen möglicherweise fehl. Weitere Informationen finden Sie unter Schlüssel und Signatur anfordern.

    Hinweis:Nutzer mit der Google Maps Platform-Premiumoption haben die digitale Signatur. Weitere Informationen zu Authentifizierungsparametern für Kunden mit der Premiumoption

  • heading gibt die Kompassrichtung 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 auf den angegebenen location lenkt, ausgehend von dem Punkt, an dem das nächstgelegene Foto aufgenommen wurde.
  • fov (Standard ist 90) legt das horizontale Sichtfeld des Bilds in Grad fest, mit dem maximal zulässigen Wert 120. Bei einem Darstellungsbereich mit fester Größe, wie bei einem Street View-Bild mit einer festen Größe, steht das Sichtfeld im Wesentlichen für Zoom, wobei kleinere Zahlen eine höhere Zoomstufe angeben.


    Screenshot eines breiten Sichtfelds mit Decke, Wänden, Fußboden und einem Panzerfenster in einem Aquarium. Screenshot eines Sichtfelds in einer Nahaufnahme eines Aquariums mit herangezoomten Details eines Street View-Fotos.
    (links: fov=120; rechts: fov=20)

  • pitch (Standard ist 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 (90 Grad zeigt gerade nach oben), negative Werte versetzen den Winkel der Kamera nach unten (-90 steht für gerade nach unten).
  • Mit radius (Standardwert 50) wird ein Radius 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 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) sind Street View-Suchanfragen auf ausgewählte Quellen beschränkt. 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 den Suchergebnissen angezeigt. Möglicherweise sind für den angegebenen Ort keine Außenansichten vorhanden. Beachten Sie außerdem, dass bei der Suche nur Panoramen zurückgegeben werden, bei denen festgestellt werden kann, ob sie sich im Innen- oder Außenbereich befinden. Photo Sphere-Aufnahmen werden beispielsweise nicht zurückgegeben, weil 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 Aussichtspunkts auf Straßenebene, der elektrisierte Bahnstrecken zeigt

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 keine Bilder vorhanden“ zurück, wie im folgenden Beispiel:

Screenshot des allgemeinen Bilds, das angezeigt wird, wenn für den angegebenen Ort kein Bildmaterial verfügbar ist. 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 folgendermaßen vor, um zu verhindern, dass das allgemeine Bild angezeigt wird und dass auf Ihrer Webseite nur gültige Street View Static API-Bilder angezeigt werden:

  • Legen Sie den Parameter return_error_code auf true fest. Die Street View Static API gibt dann den Fehler 404 NOT FOUND anstelle des generischen grauen Bilds zurück, wenn für den angegebenen Standort kein Bild verfügbar ist.
  • Fordern Sie die Metadaten für Street View-Bilder an, um festzustellen, ob Bilder für den angegebenen Ort verfügbar sind, bevor Sie die Anfrage senden.