如何使用 Aerial View API

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

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

請使用下列工作流程產生或擷取鳥瞰影片：

1. 檢查 Google 是否已使用 lookupVideoMetadata 針對該位置產生影片。
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 值供日後使用。