Street View-Bild-Metadaten

Einleitung

Die Metadatenanfragen der Street View Static API liefern Daten zu Street View-Panoramen. Mithilfe der Metadaten können Sie feststellen, ob an einem bestimmten Ort ein Street View-Bild verfügbar ist. Außerdem erhalten Sie programmatischen Zugriff auf die Breiten- und Längengradkoordinaten, 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.

Hinweis : Der Wert des Datumsfelds kann variieren:

• Das Datumsfeld kann für verschiedene Panoramen einen unterschiedlichen Detaillierungsgrad haben. Beispielsweise enthält das Datumsfeld für einige Panoramen ein Jahr und einen Monat, während es bei anderen nur das Jahr enthält.
• Das Datumsfeld wird weggelassen, wenn keine Daten verfügbar sind.

Metadatenanfragen an die Street View Static API 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 Panoramabilder auf 50 Meter genau.

Auf Bildmetadaten zugreifen

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

Hinweis: Für Metadatenanfragen ist das https://-Protokoll erforderlich.

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

Erforderliche Parameter für Metadatenanfragen

Für Metadatenanfragen können dieselben URL-Parameter wie für die Street View Static API-Bildanfragen verwendet werden. Allerdings sind nur die folgenden Parameter erforderlich:

Entweder:

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

Oder:

• pano: eine bestimmte Panorama-ID. Da sich die IDs im Laufe der Zeit ändern können, sollten Sie diese ID nicht beibehalten. Speichern Sie stattdessen die Standortadresse oder die Breiten- und Längengrade, damit Sie die Panorama-ID aktualisieren können. Weitere Informationen finden Sie unter Gelöschte Panorama-IDs aktualisieren.

Ebenso wie:

• key und signature: Der API-Schlüssel wird zur Authentifizierung der Anfrage benötigt. Die digitale Signatur ist in bestimmten Fällen auch erforderlich und wird immer empfohlen. Weitere Informationen finden Sie unter Schlüssel und Signatur abrufen.

Ihre Metadatenanfrage mit nur den erforderlichen Parametern sieht so aus:

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

oder so:

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

Gelöschte Panorama-IDs aktualisieren

Wenn Sie beim Abrufen einer Panorama-ID entweder ZERO_RESULTS oder keinen Wert erhalten, wurde die Panorama-ID gelöscht und muss aktualisiert werden.

1. Speichern Sie die Standortadresse oder die Breiten- und Längengrade, die Sie zum Abrufen einer Panorama-ID verwendet haben, damit Sie sie bei Bedarf aktualisieren können.

2. Wenn Sie feststellen, dass sich eine Panorama-ID geändert hat, suchen Sie anhand der ursprünglichen Standortadresse oder den Breiten- und Längengradkoordinaten noch einmal nach den nächstgelegenen Panoramen und rufen Sie eine neue Panorama-ID ab.

Hinweis :Street View-Bilder werden regelmäßig aktualisiert und Fotos können jedes Mal aus leicht unterschiedlichen Positionen aufgenommen werden. Daher kann eine bestimmte Panorama-ID bei einer Aktualisierung von Bildern oder der Panorama-ID an ein anderes Panorama gesendet werden.

Optionale Parameter für Metadatenanfragen

Sie können die folgenden Parameter in Ihre Metadatenanfrage aufnehmen: size, heading, fov und pitch. Diese Parameter haben keinen Einfluss auf die Daten zum Panorama oder darauf, welches Panorama gefunden wird. In der API können dieselben Parameter wie in die Bildanfrage aufgenommen werden, um das Erstellen einer Metadatenanfrage für eine bestimmte Bildanfrage zu erleichtern. 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.

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 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, wenn 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

In Ihrer Region sind möglicherweise keine Beispiele verfügbar.

Beispiel 2: Panorama nicht gefunden

Mit den folgenden URLs werden die Metadaten und das Bild für ein Panorama angefordert, das am oder in der Nähe des angegebenen Orts nicht gefunden wurde.

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

Bildanfrage 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

In Ihrer Region sind möglicherweise keine Beispiele verfügbar.

Statuscodes

Das Feld status im Metadaten-Antwortobjekt enthält den Status der Anfrage sowie möglicherweise Informationen zur Fehlerbehebung, um herauszufinden, 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. Diese Antwort kann auftreten, wenn Sie eine nicht vorhandene oder ungültige Panorama-ID angeben. Weitere Informationen finden Sie unter [Gelöschte Panorama-IDs aktualisieren](#refresh-pano).
"NOT_FOUND"	Gibt an, dass der im Parameter location angegebene Adressstring nicht gefunden wurde. Diese Meldung kann auftreten, wenn eine nicht vorhandene Adresse angegeben wird.
"OVER_QUERY_LIMIT"	Gibt an, dass Sie Ihr Tageskontingent oder das Kontingent pro Sekunde für diese API überschritten haben.
"REQUEST_DENIED"	Gibt an, dass die Anforderung abgelehnt wurde. Diese Meldung kann angezeigt werden, wenn du deine Anfrage nicht autorisiert hast oder wenn die Street View Static API in dem Google Cloud Console-Projekt, das deinen API-Schlüssel enthält, nicht aktiviert ist.
"INVALID_REQUEST"	Gibt im Allgemeinen an, dass die Abfrageparameter (Adresse, Breiten- und Längengradkoordinaten oder Komponenten) fehlen.
"UNKNOWN_ERROR"	Gibt an, dass die Anfrage aufgrund eines Serverfehlers nicht verarbeitet werden konnte. Dieses Problem tritt oft nur vorübergehend auf. 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 Google Maps API-Supportseite.