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. Mithilfe der Metadaten können Sie herausfinden, ob ein Street View-Bild an einem bestimmten Ort verfügbar ist. Außerdem erhalten Sie programmatischen Zugriff auf Breiten- und Längengrad, die Panorama-ID, das Aufnahmedatum und die Urheberrechtsinformationen für das Bild. Mit dem Zugriff auf diese Metadaten 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 Anfragen für Street View-Bildmetadaten sind die Panoramabilder auf 50 Meter genau.

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 dieselben URL-Parameter wie die Street View Static API-Bildanfragen, obwohl 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, wobei sich die Panoramen im Laufe der Zeit ändern können, wenn die Bilder aktualisiert werden.

Ebenso wie:

key und signature: Der API-Schlüssel ist zum Authentifizieren der Anfrage erforderlich. Die digitale Signatur ist in bestimmten Fällen ebenfalls erforderlich und wird immer empfohlen. Weitere Informationen finden Sie unter Schlüssel und Signatur anfordern.

Ihre Metadatenanfrage mit nur erforderlichen Parametern sieht 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 zum Panorama oder darauf, welches Panorama gefunden wird. Die API ermöglicht die Aufnahme derselben Parameter wie die Bildanfrage, um das Erstellen einer Metadatenanfrage im Zusammenhang mit einer bestimmten Bildanfrage zu erleichtern. Bei Metadatenanfragen ignoriert die API jedoch die optionalen Parameter und ihre Werte. Informationen zur Verwendung dieser Parameter finden Sie im Entwicklerleitfaden für die Street View Static API.

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"
}

Bildanforderung 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 für ein Panorama angefordert, das am angegebenen Ort oder in der Nähe des Orts 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 sowie möglicherweise Informationen zur Fehlerbehebung, anhand derer Sie herausfinden 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. Das kann passieren, wenn eine Panorama-ID nicht vorhanden oder ungültig ist.
`"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 passieren, wenn Sie Ihre Anfrage nicht autorisiert haben oder die Street View Static API im Google Cloud Console-Projekt mit Ihrem API-Schlüssel nicht aktiviert ist.
`"INVALID_REQUEST"`	Zeigt im Allgemeinen an, dass die Suchparameter (Adresse oder „latlng“ oder Komponenten) fehlen.
`"UNKNOWN_ERROR"`	Gibt an, dass die Anforderung aufgrund eines Serverfehlers nicht verarbeitet werden konnte. Dies ist häufig 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 die Maps API.