Tạo video mới

Phương thức renderVideo yêu cầu tạo video chế độ xem từ trên không cho địa chỉ bưu chính cụ thể ở Hoa Kỳ. Nếu video đã tồn tại cho địa chỉ được chỉ định, 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 một video trên không mới bằng cách gửi yêu cầu HTTPS POST đến điểm cuối renderVideo, truyền Khoá API và địa chỉ bưu chính của Hoa Kỳ, như 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"

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

Ví dụ về mã sau đây yêu cầu tạo một video về chế độ xem từ 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ẫu mã JSON 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 thuộc Hoa Kỳ.

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

Đang xử lý phản hồi

Aerial View API hiện đang kết xuất video của bạn. Phản hồi này 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 đến vài giờ. Nếu video vẫn đang xử lý, bạn có thể 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ò, hãy gửi 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 thuật toán thời gian chờ luỹ tiến để giãn cách các lệnh gọi.

Phản hồi chủ động

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 bằng videoId.

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