Aerial View API 支援兩種一般工作流程。適用方式取決於您要求的影片是否存在。如果不確定影片是否存在,請使用 lookupVideoMetadata
來判斷影片的狀態。
產生或擷取影片的工作流程
請使用下列工作流程產生或擷取鳥瞰影片:
- 檢查 Google 是否已使用
lookupVideoMetadata
針對該位置產生影片。 - 如果沒有影片 (
lookupVideoMetadata
傳回 404),請呼叫renderVideo
以產生新的影片。- 使用
videoId
或位址呼叫lookupVideoMetadata
,以輪詢端點,直到影片的狀態為ACTIVE
。轉譯作業可能需要數小時才能完成,因此請使用指數輪詢讓呼叫之間的間距。
- 使用
如果影片為有效狀態 (
lookupVideoMetadata
會傳回ACTIVE
的狀態),請呼叫lookupVideo
以擷取影片的 URI。
相關工作流程如下圖所示:
儲存影片 ID 供日後使用
根據《Aerial View API 服務專屬條款》的規定,Aerial View API 影片 ID 不受《Google 地圖平台服務條款》第 3.2.3(b)(無快取) 節中所述的快取限制約束。因此,您可以儲存影片 ID 值供日後使用。