Mit der Methode renderVideo
wird die Generierung eines Luftbildvideos für die angegebene US-Postadresse angefordert. Wenn das Video für die angegebene Adresse bereits vorhanden ist, gibt diese Methode Metadaten zum Video zurück.
Verwendung der API
Erstellen Sie ein neues Luftvideo. Stellen Sie dazu eine HTTPS-POST-Anfrage an den Endpunkt renderVideo
und übergeben Sie Ihren API-Schlüssel und eine US-Postadresse, wie im folgenden Beispiel gezeigt. Der Rendering-Prozess kann zwischen einer Stunde und einigen 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
Mit dem 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"
}
}
Antwort wird verarbeitet
Die Aerial View API rendert Ihr Video jetzt. Die Antwort enthält den videoId
, mit dem Sie das Video abrufen können.
{
"state": "PROCESSING",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}
Der Rendering-Prozess kann zwischen einer und mehreren Stunden dauern. Wenn das Video noch verarbeitet wird, können Sie den Videostatus mit lookupVideo
abfragen, bis es den Status ACTIVE
zurückgibt.
Stellen Sie zum Abfragen eine Anfrage an lookupVideo
und übergeben Sie die videoId
. Das Rendering kann mehrere Stunden dauern. Verwenden Sie daher den exponentiellen Backoff, um die Aufrufe zu begrenzen.
Aktive Antwort
Wenn renderVideo
den state
-Wert ACTIVE
zurückgibt, ist das Video fertig gerendert. Du kannst es abrufen, indem du lookupVideo
mit der videoId
aufrufst.
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}