Street View-Bild-Metadaten

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Einführung

Die Metadatenanfragen der Street View Static API liefern Daten zu Street View-Panoramen. 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 Breiten- und Längengrad, die Panorama-ID, das Datum der Aufnahme 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.

Wenn Sie Metadatenanfragen für Street View-Bilder senden, sind die Panoramabilder bis 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 die gleichen 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 aus Breiten- und Längengrad-Koordinaten (40.457375,-80.009353) sein.

Oder:

  • pano: Eine bestimmte Panorama-ID. Diese sind in der Regel stabil, allerdings können sich Panoramen im Laufe der Zeit ändern, wenn 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 ebenfalls erforderlich und wird immer empfohlen. Weitere Informationen finden Sie unter Schlüssel und Signatur abrufen.

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 des Panoramas oder darauf, welches Panorama gefunden wird. Mit der API können dieselben Parameter wie in der Bildanfrage verwendet werden, um das Erstellen einer Metadatenanfrage für eine bestimmte Bildanfrage zu vereinfachen. Bei Metadatenanfragen ignoriert die API jedoch die optionalen Parameter und ihre Werte. Informationen zur Verwendung dieser Parameter finden Sie im Entwicklerleitfaden zur 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"
}

Bildanfrage und -antwort, wo das fehlende Bild zu erwarten ist

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

Die folgenden URLs fordern die Metadaten und das Bild für ein Panorama an, das am oder in der Nähe des angegebenen 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
Platzhalter für keine Bilder

Statuscodes

Das Feld status im Metadatenantwortobjekt enthält den Status der Anfrage sowie möglicherweise Informationen zur Fehlerbehebung, mit denen du herausfinden kannst, 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. Dies kann passieren, wenn du deine Anfrage nicht autorisiert hast oder wenn die Street View Static API im Google Cloud Console-Projekt mit deinem API-Schlüssel nicht aktiviert ist.
"INVALID_REQUEST" Zeigt im Allgemeinen an, dass die Suchparameter (Adresse, latlng oder Komponenten) 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 der Maps API.