Mit der Methode renderVideo wird die Erstellung eines Luftbildvideos für die angegebene US-Postanschrift angefordert. Wenn das Video für die angegebene Adresse bereits vorhanden ist, werden mit dieser Methode Metadaten zum Video zurückgegeben.
Verwendung der API
Senden Sie eine HTTPS-POST-Anfrage an den Endpunkt renderVideo und geben Sie dabei Ihren API-Schlüssel und eine US-Postanschrift an, um ein neues Luftbildvideo zu generieren. Das folgende Beispiel zeigt, wie das geht. Das Rendern kann eine bis mehrere 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
Im folgenden Codebeispiel wird die Erstellung eines Videos mit einer Draufsicht 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 Beispielanfrage für Videos.
Ungültige Antwort auf Adressanfrage
Die Adresse ist entweder falsch oder befindet sich nicht in den USA.
{
"error": {
"code": 400,
"message": "Address not supported.",
"status": "INVALID_ARGUMENT"
}
}
Verarbeitungsantwort
Ihr Video wird jetzt mit der Aerial View API gerendert. Die Antwort enthält den videoId, mit dem du das Video abrufen kannst.
{
"state": "PROCESSING",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}
Das Rendern kann eine bis mehrere Stunden dauern. Wenn das Video noch verarbeitet wird, kannst du den Videostatus mit lookupVideo abfragen, bis der Status ACTIVE zurückgegeben wird.
Stellen Sie eine Anfrage an lookupVideo und geben Sie dabei videoId an. Das Rendern kann mehrere Stunden dauern. Verwenden Sie daher exponentielles Backoff, um die Aufrufe zu verteilen.
Aktive Antwort
Wenn renderVideo den state-Wert ACTIVE zurückgibt, ist das Rendern des Videos abgeschlossen. Du kannst es abrufen, indem du lookupVideo mit dem videoId aufrufst.
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}