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 Anda 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. Periksa apakah Google telah membuat video untuk lokasi tersebut 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 adalah ACTIVE. Rendering dapat memerlukan waktu beberapa jam, jadi gunakan penghentian eksponensial untuk memberi jeda pada panggilan Anda.

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

Alur kerja ini direpresentasikan dalam diagram di bawah:

Diagram yang menampilkan alur kerja yang diuraikan di atas

Menyimpan ID video untuk digunakan nanti

Dengan 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)(Tidak Ada Penyimpanan Cache) dalam Persyaratan Layanan Google Maps Platform. Oleh karena itu, Anda dapat menyimpan nilai ID video untuk digunakan nanti.