如何使用 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 供日後使用

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