Street View-Bild-Metadaten

Einführung

Die Metadatenanfragen der Street View Static API enthalten Daten zu Street View-Panoramas. Anhand der Metadaten können Sie herausfinden, 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 des Fotos und die Urheberrechtsinformationen für das Bild. Wenn Sie auf diese Metadaten zugreifen, können Sie das Fehlerverhalten in Ihrer Anwendung anpassen.

Hinweis : Der Wert des Datumsfelds kann variieren:

• Das Datumsfeld kann für verschiedene Panoramen eine unterschiedliche Detaillierung 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 für 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 Metadatenanfragen für Street View-Bilder sind die Panoramabilder auf 50 Meter genau.

Auf die Metadaten der Bilder 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: Das Protokoll https:// ist für Metadatenanfragen erforderlich.

Wie in URLs üblich, werden alle Parameter mit dem Et-Zeichen (&) getrennt.

Erforderliche Parameter für Metadatenanfragen

Für Metadatenanfragen gelten die gleichen URL-Parameter wie für Bildanfragen der Street View Static API. Es sind jedoch 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ängengrad (40.457375,-80.009353) sein.

Oder:

• pano – eine bestimmte Panorama-ID. Die IDs von Panoramen können sich im Laufe der Zeit ändern. Daher sollte diese ID nicht gespeichert werden. Speichern Sie stattdessen die Adresse des Standorts oder die Breiten- und Längengradkoordinaten, 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 ist erforderlich, um die Anfrage zu authentifizieren. Die digitale Signatur ist in bestimmten Fällen 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=<YOUR_SIGNATURE>

oder so:

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

Gelöschte Panorama-IDs aktualisieren

Wenn Sie versuchen, eine Panorama-ID abzurufen, und entweder ZERO_RESULTS oder keinen Wert erhalten, wurde die Panorama-ID gelöscht und muss aktualisiert werden.

1. Speichern Sie die Adresse oder die Breiten- und Längengradkoordinaten, 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, verwenden Sie die ursprüngliche Adresse oder die Breiten- und Längengradkoordinaten, um noch einmal nach den nächsten Panoramas an diesem Ort zu suchen und eine neue Panorama-ID zu erhalten.

Hinweis :Da Street View-Bilder regelmäßig aktualisiert werden und Fotos jedes Mal von leicht unterschiedlichen Positionen aufgenommen werden können, wird eine bestimmte Panorama-ID möglicherweise zu einem anderen Panorama gewechselt, wenn Bilder oder die Panorama-ID aktualisiert 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. Die API ermöglicht die Aufnahme derselben Parameter wie in der Bildanfrage, um die Erstellung einer Metadatenanfrage im Zusammenhang mit einer bestimmten Bildanfrage zu vereinfachen. Bei Metadatenanfragen werden die optionalen Parameter und ihre Werte jedoch von der API ignoriert. Weitere 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

Über die 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

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

Beispiel 2: Panorama nicht gefunden

Über die 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 werden konnte.

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

Anfrage und Antwort für Bilder

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 und möglicherweise Informationen zur Fehlerbehebung, mit denen 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. 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 werden konnte. Diese Meldung kann angezeigt werden, wenn eine nicht vorhandene Adresse angegeben wurde.
"OVER_QUERY_LIMIT"	Gibt an, dass Sie Ihr Tageskontingent oder Ihr Kontingent pro Sekunde für diese API überschritten haben.
"REQUEST_DENIED"	Gibt an, dass die Anforderung abgelehnt wurde. Diese Meldung wird möglicherweise angezeigt, wenn Sie Ihre Anfrage nicht autorisiert haben oder die Street View Static API nicht im Google Cloud Console-Projekt mit Ihrem API-Schlüssel aktiviert ist.
"INVALID_REQUEST"	Gibt im Allgemeinen an, dass die Suchparameter (Adresse, Breiten- und Längengradkoordinaten oder Komponenten) fehlen.
"UNKNOWN_ERROR"	Gibt an, dass die Anfrage aufgrund eines Serverfehlers nicht verarbeitet werden konnte. Dieses Problem ist oft nur vorübergehend. Die Anfrage ist möglicherweise erfolgreich, wenn Sie es erneut versuchen.

Weitere Informationen

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