Street View-Anfrage und -Antwort

Eine Street View-Bildanfrage 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 werden alle Parameter durch kaufmännische Und-Zeichen (&) getrennt. Die zulässigen Parameter mit ihren möglichen Werten sind unten aufgeführt.

Erforderliche Parameter

Entweder:

  • location kann entweder ein Textstring sein (z. B. Chagrin Falls, OH). oder ein Paar aus Breiten- und Längengraden (40.457375,-80.009353) enthalten, und sollte URL-codiert sein. Also wandeln Sie Adressen wie „City Hall, New York, NY“ nach „City+Hall,New+York,NY“ bevor Sie die Anfrage senden. Die Street View Static API verwendet das Panoramafoto, das dem den Standort. Wenn Sie einen Adresstextstring angeben, kann die API an einen anderen Standort, damit er besser angezeigt werden kann. Wenn Sie Koordinaten für Längen- und Breitengrad angeben, sucht im Umkreis von 50 Metern nach einem Foto, das dem Ort am nächsten ist. Da Street View-Bilder regelmäßig aktualisiert werden, aus leicht unterschiedlichen Positionen genommen werden, Ihr location nimmt möglicherweise ein anderes Panorama an, wenn Bilder aktualisiert werden.

Oder:

  • pano ist eine spezifische Panorama-ID. Die ID von Panoramen kann sich im Laufe der Zeit ändern. diese ID nicht beibehalten. Speichern Sie stattdessen die Standortadresse oder Längen- und Breitengrade angeben, damit Sie die Panorama-ID aktualisieren können. Für finden Sie unter Gelöschte Panorama-IDs aktualisieren.

Ebenso wie:

  • size gibt die Ausgabegröße des Bildes in Pixeln an. Die Größe wird angegeben als {width}x{height} – z. B. 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 im Google Cloud Console, und stellt sicher, dass Google Sie bei Bedarf bezüglich Ihres Antrags 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 enthält, wurde die Panorama-ID gelöscht und muss aktualisiert werden.

  1. Speichern Sie die Standortadresse oder die Breiten- und Längengrade, die Sie für erhalten Sie eine Panorama-ID, damit Sie sie bei Bedarf aktualisieren können.

  2. Wenn Sie feststellen, dass sich eine Panorama-ID geändert hat, verwenden Sie den ursprünglichen Standort. oder Längen- und Breitengrade angeben, um nach dem nächstgelegenen Panoramen zu diesem Ort hinzufügen und eine neue Panorama-ID abrufen.

Optionale Parameter

  • signature (empfohlen) ist eine digitale Signatur, die verwendet wird. um zu prüfen, ob Anfragen zur Websitegenerierung, bei denen Ihr API-Schlüssel verwendet wird, autorisiert sind um dies zu tun. Anfragen ohne digitale Signatur können fehlschlagen. Weitere Informationen finden Sie unter Schlüssel und Signatur anfordern.

    Hinweis:Für ehemalige Kunden der Google Maps Platform-Premiumoption gilt die digitale Signatur ist erforderlich. Weitere Informationen zu Authentifizierungsparameter für Premium Plan-Kunden

  • heading gibt die Kompassrichtung von an in die Kamera. Zulässige Werte: 0 bis 360 (beide Werte geben Norden an, wobei 90 den Osten angibt und 180 Süd). Wenn Sie keine Überschrift angeben, ist ein Wert der die Kamera in Richtung des angegebenen location, von dem Punkt an, an dem das nächstgelegene Foto aufgenommen wurde bereits vergeben sind.
  • fov (Standardwert ist 90) bestimmt das horizontale Sichtfeld des Bildes in Grad, mit einem maximal zulässigen Wert von 120. Wenn es sich um einen Darstellungsbereich mit fester Größe handelt, wie beim Street View-Bild feste Größe, das Sichtfeld stellt im Wesentlichen die Zoomstufe dar, mit kleineren Zahlen deutet auf eine höhere Zoomstufe hin.


    Screenshot eines Weitwinkel-Sichtfelds mit Decke, Wänden, Boden und einem Tankfenster im Inneren eines Aquariums. Screenshot des Sichtfelds einer Nahaufnahme mit herangezoomten Details eines Street View-Fotos in einem Aquarium
    (Links: fov=120; Rechts: fov=20)

  • pitch (Standardwert ist 0) gibt den Aufwärts- oder Abwärtswinkel der Kamera relativ zu Street View an Fahrzeug. Dieser ist häufig, aber nicht immer, flach horizontal. Positive Werte Richten Sie die Kamera nach oben. 90 Grad zeigen dabei gerade nach oben. negative Werte versetzen die Kamera nach unten, wobei -90 anzeigt, gerade nach unten).
  • radius (Standardwert ist 50) legt einen in Metern angegebenen Radius fest, in dem nach einem Panorama gesucht werden soll. mit dem angegebenen Breiten- und Längengrad zentriert. Gültige Werte sind nicht negativ Ganzzahlen.
  • return_error_code gibt an, ob die API Folgendes zurückgeben soll: wenn kein Bild gefunden wird (404 NOT FOUND) oder als Antwort auf Ungültige Anforderung (400 BAD REQUEST). Gültige Werte sind true und false. Wenn true festgelegt ist, wird eine Fehlermeldung angezeigt, anstelle des generischen grauen Bildes zurückgegeben. Dadurch entfällt die Notwendigkeit, Starten Sie einen separaten Aufruf, um die Verfügbarkeit der Bilder zu prüfen.
  • source (Standardwert ist default) beschränkt Street View-Suchanfragen 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. Für den Innenbereich Sammlungen erscheinen nicht in den Suchergebnissen. Es kann sein, dass keine Außenansichten vorhanden sind. für den angegebenen Ort. Bei der Suche werden nur Panoramabilder zurückgegeben. in denen ermittelt werden kann, ob sie sich drinnen oder draußen befinden. Beispiel: Photo Sphere-Aufnahmen werden 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
Screenshot eines Fotos von einem Aussichtspunkt auf Straßenebene, auf dem elektrisierte Bahngleise zu sehen sind

Kein Bild verfügbar

Für Orte, an denen keine Street View-Bilder verfügbar sind, wird die Street View Static API gibt ein allgemeines graues Bild mit dem Text "Leider haben wir keine Bilder zurück. wie in diesem Beispiel gezeigt:

Screenshot des allgemeinen Bildes, das angezeigt wird, wenn für den angegebenen Ort keine Bilder verfügbar sind. Der Hintergrund ist hellbraun und der Text "Leider haben wir hier keine Bilder".
Abbildung: Generisches Bild, das angezeigt wird, wenn für die für den angegebenen Ort.

Nur gültige Bilder anzeigen

Um zu vermeiden, dass das allgemeine Bild angezeigt wird, und sicherstellen, dass Ihre Webseite nur gültige Street View Static API-Bilder anzeigt, folgen Sie diesen Vorschläge:

  • Legen Sie den Parameter return_error_code auf true fest. Dies führt dazu, dass die Street View Static API den Fehler 404 NOT FOUND zurückgibt. anstelle des allgemeinen grauen Bildes, wenn kein Bild für das angegebenen Ort.
  • Metadaten für Street View-Bild anfordern um zu ermitteln, ob für den angegebenen Ort bereits Bilder verfügbar sind, zum Senden einer Anfrage.