Tạo video mới

Chiến lược phát hành đĩa đơn renderVideo Phương thức này yêu cầu tạo video xem từ trên không cho Hoa Kỳ được chỉ định địa chỉ bưu chính. Nếu video đã tồn tại cho địa chỉ được chỉ định, thì URL này trả về siêu dữ liệu về video.

Cách sử dụng API

Tạo video mới từ trên không bằng cách thực hiện yêu cầu POST qua HTTPS đến hàm renderVideo điểm cuối, truyền Khoá API và địa chỉ bưu chính tại Hoa Kỳ, như minh hoạ trong ví dụ sau. Quá trình kết xuất có thể mất từ một giờ lên đến vài giờ.

curl -X POST -d '{
  "address": "POSTAL_ADDRESS"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"

Yêu cầu mẫu

Ví dụ về mã sau đây yêu cầu tạo video chế độ xem từ trên không cho 500 W Đường 2, Austin, TX, 78701.

curl -X POST -d '{
  "address": "500 W 2nd St, Austin, TX 78701"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"

Ví dụ về phản hồi

Các mã mẫu JSON sau đây cho thấy các phản hồi có thể có cho video ví dụ yêu cầu.

Phản hồi địa chỉ không hợp lệ

Địa chỉ không chính xác hoặc không nằm trong lãnh thổ Hoa Kỳ.

{
  "error": {
    "code": 400,
    "message": "Address not supported.",
    "status": "INVALID_ARGUMENT"
  }
}

Đang xử lý câu trả lời

Air View API hiện đang hiển thị video của bạn. Phản hồi chứa videoId để bạn có thể dùng để truy xuất video.

{
  "state": "PROCESSING",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}

Quá trình kết xuất có thể mất từ một giờ đến vài giờ. Nếu video vẫn đang xử lý, bạn có thể sử dụng lookupVideo để thăm dò trạng thái của video cho đến khi trả về trạng thái ACTIVE.

Để thăm dò ý kiến, hãy gửi yêu cầu đến lookupVideo, truyền videoId. Có thể kết xuất có thể mất vài giờ, vì vậy hãy sử dụng hàm hàm mũ thời gian đợi để giãn cách cuộc gọi.

Câu trả lời chủ động

Khi renderVideo trả về giá trị state của ACTIVE, điều này có nghĩa là video đã đã kết xuất xong, bạn có thể truy xuất nội dung này bằng cách gọi lookupVideo bằng phương thức videoId.

{
  "state": "ACTIVE",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}