Mengambil petak perkiraan cuaca

GET https://contrails.googleapis.com/v2/grids: Mendapatkan petak perkiraan jejak pesawat.

Jika berhasil, responsnya akan berupa NetCDF nilai paksaan jejak pesawat.

Parameter kueri

Parameter
time	string Wajib. Waktu permintaan. Format: String tanggal dan waktu ISO 8601 ATAU bilangan bulat epoch Unix Contoh: 2026-01-20T21:00:00Z
bbox[]	number Opsional. Batas wilayah yang akan ditampilkan. Format: [lng_min, lat_min, lng_max, lat_max] Contoh: [-40, 20, 20, 60]
aircraftType	string Opsional. Kode pesawat. Format: Kode jenis pesawat ICAO 4 karakter Contoh: A320
flightLevel[]	integer Opsional. Tingkat penerbangan yang akan ditampilkan. Jika tidak ada tingkat penerbangan yang ditentukan, semua tingkat penerbangan akan disertakan. Format: Level penerbangan dalam hectofeet; [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440] Contoh: [270, 280, 290, 300]
format	string Opsional. Format yang diminta. Meneruskan nilai selain 'netcdf4' akan memunculkan error UNIMPLEMENTED karena poligon tidak didukung.
aircraftClass	string Opsional. Kelas pesawat. Saat ini, hanya default yang didukung.
data[]	string Opsional. Kolom ini menentukan variabel data mana yang akan disertakan dalam respons. Dapat menangani satu atau beberapa variabel data. Jika kolom ini kosong atau tidak diberikan, nilai defaultnya adalah ["contrails"]. Contoh: ["contrails", "expected_effective_energy_forcing"]

Contoh

• Untuk mengambil petak jejak pesawat global default untuk titik waktu tertentu:

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

  Saat dimuat dengan xarray, permintaan ini akan menampilkan set data berikut:

  Dimensi: (bujur: 1441, lintang: 721, tingkat_penerbangan: 18, waktu: 1)
  Koordinat
  Nama	Dimensi	Jenis Data	Nilai
  longitude	(longitude)	float32	-180,0 -179,8 ... 179,8 1...
  latitude	(lintang)	float32	-90,0 -89,75 -89,5 ... 8...
  flight_level	(flight_level)	int16	270 280 290 300 ... 41...
  time	(waktu)	datetime64[ns]	2026-01-28T20:00:00
  forecast_reference_time	(waktu)	datetime64[ns]	2026-01-27T08:00:00
  Variabel data
  jejak pesawat	(longitude, latitude, flight_level, time)	float32	0.0 0.0 0.0 0.0 ... 0.0 ...
  Atribut
  inference_pipeli...		contrails.forecast-pipeline_20260115.02_p0
  api_version :		contrails.api-service_20260125.00_p0
  aircraft_class :		default

• Untuk mengambil petak yang dibatasi pada batas geografis tertentu dan difilter untuk jenis pesawat tertentu, dengan waktu yang ditentukan sebagai bilangan bulat epoch 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},
  )
  

• Untuk mengambil petak yang dibatasi ke subset tingkat penerbangan dan wilayah tertentu dengan lapisan contrails dan 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},
  )