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 spezifische 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
undsignature
: 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=<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
leer ist, wurde die Panorama-ID gelöscht und muss aktualisiert werden.
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.
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
Bilderaufnahme
um das Erstellen einer Metadatenanfrage für ein bestimmtes Bild zu vereinfachen
Bei Metadaten-Anfragen ignoriert die API jedoch 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 desselben Namens 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
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
Statuscodes
Das Feld status
innerhalb des Metadaten-Antwortobjekts enthält den Status der
Anfrage 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 verwenden, sehen Sie sich die Google Maps API Supportseite.