Eine Street View-Bildanfrage ist eine HTTP-URL in folgendem 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 (&) voneinander 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-/Längengradwert (40.457375,-80.009353
) sein und muss URL-codiert sein. Adressen wie „City Hall, New York, NY“ sollten daher in „City+Hall,New+York,NY“ konvertiert werden, bevor die Anfrage signiert wird. Die Street View Static API schnappt das Panorama, das diesem Standort am nächsten ist. Wenn ein Textstring für die Adresse angegeben wird, verwendet die API möglicherweise einen anderen Kamerastandort, um den angegebenen Standort besser anzeigen zu lassen. Wenn ein Breiten-/Längengrad angegeben ist, sucht die API in einem Radius von 50 Metern nach einem Foto, das diesem Standort am nächsten ist. Da die Street View-Bilder regelmäßig aktualisiert werden und die Fotos jedes Mal an leicht abweichenden Positionen aufgenommen werden, kann es passieren, dass dielocation
bei einer Aktualisierung des Panoramas an ein anderes Panoramabild angrenzt.
Oder:
pano
ist eine spezifische Panorama-ID. Diese sind in der Regel stabil.
Ebenso wie:
size
gibt die Ausgabegröße des Bildes in Pixeln an. Für die Größe wird{width}x{height}
angegeben. Beispiel:size=600x400
gibt ein Bild mit einer Breite von 600 Pixeln und einer Höhe von 400 Pixeln zurück.- 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 anfordern.
Optionale Parameter
signature
(empfohlen) ist eine digitale Signatur, mit der geprüft wird, ob Websites, die Anfragen mit deinem API-Schlüssel erstellen, dazu auch autorisiert sind. Anfragen, die keine digitale Signatur enthalten, können fehlschlagen. Weitere Informationen finden Sie unter Schlüssel und Signatur anfordern.Hinweis:Für Nutzer der Google Maps Platform-Premiumoption ist eine digitale Signatur erforderlich. Weitere Informationen zu Authentifizierungsparametern für Kunden mit Premiumoption
heading
gibt die Kompassausrichtung der Kamera an. Zulässige Werte liegen zwischen0
und360
(beide Werte geben den Norden an,90
gibt den Osten und180
den Süden an). Wenn keine Überschrift angegeben ist, wird ein Wert berechnet, der die Kamera zum angegebenenlocation
leitet, und zwar von dem Punkt, an dem das nächstgelegene Foto aufgenommen wurde.fov
(Standardwert90
) bestimmt das horizontale Sichtfeld des Bildes. Das Sichtfeld wird in Grad angegeben. Der maximal zulässige Wert ist120
. Wenn Sie einen Darstellungsbereich mit fester Größe wie ein Street View-Bild einer festen Größe verwenden, entspricht das Sichtfeld im Wesentlichen dem Zoom. Kleinere Zahlen zeigen eine höhere Zoomstufe an.
(Links:fov=120
; rechts:fov=20
)pitch
(Standardwert:0
) gibt den Aufwärts- oder Abwärtswinkel der Kamera im Verhältnis zum Street View-Fahrzeug an. Der Winkel ist häufig (aber nicht immer) flach horizontal. Positive Werte versetzen den Winkel der Kamera nach oben (wobei90
Grad gerade nach oben zeigt); negative Werte versetzen den Winkel der Kamera nach unten (-90
bedeutet gerade nach unten).radius
(Standardwert50
) legt einen Umkreis in Metern fest, in dem nach einem Panorama gesucht werden soll. Der Mittelpunkt ist dabei der angegebene Längen- und Breitengrad. 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 NICHT GEFUNDEN) oder als Antwort auf eine ungültige Anfrage (400 BAD-ANFRAGE). Gültige Werte sindtrue
undfalse
. Wenntrue
festgelegt ist, wird eine Fehlermeldung anstelle des allgemeinen grauen Bildes zurückgegeben. Das macht einen separaten Aufruf zur Prüfung der Image-Verfügbarkeit überflüssig.source
(Standardeinstellungdefault
) beschränkt die Street View-Suche auf ausgewählte Quellen. Gültige Werte sind:default
verwendet die Standardquellen für Street View. 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. Für den angegebenen Ort sind unter Umständen keine Außenansichten vorhanden. Beachten Sie außerdem, dass bei der Suche nur Panoramen zurückgegeben werden, bei denen ermittelt werden kann, ob sie sich im Innen- oder Außenbereich befinden. Photo Sphere-Aufnahmen werden beispielsweise 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
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 „Tut uns leid, wir haben hier keine Bilder“ zurück, wie in diesem Beispiel:
Nur gültige Bilder anzeigen
So vermeiden Sie, dass das allgemeine Bild angezeigt wird und dass auf Ihrer Webseite nur gültige Street View Static API-Bilder zu sehen sind:
- Legen Sie den Parameter
return_error_code
auftrue
fest. Wenn für den angegebenen Ort kein Bild verfügbar ist, gibt die Street View Static API anstelle des generischen grauen Bildes den Fehler 404 (nicht gefunden) zurück. - Bevor du eine Anfrage sendest, kannst du Street View-Bildmetadaten anfordern, um zu ermitteln, ob Bilder für den angegebenen Ort verfügbar sind.