如何使用 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)(No Caching) 中规定的缓存限制的约束。因此，您可以存储视频 ID 值以供日后使用。