Street View-Anfrage und -Antwort

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 die location 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 zwischen 0 und 360 (beide Werte geben den Norden an, 90 gibt den Osten und 180 den Süden an). Wenn keine Überschrift angegeben ist, wird ein Wert berechnet, der die Kamera zum angegebenen location leitet, und zwar von dem Punkt, an dem das nächstgelegene Foto aufgenommen wurde.
• fov (Standardwert 90) bestimmt das horizontale Sichtfeld des Bildes. Das Sichtfeld wird in Grad angegeben. Der maximal zulässige Wert ist 120. 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 (wobei 90 Grad gerade nach oben zeigt); negative Werte versetzen den Winkel der Kamera nach unten (-90 bedeutet gerade nach unten).
• radius (Standardwert 50) 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 sind true und false. Wenn true 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 (Standardeinstellung default) 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 auf true 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.