Neues Video generieren

Mit der Methode renderVideo wird die Generierung eines Luftvideos 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

Generieren Sie ein neues Luftbildvideo, indem Sie eine HTTPS-POST-Anfrage an den Endpunkt renderVideo senden und Ihren API-Schlüssel und eine US-Postanschrift übergeben, wie im folgenden Beispiel gezeigt. Das Rendern kann eine Stunde oder auch 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 Generierung eines Luftbildvideos 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 Beispielvideoanfrage.

Ungültige Adressantwort

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

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

Verarbeitungsantwort

Die Aerial View API rendert jetzt Ihr Video. Die Antwort enthält die videoId, mit der Sie das Video abrufen können.

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

Das Rendern kann eine Stunde oder auch mehrere Stunden dauern. Wenn das Video noch verarbeitet wird, können Sie mit lookupVideo den Videostatus abfragen, bis der Status ACTIVE zurückgegeben wird.

Um eine Umfrage zu starten, senden Sie eine Anfrage an lookupVideo und übergeben Sie videoId. Das Rendern kann mehrere Stunden dauern. Verwenden Sie daher exponentielles Backoff, um den Abstand zwischen den Aufrufen zu erhöhen.

Aktive Reaktion

Wenn renderVideo den state-Wert ACTIVE zurückgibt, bedeutet das, dass das Rendern des Videos abgeschlossen ist. Sie können es dann abrufen, indem Sie lookupVideo mit der videoId aufrufen.

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