在给定有效地址或视频 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 错误代码。
示例请求
以下代码示例请求了位于 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"
}
}