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 Maps Platform 服务条款第 3.2.3(b)(No Caching) 中规定的缓存限制的约束。因此,您可以存储视频 ID 值以供日后使用。