Mit der Methode renderVideo wird die Erstellung eines Luftbilds für die angegebene US-Postadresse 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 Luftbild. Stellen Sie dazu eine HTTPS-POST-Anfrage an den Endpunkt renderVideo und übergeben Sie Ihren API-Schlüssel und eine US-Postanschrift, wie im folgenden Beispiel gezeigt. Das Rendering 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 Erstellung eines Luftbilds 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 liegt nicht in den USA.
{
"error": {
"code": 400,
"message": "Address not supported.",
"status": "INVALID_ARGUMENT"
}
}
Antwort wird verarbeitet
Die Aerial View API rendert jetzt dein Video. Die Antwort enthält das videoId, mit dem Sie das Video abrufen können.
{
"state": "PROCESSING",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}
Das Rendern kann zwischen einer Stunde und mehreren Stunden dauern. Wenn das Video noch verarbeitet wird, können Sie mit lookupVideo den Videostatus abfragen, bis es den Status ACTIVE zurückgibt.
Um eine Abfrage durchzuführen, senden Sie eine Anfrage an lookupVideo und übergeben Sie videoId. Das Rendering kann mehrere Stunden dauern. Verwenden Sie daher den exponentiellen Backoff, um Ihre Aufrufe aufzuteilen.
Aktive Antwort
Wenn renderVideo den state-Wert ACTIVE zurückgibt, ist das Rendern des Videos abgeschlossen. Du kannst es abrufen, indem du lookupVideo mit der videoId aufrufst.
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}