生成新视频

renderVideo 方法会请求为指定的美国邮政地址生成航拍视频。如果指定地址的视频已存在，则此方法会返回有关该视频的元数据。

如何使用该 API

如需生成新的航拍视频，请向 renderVideo 端点发出 HTTPS POST 请求，并传递您的 API 密钥和美国邮政地址，如以下示例所示。渲染过程可能需要 1 小时到数小时不等。

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，您可以使用该 ID 检索视频。

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

渲染过程可能需要 1 小时到数小时不等。如果视频仍在处理中，您可以使用 lookupVideo 轮询视频状态直到其返回 ACTIVE 状态。

如需轮询，请向 lookupVideo 发出请求，并传递 videoId。渲染可能需要几个小时，因此请使用指数退避算法来间隔调用。

有效响应

当 renderVideo 返回 ACTIVE 的 state 值时，表示视频已完成渲染，您可以通过使用 videoId 调用 lookupVideo 来检索该视频。

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