Neues Video erstellen

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

Verwendung der API

Senden Sie eine HTTPS-POST-Anfrage an den Endpunkt renderVideo und geben Sie dabei Ihren API-Schlüssel und eine US-Postanschrift an, um ein neues Luftbildvideo zu generieren. Das folgende Beispiel zeigt, wie das geht. 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 Draufsicht 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 Videos.

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 zum Abfragen eine Anfrage an lookupVideo und übergeben Sie die videoId. Das Rendern 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 Rendern des Videos abgeschlossen. Du kannst es abrufen, indem du lookupVideo mit dem videoId aufrufst.

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