Cách sử dụng API Aerial View

API Chế độ xem đường chân trời hỗ trợ hai quy trình làm việc chung. Phương pháp bạn sử dụng sẽ phụ thuộc vào việc video 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 sử dụng quy trình sau để tạo hoặc truy xuất video cảnh quay 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 videoId hoặc địa chỉ để thăm dò ý kiến đ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 thời gian đợi luỹ thừa để 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à một 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 công việc này được thể hiện trong sơ đồ dưới đây:

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

Theo Điều khoản cụ thể về dịch vụ của API Chế độ xem đường chân trời, mã video của API Chế độ xem đường chân trời 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ã video để sử dụng sau.