Truy xuất lưới dự báo

GET https://contrails.googleapis.com/v2/grids: Nhận lưới dự báo vệt mây.

Nếu thành công, phản hồi sẽ là một NetCDF của các giá trị ép buộc vệt mây.

Tham số truy vấn

Tham số
time

string

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 kỷ nguyên Unix

Ví dụ: 2026-01-20T21:00:00Z
bbox[]

number

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ụ: [-40, 20, 20, 60]
aircraftType

string

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ụ: A320
flightLevel[]

integer

Không bắt buộc. Cấp độ bay cần trả về. Nếu không chỉ định cấp độ bay, thì tất cả các cấp độ bay sẽ được đưa vào.

Định dạng: Cấp độ 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ụ: [270, 280, 290, 300]
format

string

Không bắt buộc. Định dạng được yêu cầu. Việc truyền một giá trị khác với "netcdf4" sẽ gây ra lỗi UNIMPLEMENTED (CHƯA TRIỂN KHAI) vì hệ thống không hỗ trợ đa giác.
aircraftClass

string

Không bắt buộc. Loại máy bay. Hiện tại, hệ thống chỉ hỗ trợ default.
data[]

string

Không bắt buộc. Trường này chỉ định các biến dữ liệu cần đưa vào phản hồi. Trường này 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ì trường này sẽ mặc định là ["contrails"].

Ví dụ: ["contrails", "expected_effective_energy_forcing", "persistent_formation_probability", "nominal_cocip_effective_energy_forcing"]

Ví dụ

  • Cách truy xuất lưới vệt mây toàn cầu mặc định 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: (longitude: 1441, latitude: 721, flight_level: 18, time: 1)
    Tọa độ
    Tên Kích thước Loại dữ liệu Giá trị
    longitude (longitude) float32 -180.0 -179.8 ... 179.8 1...
    latitude (latitude) float32 -90.0 -89.75 -89.5 ... 8...
    flight_level (flight_level) int16 270 280 290 300 ... 41...
    time (time) datetime64[ns] 2026-01-28T20:00:00
    forecast_reference_time (time) datetime64[ns] 2026-01-27T08:00:00
    Biến dữ liệu
    contrails (longitude, latitude, flight_level, time) 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 : default

  • Cách truy xuất một lưới bị giới hạn ở một ranh giới địa lý cụ thể và được lọc cho một loại máy bay cụ thể, với thời gian được chỉ định là một số nguyên 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 ở một tập hợp con của các cấp độ bay và một vùng cụ thể có các lớp contrails và 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},
)

  • Nếu bạn muốn truy xuất một lưới có các biến dữ liệu contrails, persistent_formation_probability và nominal_cocip_effective_energy_forcing:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/grids",
  params={"time": 2026-01-27T12:00:00Z,
          "data": ["contrails", "persistent_formation_probability", "nominal_cocip_effective_energy_forcing"]
          },
  headers={"x-goog-api-key": API_KEY},
)