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

在遵守 Aerial View API 服务专用条款的前提下，Aerial View API 视频 ID 不受 Google Maps Platform 服务条款第 3.2.3(b) 条（禁止缓存）中规定的缓存限制的约束。因此，您可以存储视频 ID 值以供日后使用。