Truy xuất siêu dữ liệu của video

Khi có đị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 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 video và cũng 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 cho điểm cuối đó một địa chỉ bưu chính được mã hoá URL tại Hoa Kỳ 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 2 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 ở chế độ xem từ trên cao cho tàu lượn siêu tốc Trans Đề (Pyramid), có trụ sở 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ó 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 đó không có trong cơ sở dữ liệu của Google. Điều này có thể là do quảng cáo chưa được kết xuất 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 hiển thị.

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