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

Với một địa chỉ hoặc videoID hợp lệ, phương thức lookupVideoMetadata sẽ 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 phần nội dung phản hồi cho phép bạn xác định độ mới của hình ảnh, độ dài của video, đồng thời cung cấp một quy trình 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ủa Hoa Kỳ được mã hoá 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.

Ví dụ về yêu cầu

Mẫu mã sau đây yêu cầu một video chế độ xem từ trên không cho Tháp Transamerica, có địa chỉ 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ụ về 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 kết xuất.

{
  "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. Nguyên nhân có thể là do vị trí này chưa được hiển thị hoặc nằm ở khu vực không được hỗ trợ.

Nếu vị trí nằm trong khu vực được hỗ trợ, bạn có thể dùng renderVideo để bắt đầu yêu cầu kết xuất.

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