Diese Seite wurde von der Cloud Translation API übersetzt.

Street View-Bild-Metadaten

Einführung

Die Metadatenanfragen für die Street View Static API liefern Daten zu Street View-Panoramen. Anhand der Metadaten lässt sich feststellen, ob an einem bestimmten Ort ein Street View-Bild verfügbar ist. Außerdem erhalten Sie programmatischen Zugriff auf den Breiten- und Längengrad, die Panorama-ID, das Aufnahmedatum und die Urheberrechtsinformationen für das Bild. Wenn Sie auf diese Metadaten zugreifen, können Sie das Fehlerverhalten in Ihrer Anwendung anpassen.

Street View Static API-Metadatenanfragen sind kostenlos. Beim Anfordern von Metadaten wird kein Kontingent verbraucht. Das Kontingent wird nur verbraucht, wenn Sie ein Bild mit der Street View Static API laden.

Bei den Metadatenanfragen für Street View-Bilder sind die Panoramabilder genau 50 Meter hoch.

Zugreifen auf Bild-Metadaten

Bei einer Metadatenanforderung für ein Street View-Bild handelt es sich um eine HTTP-URL in folgendem Format:

https://maps.googleapis.com/maps/api/streetview/metadata?parameters

Wie bei URLs üblich, werden alle Parameter durch kaufmännische Und-Zeichen (&) voneinander getrennt.

Erforderliche Parameter für Metadatenanfragen

Die Metadatenanfragen akzeptieren die gleichen URL-Parameter wie die Street View Static API-Bildanfragen, auch wenn nur die folgenden Parameter erforderlich sind:

Entweder:

location – kann entweder ein Textstring (z. B. Chagrin Falls, OH) oder ein durch Kommas getrenntes Paar von Breiten- und Längengradkoordinaten (40.457375,-80.009353) sein.

Oder:

pano: Eine bestimmte Panorama-ID. Diese sind in der Regel stabil, allerdings können sich Panoramen mit der Zeit ändern, wenn die Bilder aktualisiert werden.

Ebenso wie:

key und signature: Der API-Schlüssel ist erforderlich, um die Anfrage zu authentifizieren. Die digitale Signatur ist in bestimmten Fällen auch erforderlich und wird immer empfohlen. Weitere Informationen finden Sie unter Schlüssel und Signatur anfordern.

Die Metadatenanfrage mit den erforderlichen Parametern sieht dann so aus:

https://maps.googleapis.com/maps/api/streetview/metadata?location=<STRING>&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

Oder so:

https://maps.googleapis.com/maps/api/streetview/metadata?pano=<STRING>&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

Optionale Parameter für Metadatenanfragen

Sie können die folgenden Parameter in Ihre Metadatenanfrage einfügen: size, heading, fov und pitch. Diese Parameter haben keinen Einfluss auf die Daten eines Panoramas oder darauf, welches Panorama gefunden wird. Mit der API können dieselben Parameter wie bei der Bildanfrage verwendet werden. Dies erleichtert das Erstellen einer Metadatenanfrage für eine bestimmte Bildanfrage. Bei Metadatenanfragen ignoriert die API jedoch die optionalen Parameter und ihre Werte. Informationen zur Verwendung dieser Parameter finden Sie im Entwicklerhandbuch für die Street View Static API-Entwickler.

Antwortformat

Metadatenantworten werden nur im JSON-Format zurückgegeben.

Beispiele

Beispiel 1: Panorama gefunden

Mit den folgenden URLs werden die Metadaten und das Bild desselben Panoramas erfolgreich angefordert.

Metadatenanforderung und -antwort

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "copyright" : "© 2017 Google",
   "date" : "2016-05",
   "location" : {
      "lat" : 48.85783227207914,
      "lng" : 2.295226175151347
   },
   "pano_id" : "tu510ie_z4ptBZYo2BGEJg",
   "status" : "OK"
}

Bildanfrage und -antwort, bei der das fehlende Bild erwartet wird

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Beispiel 2: Panorama nicht gefunden

Mit den folgenden URLs werden die Metadaten und das Bild eines Panoramas angefordert, das am angegebenen Ort oder in der Nähe des Standorts nicht gefunden wurde.

Metadatenanforderung und -antwort

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "status" : "ZERO_RESULTS"
}

Bildanforderung und -antwort

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Statuscodes

Das Feld status im Metadatenantwortobjekt enthält den Status der Anfrage und evtl. Debugging-Informationen, mit deren Hilfe Sie leichter ermitteln können, warum die Street View-Anfrage nicht funktioniert. Das Feld status kann die folgenden Werte enthalten:

Status	Beschreibung
`"OK"`	Gibt an, dass keine Fehler aufgetreten sind. Ein Panorama wurde gefunden und Metadaten werden zurückgegeben.
`"ZERO_RESULTS"`	Gibt an, dass in der Nähe des angegebenen Orts kein Panorama gefunden wurde. Dieser Fehler kann auftreten, wenn eine nicht vorhandene oder ungültige Panorama-ID angegeben wird.
`"NOT_FOUND"`	Gibt an, dass der im Parameter `location` angegebene Adressstring nicht gefunden wurde. Dies kann der Fall sein, wenn eine Adresse angegeben wurde, die es nicht gibt.
`"OVER_QUERY_LIMIT"`	Gibt an, dass Sie Ihr Tages- oder Sekundenkontingent für diese API überschritten haben.
`"REQUEST_DENIED"`	Gibt an, dass die Anforderung abgelehnt wurde. Das kann der Fall sein, wenn Sie Ihre Anfrage nicht autorisiert haben oder die Street View Static API nicht in dem Google Cloud Console-Projekt aktiviert ist, das Ihren API-Schlüssel enthält.
`"INVALID_REQUEST"`	Zeigt im Allgemeinen an, dass die Abfrageparameter (Adresse, Breiten-/Längengrad) fehlen.
`"UNKNOWN_ERROR"`	Gibt an, dass die Anforderung aufgrund eines Serverfehlers nicht verarbeitet werden konnte. Dies ist oft ein vorübergehender Status. Die Anfrage ist möglicherweise erfolgreich, wenn Sie sie noch einmal ausführen.

Weitere Informationen

Weitere Informationen zur Verwendung der Street View Static API oder anderer Google Maps API-Produkte finden Sie auf der Supportseite für Maps API.