Membuat video baru

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

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

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

Proses rendering dapat memerlukan 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, yang meneruskan videoId. Rendering dapat memerlukan waktu beberapa jam, jadi gunakan backoff eksponensial untuk mengatur jarak 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"
  }
}