Street View-Bild-Metadaten

Einführung

Die Metadatenanfragen der Street View Static API liefern Daten über Panoramen ansehen Mithilfe der Metadaten können Sie herausfinden, ob ein Street View-Bild an einem bestimmten Standort verfügbar ist. Außerdem erhalten Sie programmatischen Zugriff auf die Breiten- und Längengrade, die Panorama-ID, das Datum, an dem das Foto sowie die Urheberrechtsinformationen für das Bild. Zugriff Metadaten können Sie das Fehlerverhalten in Ihrer Anwendung anpassen.

Metadatenanfragen für die Street View Static API sind verfügbar: zu laden. Beim Anfordern von Metadaten wird kein Kontingent verbraucht. <ph type="x-smartling-placeholder"></ph> Das Kontingent wird nur verbraucht, wenn Sie ein Bild mit dem Street View Static API

Bei Anfragen zu Street View-Bildmetadaten werden die Panoramabilder ist 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 (&).

Erforderliche Parameter für Metadatenanfragen

Die Metadatenanfragen akzeptieren die denselben URL-Parameter wie bei Bildanfragen für die Street View Static API, obwohl nur sind folgende Parameter erforderlich:

Entweder:

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

Oder:

  • pano: eine bestimmte Panorama-ID. Panoramen können sich im Laufe der Zeit ändern. diese ID nicht beibehalten. Speichern Sie stattdessen die Standortadresse oder Längen- und Breitengrade angeben, damit Sie die Panorama-ID aktualisieren können. Für finden Sie unter Gelöschte Panorama-IDs aktualisieren.

Ebenso wie:

  • key und signature: Der API-Schlüssel ist zur Authentifizierung des In bestimmten Fällen ist auch die digitale Signatur erforderlich. immer empfohlen. Weitere Informationen finden Sie unter Schlüssel und Signatur anfordern

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 versuchen, eine Panorama-ID abzurufen und entweder ZERO_RESULTS oder keinen Wert enthält, wurde die Panorama-ID gelöscht und muss aktualisiert werden.

  1. Speichern Sie die Standortadresse oder die Breiten- und Längengrade, die Sie für erhalten Sie eine Panorama-ID, damit Sie sie bei Bedarf aktualisieren können.

  2. Wenn Sie feststellen, dass sich eine Panorama-ID geändert hat, verwenden Sie den ursprünglichen Standort. oder Längen- und Breitengrade angeben, um nach dem nächstgelegenen Panoramen zu diesem Ort hinzufügen und eine neue Panorama-ID abrufen.

Optionale Parameter für Metadatenanfragen

Sie können die folgenden Parameter in Ihre Metadatenanfrage aufnehmen: size, heading, fov und pitch. Diese Parameter wirken sich nicht die Daten über das Panorama zu erfassen oder welches Panorama gefunden wird. Die API ermöglicht die Aufnahme derselben Parameter wie der Bilderanfrage um das Erstellen einer Metadatenanfrage für ein bestimmtes Bild zu vereinfachen Bei Metadatenanfragen ignoriert die API die optionalen Parameter und ihre Werte. Informationen zur Verwendung dieser Parameter finden Sie in der Entwicklerhandbuch für die Street View Static API

Antwortformat

Metadatenantworten werden nur im JSON-Format zurückgegeben.

Beispiele

Beispiel 1: Panorama gefunden

Die folgenden URLs fordern erfolgreich die Metadaten und das Bild derselben an -Panorama.

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
Eiffelturm

Beispiel 2: Panorama nicht gefunden

Die folgenden URLs fordern die Metadaten und das Bild für ein Panorama an, das wurde am oder in der Nähe des angegebenen Standorts nicht gefunden.

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

Statuscodes

Das Feld status innerhalb des Metadaten-Antwortobjekts enthält den Status der und kann Debugging-Informationen enthalten, die Ihnen bei der Fehlerbehebung helfen, warum die Street View-Anfrage nicht funktioniert. Das Feld status kann Folgendes enthalten: folgende Werte:

Status Beschreibung
"OK" Gibt an, dass keine Fehler aufgetreten sind. ein Panorama gefunden und die 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 existierende oder ungültige Panorama-ID angeben. Weitere Informationen finden Sie unter [Gelöschte Panorama-IDs aktualisieren](#refresh-pano).
"NOT_FOUND" Gibt an, dass der in location angegebene Adressstring angegeben ist. nicht gefunden. Diese Meldung kann angezeigt werden, wenn eine Adresse nicht existiert. gegeben ist.
"OVER_QUERY_LIMIT" Gibt an, dass Sie Ihr Tageskontingent oder das Kontingent pro Sekunde überschritten haben für diese API.
"REQUEST_DENIED" Gibt an, dass die Anforderung abgelehnt wurde. Diese Meldung kann angezeigt werden, wenn Sie Ihre Anfrage nicht autorisieren oder wenn die Die Street View Static API ist im Google Cloud Console-Projekt, das Ihren API-Schlüssel enthält.
"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 tritt oft nur vorübergehend auf. Die Anfrage ist möglicherweise erfolgreich, wenn Sie es erneut versuchen.

Weitere Informationen

Weitere Informationen zur Verwendung der Street View Static API oder anderen Google Maps API-Produkten nutzen, sehen Sie sich die Google Maps API Supportseite.