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