如何使用 Aerial View API

Aerial View API 支援兩種一般工作流程。您採取的做法取決於您要求的影片是否存在。如果不確定影片是否存在，請使用 lookupVideoMetadata 判斷影片狀態。

產生或擷取影片的工作流程

請按照下列工作流程產生或擷取空拍影片：

1. 使用 lookupVideoMetadata 查看 Google 是否已為該地點產生影片。
2. 如果沒有影片 (lookupVideoMetadata 傳回 404)，請呼叫 renderVideo 產生新影片。
   1. 使用 videoId 或地址呼叫 lookupVideoMetadata，以便輪詢端點，直到影片狀態為 ACTIVE 為止。算繪作業可能需要數小時的時間，因此請使用指數輪詢來間隔呼叫。

3. 如果影片處於活動狀態 (lookupVideoMetadata 傳回 ACTIVE 狀態)，請呼叫 lookupVideo 擷取影片的 URI。

   注意： Google 為特定地址產生影片後，任何人都可以觀看該影片。也就是說，影片並未與特定使用者或帳戶建立關聯。

下圖呈現了這個工作流程：

儲存影片 ID 供日後使用

根據《Aerial View API 服務專屬條款》的規定，Aerial View API 影片 ID 不受《Google 地圖平台服務條款》第 3.2.3(b) 節 (禁止快取)的快取限制約束。因此，您可以儲存影片 ID 值供日後使用。