Video-Metadaten abrufen

Wenn eine gültige Adresse oder Video-ID angegeben wird, gibt die Methode lookupVideoMetadata die mit einem bestimmten Video verknüpften Metadaten zurück. Mit den Metadaten im Antworttext können Sie die Aktualität der Bilder und die Länge des Videos bestimmen. Außerdem steht Ihnen ein kostenloser Workflow zur Verfügung, mit dem Sie die Existenz von Videos bestätigen können.

Verwendung der API

Rufen Sie diesen Endpunkt auf, indem Sie eine URL-codierte US-Postanschrift oder eine videoId übergeben.

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS"

Die API gibt dann eine der folgenden beiden Antworten zurück:

  • Wenn das Video vorhanden ist, gibt lookupVideoMetadata die Metadaten des Videos zurück.
  • Wenn das Video nicht vorhanden ist, gibt die API den Fehlercode 404 zurück.

Beispielanfrage

Im folgenden Codebeispiel wird ein Luftaufnahmevideo für die Transamerica Pyramide angefordert, die sich in 600 Montgomery St., San Francisco, CA 94111, befindet.

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=600%20Montgomery%20St%2C%20San%20Francisco%2C%20CA%2094111"

Beispielantwort

Die folgenden JSON-Beispiele zeigen alle möglichen Antworten auf die lookupVideoMetadata-Anfrage.

Video gefunden

Das Video wurde bereits gerendert.

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "captureDate": {
    "year": 2022,
    "month": 4,
    "day": 1
  },
  "duration": "40s",
  "state": "ACTIVE"
}

Video wird gerendert

Das Video wird gerendert.

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "state": "PROCESSING"
}

Video nicht gefunden

Das Video befindet sich nicht in der Datenbank von Google. Das kann daran liegen, dass die Karte noch nicht gerendert wurde oder dass sich der Standort in einer Region befindet, die nicht unterstützt wird.

Wenn sich der Standort in einem unterstützten Gebiet befindet, können Sie mit renderVideo eine Renderanfrage starten.

{
  "error": {
    "code": 404,
    "message": "Video not found.",
    "status": "NOT_FOUND"
  }
}