Neues Video generieren

Mit der Methode renderVideo wird die Erstellung eines Luftbildvideos für die angegebene Postanschrift in den USA angefordert. Wenn das Video für die angegebene Adresse bereits vorhanden ist, werden mit dieser Methode Metadaten zum Video zurückgegeben.

Verwendung der API

Erstellen Sie ein neues Luftbildvideo, indem Sie eine HTTPS-POST-Anfrage an den Endpunkt renderVideo senden und dabei Ihren API-Schlüssel und eine US-Postanschrift angeben, wie im folgenden Beispiel gezeigt. Das Rendern kann eine bis mehrere Stunden dauern.

curl -X POST -d '{
  "address": "POSTAL_ADDRESS"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"

Beispielanfrage

Im folgenden Codebeispiel wird die Erstellung eines Videos mit einer Drohnenaufnahme für 500 W 2nd St, Austin, TX, 78701 angefordert.

curl -X POST -d '{
  "address": "500 W 2nd St, Austin, TX 78701"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"

Beispielantwort

Die folgenden JSON-Codebeispiele zeigen die möglichen Antworten auf die Beispielanfrage für ein Video.

Ungültige Antwort auf Adressanfrage

Die Adresse ist entweder falsch oder befindet sich nicht in den USA.

{
  "error": {
    "code": 400,
    "message": "Address not supported.",
    "status": "INVALID_ARGUMENT"
  }
}

Verarbeitungsantwort

Ihr Video wird jetzt mit der Aerial View API gerendert. Die Antwort enthält den videoId, mit dem du das Video abrufen kannst.

{
  "state": "PROCESSING",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}

Das Rendern kann eine bis mehrere Stunden dauern. Wenn das Video noch verarbeitet wird, kannst du den Videostatus mit lookupVideo abfragen, bis der Status ACTIVE zurückgegeben wird.

Stellen Sie eine Anfrage an lookupVideo und übergeben Sie dabei videoId. Das Rendering kann mehrere Stunden dauern. Verwenden Sie daher exponentielles Backoff, um die Aufrufe zu verteilen.

Aktive Antwort

Wenn renderVideo den state-Wert ACTIVE zurückgibt, ist das Video fertig gerendert. Du kannst es abrufen, indem du lookupVideo mit dem videoId aufrufst.

{
  "state": "ACTIVE",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}