Street View-Anfrage und -Antwort

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 Et-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 von Breiten- und Längengradkoordinaten (40.457375,-80.009353) sein. Er muss URL-codiert sein. Wandeln Sie also Adressen wie „Rathaus, New York, NY“ in „Rathaus,New+York,NY“ um, bevor Sie die Anfrage senden. Die Street View Static API passt das Panorama an das dem Standort am nächsten gelegene Panorama an. Wenn Sie einen Adresstextstring angeben, verwendet die API möglicherweise einen anderen Kamerastandort, um den angegebenen Standort besser darzustellen. Wenn Sie Breiten- und Längengradkoordinaten angeben, sucht die API in einem Umkreis 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 von leicht unterschiedlichen Positionen aus aufgenommen werden können, ist es möglich, dass Ihr location bei der Aktualisierung der Bilder zu einem anderen Panorama wechselt.

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. Mit size=600x400 wird beispielsweise 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 im Blick behalten 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ängengradkoordinaten, 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, verwenden Sie die ursprüngliche Adresse oder die Breiten- und Längengradkoordinaten, um noch einmal nach den nächsten Panoramas an diesem Ort zu suchen und eine neue Panorama-ID zu erhalten.

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 berechtigt 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 der Premiumoption

  • heading gibt die Kompassausrichtung der Kamera an. Zulässige Werte sind 0 bis 360 (beide Werte geben den Norden an, 90 den Osten und 180 den Süden). Wird keine Ausrichtung angegeben, erfolgt die Berechnung eines Werts, der die Kamera in Richtung der angegebenen location lenkt, wobei von der Stelle ausgegangen wird, an der das nächstgelegene Foto aufgenommen wurde.
  • fov (Standardwert: 90) gibt das horizontale Sichtfeld des Bildes in Grad an. Der maximal zulässige Wert ist 120. Bei einem Darstellungsbereich mit fester Größe, z. B. bei einem Street View-Bild mit fester Größe, entspricht das Sichtfeld im Wesentlichen dem Zoom. Kleinere Zahlen stehen dabei für einen höheren Zoom.


    Screenshot eines Weitwinkel-Felds, der die Decke, die Wände, den Boden und ein Aquariumfenster zeigt Screenshot eines Nahaufnahme-Sichtfelds, der ein herangezoomtes Detail eines Street View-Fotos in einem Aquarium zeigt
    (Links: fov=120; rechts: fov=20)

  • pitch (Standardwert: 0) gibt den Auf- oder Abwärtswinkel der Kamera im Verhältnis zum Street View-Fahrzeug an. Dieser ist häufig, aber nicht immer, flach horizontal. Positive Werte versetzen den Winkel der Kamera nach oben (wobei sie bei 90 Grad gerade nach oben zeigt); negative Werte versetzen den Winkel der Kamera nach unten (bei -90 Grad zeigt sie gerade 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.
  • Mit return_error_code wird angegeben, ob die API einen Fehlercode zurückgeben soll, wenn kein Bild gefunden wird (404 NICHT GEFUNDEN), oder als Antwort auf eine ungültige Anfrage (400 FALSCHE ANFRAGE). Gültige Werte sind true und false. Wenn true festgelegt ist, wird anstelle des generischen grauen Bilds eine Fehlermeldung zurückgegeben. So müssen Sie nicht noch einmal einen Aufruf starten, um die Verfügbarkeit von Bildern zu prüfen.
  • source (Standardwert: default) begrenzt 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 sind nicht in den Suchergebnissen enthalten. Es kann deshalb vorkommen, dass als Panoramen für den angegebenen Ort keine Außenansichten vorhanden sind. Beachten Sie außerdem, dass bei der Suche nur Panoramen zurückgegeben werden, bei denen sich feststellen lässt, ob sie sich drinnen oder draußen befinden. Beispielsweise werden keine Fotosphären zurückgegeben, da nicht bekannt ist, ob sie drinnen oder draußen 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 auf Straßenebene, auf dem elektrifizierte Eisenbahngleise zu sehen sind

Kein Bild verfügbar

Für Orte, an denen keine Street View-Bilder verfügbar sind, gibt die Street View Static API ein graues generisches Bild mit dem Text „Leider sind hier keine Bilder verfügbar“ zurück, wie in diesem Beispiel zu sehen:

Ein Screenshot des generischen Bilds, das angezeigt wird, wenn für den angegebenen Standort keine Bilder verfügbar sind. Der Hintergrund ist hellbraun und enthält den Text „Leider sind hier keine Bilder verfügbar“.
Abbildung: Generisches Bild, das angezeigt wird, wenn für den angegebenen Ort keine Bilder verfügbar sind.

Nur gültige Bilder anzeigen

Um das generische Bild zu vermeiden und dafür zu sorgen, dass auf Ihrer Website nur gültige Street View Static API-Bilder angezeigt werden, folgen Sie diesen Vorschlägen:

  • Legen Sie den Parameter return_error_code auf true fest. Wenn für den angegebenen Standort kein Bild verfügbar ist, gibt die Street View Static API anstelle des generischen grauen Bilds den Fehler 404 (NICHT GEFUNDEN) zurück.
  • Sie können Street View-Bildmetadaten anfordern, um vor dem Senden einer Anfrage zu prüfen, ob Bilder für den angegebenen Ort verfügbar sind.