GET https://contrails.googleapis.com/v2/grids: Nhận lưới dự báo về vệt khói.
Nếu thành công, phản hồi sẽ là một NetCDF gồm các giá trị bức xạ do vết phản lực.
Tham số truy vấn
| Tham số | |
|---|---|
time |
Bắt buộc. Thời gian yêu cầu. Định dạng: Chuỗi ngày giờ ISO 8601 HOẶC số nguyên thời gian bắt đầu của Unix Ví dụ: |
bbox[] |
Không bắt buộc. Ranh giới của khu vực cần trả về. Định dạng: [lng_min, lat_min, lng_max, lat_max] Ví dụ: |
aircraftType |
Không bắt buộc. Mã máy bay. Định dạng: Mã loại máy bay ICAO gồm 4 ký tự Ví dụ: |
flightLevel[] |
Không bắt buộc. Các cấp độ bay sẽ trả về. Nếu bạn không chỉ định cấp độ chuyến bay, thì tất cả cấp độ chuyến bay đều được đưa vào. Định dạng: Độ cao bay tính bằng hectofeet; [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440] Ví dụ: |
format |
Không bắt buộc. Định dạng được yêu cầu. Việc truyền vào một giá trị khác với "netcdf4" sẽ gây ra lỗi UNIMPLEMENTED vì không hỗ trợ đa giác. |
aircraftClass |
Không bắt buộc. Loại máy bay. Hiện tại, chúng tôi chỉ hỗ trợ |
data[] |
Không bắt buộc. Trường này chỉ định những biến dữ liệu cần đưa vào phản hồi. Nó có thể xử lý một hoặc nhiều biến dữ liệu.
Nếu trường này trống hoặc không được cung cấp, thì giá trị mặc định sẽ là Ví dụ: |
Ví dụ
Cách truy xuất lưới đường bay mặc định trên toàn cầu cho một thời điểm cụ thể:
response = requests.get( url="https://contrails.googleapis.com/v2/grids", params={"time": 2026-01-27T12:00:00Z}, headers={"x-goog-api-key": API_KEY}, )Khi được tải bằng xarray, yêu cầu này sẽ trả về tập dữ liệu sau:
Kích thước: (kinh độ: 1441, vĩ độ: 721, độ cao bay: 18, thời gian: 1) Tọa độ Tên Kích thước Loại dữ liệu Giá trị longitude (kinh độ) float32 -180.0 -179.8 ... 179.8 1... latitude (vĩ độ) float32 -90.0 -89.75 -89.5 ... 8... flight_level (flight_level) int16 270 280 290 300 ... 41... time (thời gian) datetime64[ns] 2026-01-28T20:00:00 forecast_reference_time (thời gian) datetime64[ns] 2026-01-27T08:00:00 Biến dữ liệu vệt khói trắng (kinh độ, vĩ độ, độ cao bay, thời gian) float32 0.0 0.0 0.0 0.0 ... 0.0 ... Thuộc tính inference_pipeli... contrails.forecast-pipeline_20260115.02_p0 api_version : contrails.api-service_20260125.00_p0 aircraft_class : mặc định Để truy xuất một lưới bị giới hạn trong một ranh giới địa lý cụ thể và được lọc theo một loại máy bay cụ thể, với thời gian được chỉ định là một số nguyên theo kỷ nguyên Unix:
response = requests.get( url="https://contrails.googleapis.com/v2/grids", params={"time": 1769508160, "bbox": [-40, 20, 20, 60], "aircraftType": "A320" }, headers={"x-goog-api-key": API_KEY}, )Cách truy xuất một lưới bị giới hạn trong một nhóm nhỏ các cấp độ bay và một khu vực cụ thể bằng các lớp
contrailsvàexpected_effective_energy_forcing:response = requests.get( url="https://contrails.googleapis.com/v2/grids", params={"time": 2026-01-27T12:00:00Z, "bbox": [-10, 40, 10, 55], "flightLevel": [300,310,320,330], "data": ["contrails", "expected_effective_energy_forcing"] }, headers={"x-goog-api-key": API_KEY}, )