Khi được cung cấp một địa chỉ hoặc videoID hợp lệ,
lookupVideoMetadata
trả về siêu dữ liệu được liên kết với một video nhất định. Siêu dữ liệu trong
nội dung phản hồi cho phép bạn xác định độ mới của hình ảnh, thời lượng của
video đồng thời cung cấp quy trình làm việc miễn phí để xác nhận sự tồn tại của video.
Cách sử dụng API
Gọi điểm cuối này bằng cách truyền điểm cuối đó qua đường bưu điện của Hoa Kỳ được mã hoá bằng URL
hoặc
videoId
.
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS "
Sau đó, API này sẽ trả về một trong hai phản hồi sau đây:
- Nếu video tồn tại,
lookupVideoMetadata
sẽ trả về siêu dữ liệu của video. - Nếu video không tồn tại, API sẽ trả về mã lỗi 404.
Yêu cầu mẫu
Mã mẫu sau đây yêu cầu một video quay từ trên không cho Transamerica Kim tự tháp, nằm tại 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"
Ví dụ về phản hồi
Các ví dụ JSON sau đây minh hoạ tất cả các phản hồi có thể có cho
Yêu cầu lookupVideoMetadata
.
Đã tìm thấy video
Video này đã được hiển thị.
{
"videoId": "Ul1naoFmqo69U1zUVrQRkc",
"captureDate": {
"year": 2022,
"month": 4,
"day": 1
},
"duration": "40s",
"state": "ACTIVE"
}
Video đang hiển thị
Video đang hiển thị.
{
"videoId": "Ul1naoFmqo69U1zUVrQRkc",
"state": "PROCESSING"
}
Không tìm thấy video
Video này không có trong cơ sở dữ liệu của Google. Điều này có thể là do bị hiển thị hoặc do vị trí nằm trong khu vực không được hỗ trợ.
Nếu vị trí nằm trong
, bạn có thể sử dụng
renderVideo
để bắt đầu một yêu cầu kết xuất.
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}