Street View-Bild-Metadaten

Einleitung

Die Metadatenanfragen der 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 die Breiten- und Längengrade, die Panorama-ID, das Aufnahmedatum und die Urheberrechtsinformationen des Bildes. Durch den Zugriff auf diese Metadaten können Sie das Fehlerverhalten in Ihrer Anwendung anpassen.

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 über die Street View Static API laden.

Bei Metadatenanfragen für Street View-Bilder 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

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 Bildanfragen der Street View Static API, obwohl nur die folgenden Parameter erforderlich sind:

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. Panoramen können sich im Laufe der Zeit ändern. Behalten Sie diese ID also nicht bei. Speichern Sie stattdessen die Adresse des Standorts oder die Koordinaten des Breiten- und Längengrads, 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 zum Authentifizieren der Anfrage benötigt. In bestimmten Fällen ist auch die digitale Signatur 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=&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 versuchen, eine Panorama-ID abzurufen und entweder ZERO_RESULTS oder keinen Wert abrufen, wurde die Panorama-ID gelöscht und muss aktualisiert werden.

  1. Speichern Sie die Adresse des Standorts oder die Breiten- und Längengrade, die Sie zum Abrufen der 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 Standortadresse oder die Breiten- und Längengradkoordinaten, um noch einmal nach dem nächstgelegenen Panorama zu suchen und eine neue Panorama-ID zu erhalten.

Optionale Parameter für Metadatenanfragen

Sie können die folgenden Parameter in Ihrer Metadatenanfrage verwenden: 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 der gleichen Parameter wie die Bildanfrage. Dies vereinfacht 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.

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

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
Eiffelturm

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 Standorts 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
Platzhalter für „Keine Bilder hier“

Statuscodes

Das Feld status im Metadaten-Antwortobjekt 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 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 wurde.
"OVER_QUERY_LIMIT" Gibt an, dass Sie das 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 Sie die 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" Gibt im Allgemeinen an, dass die Abfrageparameter (Adresse, Breiten- und Längengrad oder Komponenten) fehlen.
"UNKNOWN_ERROR" Gibt an, dass die Anfrage aufgrund eines Serverfehlers nicht verarbeitet werden konnte. Dieses Problem ist oft vorübergehend. 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.