Street View-Anfrage und -Antwort

Entwickler im Europäischen Wirtschaftsraum (EWR)

Wenn sich Ihre Rechnungsadresse im Europäischen Wirtschaftsraum befindet, unterliegt Ihre Nutzung der Dienste ab dem 8. Juli 2025 den Nutzungsbedingungen der Google Maps Platform für den EWR. Die Funktionalität variiert je nach Region. Weitere Informationen

Eine Street View Image-Anfrage ist eine HTTP-URL im folgenden 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 Koordinatenpaar aus Breiten- und Längengrad (40.457375,-80.009353) sein und sollte URL-codiert sein. Konvertieren Sie daher Adressen wie „City Hall, New York, NY“ in „City+Hall,New+York,NY“, bevor Sie die Anfrage senden. Die Street View Static API springt zum Panoramabild, das dem Standort am nächsten ist. Wenn Sie einen Adress-Textstring angeben, verwendet die API möglicherweise einen anderen Kamerastandort, um den angegebenen Ort besser darzustellen. 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 Street View-Bilder regelmäßig aktualisiert werden und die Fotos jedes Mal von leicht unterschiedlichen Positionen aufgenommen werden können, kann es sein, dass Ihre location bei der Aktualisierung der Bilder an ein anderes Panorama angehängt wird.

Oder:

• pano ist eine bestimmte Panorama-ID. Die ID von Panoramen kann sich im Laufe der Zeit ändern. Speichern Sie diese ID daher nicht dauerhaft. Speichern Sie stattdessen die Adresse oder die Breiten- und Längengradkoordinaten des Standorts, 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 wird mit size=600x400 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. Außerdem kann Google Sie bei Bedarf bezüglich Ihrer Anwendung kontaktieren. 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, können Sie die ursprüngliche Adresse oder die Breiten- und Längengradkoordinaten verwenden, um noch einmal nach den nächstgelegenen Panoramen zu suchen und eine neue Panorama-ID zu erhalten.

Hinweis: Da Street View-Bilder regelmäßig aktualisiert werden und die Fotos jedes Mal von leicht unterschiedlichen Positionen aufgenommen werden können, kann eine bestimmte Panorama-ID bei der Aktualisierung der Bilder oder der Panorama-ID einem anderen Panorama zugeordnet werden.

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

• heading gibt den Kompasskurs der Kamera an. Zulässige Werte sind 0 bis 360 (beide Werte stehen für Norden, 90 für Osten und 180 für Süden). Wenn Sie keine Richtung angeben, wird ein Wert berechnet, der die Kamera von dem Punkt, an dem das nächstgelegene Foto aufgenommen wurde, auf den angegebenen location ausrichtet.
• fov (Standardwert ist 90) bestimmt das horizontale Sichtfeld des Bildes in Grad, wobei der maximal zulässige Wert 120 ist. Bei einem Darstellungsbereich mit fester Größe, z. B. einem Street View-Bild mit einer festgelegten Größe, entspricht das Sichtfeld im Wesentlichen dem Zoom. Kleinere Zahlen weisen auf eine höhere Zoomstufe hin.

  
  
  (Links: fov=120; rechts: fov=20)

• pitch (Standardwert ist 0) gibt den Aufwärts- oder Abwärtswinkel der Kamera relativ zum Street View-Fahrzeug an. Dieser ist häufig, aber nicht immer, flach horizontal. Positive Werte neigen die Kamera nach oben (90 Grad bedeutet gerade nach oben), negative Werte neigen die Kamera nach unten (-90 Grad bedeutet gerade nach unten).
• Mit radius (Standardwert ist 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 wenn eine ungültige Anfrage gestellt wird (400 BAD REQUEST). Gültige Werte sind true und false. Wenn true festgelegt ist, wird anstelle des allgemeinen grauen Bildes eine Fehlermeldung zurückgegeben. Dadurch ist kein separater Aufruf erforderlich, um die Verfügbarkeit des Bildes zu prüfen.
• source (Standardwert ist default) beschränkt Street View-Suchen 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 vorkommen, dass für den angegebenen Ort keine Außenansichten vorhanden sind. 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 keine Photo Spheres 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

Kein Bild verfügbar

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

Abbildung: Allgemeines Bild, das angezeigt wird, wenn für den angegebenen Ort keine Bilder verfügbar sind.

Nur gültige Bilder anzeigen

Wenn Sie vermeiden möchten, dass das generische Bild angezeigt wird, und dafür sorgen möchten, dass auf Ihrer Webseite nur gültige Street View Static API-Bilder angezeigt werden, beachten Sie die folgenden Empfehlungen:

• Legen Sie für den Parameter return_error_code den Wert true fest. Dadurch gibt die Street View Static API den Fehler „404 Nicht gefunden“ anstelle des allgemeinen grauen Bildes zurück, wenn für den angegebenen Ort kein Bild verfügbar ist.
• Fordern Sie Street View-Bildmetadaten an, um vor dem Senden einer Anfrage festzustellen, ob für den angegebenen Ort Street View-Bilder verfügbar sind.