生成新视频

通过 renderVideo 方法用于请求生成指定美国的航拍视频 邮政地址。如果指定地址的视频已经存在,则此 方法会返回视频的相关元数据。

如何使用该 API

要生成新的航拍视频,请将 HTTPS POST 请求发送到 renderVideo 端点,传递您的 API 密钥和美国邮政地址,如下所示: 。呈现过程可能需要一个小时 到几个小时。

curl -X POST -d '{
  "address": "POSTAL_ADDRESS"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"

示例请求

以下代码示例请求为以下对象生成航拍视频 500 W 2nd St, Austin, TX, 78701。

curl -X POST -d '{
  "address": "500 W 2nd St, Austin, TX 78701"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"

示例响应

以下 JSON 代码示例展示了对示例视频可能做出的响应 请求。

地址响应无效

地址不正确或不在美国境内。

{
  "error": {
    "code": 400,
    "message": "Address not supported.",
    "status": "INVALID_ARGUMENT"
  }
}

正在处理响应

Aerial View API 目前正在渲染您的视频。响应包含 videoId,您可以使用该标记检索视频。

{
  "state": "PROCESSING",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}

呈现过程可能需要一个小时到几个小时不等。如果 视频仍在处理中,你可以使用lookupVideo轮询视频状态 直到返回 ACTIVE 状态为止。

如需轮询,请向 lookupVideo 发出请求,并传递 videoId。呈现 需要几个小时,因此请使用指数 退避算法来间隔开局。

主动响应

如果 renderVideo 返回的 state 值为 ACTIVE,则表示视频 渲染完成,您可以调用 lookupVideovideoId

{
  "state": "ACTIVE",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}