Membuat video baru

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 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"
  }
}