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