Video-Metadaten abrufen

Mit einer gültigen Adresse oder Video-ID wird der lookupVideoMetadata gibt Metadaten zurück, die mit einem bestimmten Video verknüpft sind. Die Metadaten in der Response body können Sie die Aktualität der Bilder, die Länge des Video und bietet außerdem einen kostenlosen Workflow zur Bestätigung der Existenz von Videos.

Verwendung der API

Rufen Sie diesen Endpunkt auf, indem Sie ihm eine URL-codierte US-Postkarte senden. oder eine videoId

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

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

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

Beispielanfrage

Im folgenden Codebeispiel wird ein Luftbildvideo für den Pyramide in der 600 Montgomery St, San Francisco, CA 94111, USA.

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

In den folgenden JSON-Beispielen werden 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. Möglicherweise wurde sie entweder noch nicht gerendert wurde oder der Standort sich in einer Region befindet, die nicht unterstützt wird.

Befindet sich der Standort in einem unterstützten können Sie den Bereich renderVideo um eine Renderinganfrage zu starten.

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