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 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. Periksa apakah Google telah membuat video untuk lokasi menggunakan lookupVideoMetadata.
2. Jika tidak ada video (lookupVideoMetadata menampilkan 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 jarak 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 tersedia untuk siapa saja. Artinya, video tidak dikaitkan dengan pengguna atau akun tertentu.

Alur kerja ini direpresentasikan dalam diagram di bawah:

Menyimpan 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 dinyatakan dalam Pasal 3.2.3(b)(Tanpa Penyimpanan Cache) dalam Persyaratan Layanan Google Maps Platform. Oleh karena itu, Anda dapat menyimpan nilai ID video untuk digunakan nanti.