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