检索视频的元数据

在给定有效地址或视频 ID 的情况下, lookupVideoMetadata 方法返回与指定视频相关联的元数据。此 响应正文可让您确定图像的时效性、 视频,还提供了用于确认视频是否存在的免费工作流程。

如何使用该 API

要调用此端点,请向其传递网址编码的美国邮政编号 地址或 videoId

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

然后,API 会返回以下两个响应之一:

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

示例请求

以下代码示例请求了泛美的航拍视频 Pyramid,位于 600 Montgomery St, San Francisco, CA 94111。

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"
  }
}