Tạo video mới

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

Cách sử dụng API

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

Mã ví dụ sau đây yêu cầu tạo video cảnh quan trên không cho địa chỉ 500 W 2nd St, 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ã JSON mẫu sau đây cho thấy các phản hồi có thể có đối với yêu cầu video mẫ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 ở Hoa Kỳ.

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

Xử lý phản hồi

Air View API hiện đang hiển thị video của bạn. Phản hồi chứa videoId mà 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 video cho đến khi video trả về trạng thái ACTIVE.

Để thăm dò ý kiến, hãy tạo một yêu cầu đến lookupVideo, truyền videoId. Quá trình kết xuất có thể mất vài giờ, vì vậy, hãy sử dụng tính năng thuật toán thời gian đợi luỹ thừa để giãn cách các lệnh gọi của bạn.

Phản hồi tích cực

Khi renderVideo trả về giá trị state là ACTIVE, tức là video đã kết thúc quá trình kết xuất và bạn có thể truy xuất video đó bằng cách gọi lookupVideo với videoId.

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