Tujuan
renderVideo
meminta pembuatan video tampilan udara untuk AS yang ditentukan
alamat pos Anda. Jika video sudah ada untuk alamat yang ditentukan,
mengembalikan metadata tentang video.
Cara menggunakan API
Buat video udara baru dengan membuat permintaan HTTPS POST ke
renderVideo
endpoint, meneruskan Kunci API dan alamat pos AS, seperti yang ditunjukkan
dalam contoh berikut. Proses rendering bisa memakan waktu satu jam
hingga beberapa jam.
curl -X POST -d '{ "address": "POSTAL_ADDRESS" }' \ -H 'Content-Type: application/json' \ "https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"
Contoh permintaan
Contoh kode berikut meminta pembuatan video tampilan udara untuk 500 W 2nd St, Austin, TX, 78701.
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"
Contoh respons
Contoh kode JSON berikut menunjukkan kemungkinan respons terhadap contoh video permintaan.
Respons alamat tidak valid
Alamat salah atau tidak berada di Amerika Serikat.
{
"error": {
"code": 400,
"message": "Address not supported.",
"status": "INVALID_ARGUMENT"
}
}
Memproses respons
Aerial View API sedang merender video Anda. Respons berisi
videoId
, yang dapat Anda gunakan untuk mengambil video.
{
"state": "PROCESSING",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}
Proses rendering bisa memakan waktu mulai dari satu jam hingga beberapa jam. Jika
video masih diproses, Anda dapat menggunakan lookupVideo
untuk melakukan polling status video
sampai menghasilkan status ACTIVE
.
Untuk melakukan polling, buat permintaan ke lookupVideo
, dengan meneruskan videoId
. Rendering dapat
memerlukan waktu beberapa jam, jadi gunakan eksponensial
backoff untuk mengatur jarak panggilan Anda.
Respons aktif
Jika renderVideo
menampilkan nilai state
dari ACTIVE
, artinya video memiliki
selesai merender, dan Anda dapat mengambilnya dengan memanggil lookupVideo
dengan
videoId
.
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}