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 Beispielvideoanfrage.
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 Sie das Video abrufen können.
{
"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 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 videoId aufrufst.
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}