Cách sử dụng API Aerial View

API Chế độ xem trên không hỗ trợ hai quy trình làm việc chung. Phương pháp của bạn phụ thuộc vào việc video bạn đang yêu cầu có tồn tại hay không. Nếu không chắc 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

Sử dụng quy trình làm việc sau đây để 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 lookupVideoMetadata.
2. Nếu không có video nào tồn tại (lookupVideoMetadata trả về mã 404), hãy gọi renderVideo để tạo một video mới.
   1. Gọi lookupVideoMetadata bằ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 tính nă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 đó. Điều này nghĩa 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 làm 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 dành riêng cho dịch vụ dành cho API Chế độ xem trên không, mã video của API Chế độ xem trên không được miễn hạn chế 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ữ giá trị mã video để sử dụng sau này.