Cách sử dụng API Aerial View

Aerial View API hỗ trợ 2 quy trình chung. Cách tiếp cận của bạn sẽ phụ thuộc vào việc video mà bạn yêu cầu có tồn tại hay không. Nếu không chắc chắn liệu video có tồn tại hay không, bạn nên sử dụng lookupVideoMetadata để xác định trạng thái của video.

Quy trình tạo hoặc truy xuất video

Hãy làm theo quy trình sau để tạo hoặc truy xuất video ở chế độ xem từ trên không:

1. Kiểm tra xem Google đã tạo video cho vị trí đó hay chưa bằng cách sử dụng lookupVideoMetadata.
2. Nếu không có video nào (lookupVideoMetadata trả về lỗi 404), hãy gọi renderVideo để tạo video mới.
   1. Gọi lookupVideoMetadata bằng cách sử dụng videoId hoặc địa chỉ để thăm dò điểm cuối cho đến khi trạng thái của video là ACTIVE. 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.

3. Nếu video đang hoạt động (lookupVideoMetadata trả về trạng thái ACTIVE), hãy gọi lookupVideo để tìm nạp URI của video.

   Lưu ý: Sau khi Google tạo video cho một địa chỉ cụ thể, mọi người đều có thể xem video đó. Tức là video không được liên kết với một người dùng hoặc tài khoản cụ thể.

Quy trình này được thể hiện trong sơ đồ dưới đây:

Lưu mã video để sử dụng sau

Theo Điều khoản dành riêng cho dịch vụ đối với Aerial View API, mã video Aerial View API không phải tuân thủ các quy định hạn chế về việc lưu vào bộ nhớ đệm nêu trong Mục 3.2.3(b)(Không lưu vào bộ nhớ đệm) của Điều khoản dịch vụ của Nền tảng Google Maps. Do đó, bạn có thể lưu trữ các giá trị mã nhận dạng video để sử dụng sau này.