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