Cara menggunakan Aerial View API

Aerial View API mendukung dua alur kerja umum. Pendekatan Anda bergantung pada apakah video yang Anda minta ada atau tidak. Jika tidak yakin apakah video tersebut ada, Anda harus menggunakan lookupVideoMetadata untuk menentukan status video.

Alur kerja untuk membuat atau mengambil video

Gunakan alur kerja berikut untuk membuat atau mengambil video tampilan udara:

1. Memeriksa apakah Google sudah membuat video untuk lokasi tersebut menggunakan lookupVideoMetadata.
2. Jika tidak ada video (lookupVideoMetadata menampilkan error 404), panggil renderVideo untuk membuat video baru.
   1. Panggil lookupVideoMetadata menggunakan videoId atau alamat untuk melakukan polling endpoint hingga status video menjadi ACTIVE. Rendering dapat memerlukan waktu beberapa jam, jadi gunakan backoff eksponensial untuk mengatur waktu panggilan.

3. Jika video aktif (lookupVideoMetadata menampilkan status ACTIVE), panggil lookupVideo untuk mengambil URI video.

   Catatan: Setelah Google membuat video untuk alamat tertentu, video tersebut akan tersedia bagi siapa saja. Artinya, video tidak dikaitkan dengan pengguna atau akun tertentu.

Alur kerja ini ditunjukkan dalam diagram di bawah:

Simpan ID video untuk digunakan nanti

Tunduk pada Persyaratan Khusus Layanan untuk Aerial View API, ID video Aerial View API dikecualikan dari pembatasan penyimpanan cache yang disebutkan di Pasal 3.2.3(b)(Tanpa Cache) dalam Persyaratan Layanan Google Maps Platform. Oleh karena itu, Anda dapat menyimpan nilai ID video untuk digunakan nanti.