如何使用 Aerial View API

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

生成或检索视频的工作流

请按照以下工作流生成或检索航拍视频:

  1. 检查 Google 是否已使用 lookupVideoMetadata 为相应地点生成视频。
  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)(No Caching) 中规定的缓存限制的约束。因此,您可以存储视频 ID 值以供日后使用。