Membuat video baru

Metode renderVideo meminta pembuatan video tampilan udara untuk alamat pos AS yang ditentukan. Jika video sudah ada untuk alamat yang ditentukan, metode ini akan menampilkan metadata tentang video tersebut.

Cara menggunakan API

Buat video udara baru dengan membuat permintaan POST HTTPS ke endpoint renderVideo, dengan meneruskan Kunci API dan alamat pos AS, seperti yang ditunjukkan dalam contoh berikut. Proses rendering dapat memerlukan waktu dari 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 permintaan video.

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 kini merender video Anda. Respons akan berisi videoId, yang dapat Anda gunakan untuk mengambil video.

{
  "state": "PROCESSING",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}

Proses rendering bisa memakan waktu dari satu jam hingga beberapa jam. Jika video masih diproses, Anda dapat menggunakan lookupVideo untuk melakukan polling status video hingga menampilkan status ACTIVE.

Untuk melakukan polling, buat permintaan ke lookupVideo, dengan meneruskan videoId. Rendering dapat memerlukan waktu beberapa jam, jadi gunakan backoff eksponensial untuk menghemat ruang panggilan Anda.

Respons aktif

Jika renderVideo menampilkan nilai state dari ACTIVE, artinya video telah selesai dirender, dan Anda dapat mengambilnya dengan memanggil lookupVideo dengan videoId.

{
  "state": "ACTIVE",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}