Metadaten eines Videos abrufen

Bei einer gültigen Adresse oder VideoID gibt die Methode lookupVideoMetadata Metadaten zurück, die mit einem bestimmten Video verknüpft sind. Anhand der Metadaten im Antworttext können Sie die Aktualität der Bilder und die Länge des Videos ermitteln. Außerdem wird ein kostenloser Workflow zum Bestätigen der Existenz von Videos bereitgestellt.

Verwendung der API

Rufen Sie diesen Endpunkt auf, indem Sie ihm eine URL-codierte US-Postanschrift oder einen 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 Pyramid unter der Adresse 600 Montgomery St, San Francisco, CA 94111 angefordert.

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 ist nicht in der Datenbank von Google. Das kann daran liegen, dass die Karte noch nicht gerendert wurde oder sich der Standort in einem nicht unterstützten Gebiet befindet.

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

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