如何使用 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 值以供日后使用。