如何使用 Aerial View API

Aerial View API 支持两种常规工作流。您采用哪种方法取决于 您请求的视频是否存在。如果您不确定视频是否存在，应使用 lookupVideoMetadata 来确定视频的状态。

生成或检索视频的工作流

使用以下工作流生成或检索航拍视频：

  1. 使用 lookupVideoMetadata检查 Google 是否已为该地点生成视频。
  2. 如果不存在视频（lookupVideoMetadata 返回了 404），请调用 renderVideo 以生成 新视频。
    1. 使用 videoId 或地址调用 lookupVideoMetadata，以轮询 端点，直到视频的状态为 ACTIVE。渲染可能需要几个 小时，因此请使用指数 退避算法来间隔调用。

  3. 如果视频处于活动状态（lookupVideoMetadata 返回了 ACTIVE 状态）， 请调用 lookupVideo 以获取 视频的 URI。

下图展示了此工作流：

显示上述工作流程的图表

保存视频 ID 以供日后使用

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