Neues Video erstellen

Die renderVideo -Methode die Generierung eines Luftbildvideos für die angegebenen US-amerikanischen Postanschrift. Wenn das Video für die angegebene Adresse bereits vorhanden ist, wird dies gibt Metadaten zum Video zurück.

Verwendung der API

Generieren Sie ein neues Luftvideo, indem Sie eine HTTPS-POST-Anfrage an die renderVideo Endpunkt, indem du deinen API-Schlüssel und eine US-Postadresse wie unten gezeigt übergibst. im folgenden Beispiel. Der Rendering-Prozess kann bis zu einer Stunde dauern. auf ein paar Stunden.

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, USA.

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 das Beispielvideo.

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"
  }
}

Antwort wird verarbeitet

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

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

Der Rendering-Prozess kann zwischen einer und mehreren Stunden dauern. Wenn die Das Video wird noch verarbeitet. Mit lookupVideo kannst du den Videostatus abfragen. bis sie den Status ACTIVE zurückgibt.

Stellen Sie zum Abfragen eine Anfrage an lookupVideo und übergeben Sie die videoId. Das Rendern kann die mehrere Stunden dauern. Verwenden Sie daher exponentielle Backoff für mehr Abstände zwischen Ihren Anrufen.

Aktive Antwort

Wenn renderVideo den state-Wert ACTIVE zurückgibt, wurde das Video das Rendering abgeschlossen haben. Sie können es abrufen, indem Sie lookupVideo mit der Methode videoId

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