检索视频的元数据

给定有效的地址或 videoID 后，lookupVideoMetadata 方法会返回与给定视频相关联的元数据。响应正文中的元数据可让您确定影像的新鲜度、视频的长度，还提供了一个免费的工作流来确认视频是否存在。

如何使用该 API

通过向此端点传递网址编码的美国邮政地址或 videoId 来调用此端点。

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS"

然后，API 会返回以下两种响应之一：

  • 如果视频存在，lookupVideoMetadata 会返回视频的元数据。
  • 如果视频不存在，API 会返回 404 错误代码。

示例请求

以下代码示例请求获取位于加利福尼亚州旧金山蒙哥马利街 600 号的泛美金字塔的鸟瞰视频。

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=600%20Montgomery%20St%2C%20San%20Francisco%2C%20CA%2094111"

示例响应

以下 JSON 示例展示了对 lookupVideoMetadata 请求的所有可能响应。

找到视频

相应视频已经渲染完毕。

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "captureDate": {
    "year": 2022,
    "month": 4,
    "day": 1
  },
  "duration": "40s",
  "state": "ACTIVE"
}

视频正在渲染

视频正在呈现。

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "state": "PROCESSING"
}

找不到视频

视频不在 Google 的数据库中。这可能是因为该位置信息尚未呈现，也可能是因为该位置信息位于不受支持的区域。

如果位置信息位于支持的区域，您可以使用 renderVideo 发起渲染请求。

{
  "error": {
    "code": 404,
    "message": "Video not found.",
    "status": "NOT_FOUND"
  }
}