Tahmin ızgarası alma

GET https://contrails.googleapis.com/v2/grids: Uçak izi tahminlerinin ızgarasını alın.

Başarılı olursa yanıt, yoğuşma izi zorlama değerlerinin NetCDF'si olur.

Sorgu parametreleri

Parametreler
time

string

Zorunlu. İsteğin zamanı.

Biçim: ISO 8601 tarih/saat dizesi VEYA Unix dönemi tam sayısı

Örnek: 2026-01-20T21:00:00Z
bbox[]

number

İsteğe bağlı. Döndürülecek bölgenin sınırları.

Biçim: [lng_min, lat_min, lng_max, lat_max]

Örnek: [-40, 20, 20, 60]
aircraftType

string

İsteğe bağlı. Uçak kodu.

Biçim: 4 karakterli ICAO uçak türü kodu

Örnek: A320
flightLevel[]

integer

İsteğe bağlı. Döndürülecek uçuş seviyeleri. Uçuş seviyesi belirtilmemişse tüm uçuş seviyeleri dahil edilir.

Biçim: Hektofeet cinsinden uçuş seviyeleri; [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440]

Örnek: [270, 280, 290, 300]
format

string

İsteğe bağlı. İstenen biçim. Poligonlar desteklenmediğinden "netcdf4" dışında bir değer iletmek UNIMPLEMENTED hatasına neden olur.
aircraftClass

string

İsteğe bağlı. Uçak sınıfı. Şu anda yalnızca default desteklenmektedir.
data[]

string

İsteğe bağlı. Bu alan, yanıta hangi veri değişkenlerinin dahil edileceğini belirtir. Bir veya daha fazla veri değişkenini işleyebilir. Bu alan boşsa veya sağlanmamışsa varsayılan olarak ["contrails"] kullanılır.

Örnek: ["contrails", "expected_effective_energy_forcing"]

Örnekler

  • Belirli bir zamana ait varsayılan küresel uçak izi ızgarasını almak için:

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

    Bu istek, xarray ile yüklendiğinde aşağıdaki veri kümesini döndürür:

    Boyutlar: (longitude: 1441, latitude: 721, flight_level: 18, time: 1)
    Koordinatlar
    Ad Boyutlar Veri Türü Değerler
    longitude (boylam) float32 -180,0 -179,8 ... 179,8 1...
    latitude (enlem) float32 -90,0 -89,75 -89,5 ... 8...
    flight_level (flight_level) int16 270 280 290 300 ... 41...
    zaman (zaman) datetime64[ns] 2026-01-28T20:00:00
    forecast_reference_time (zaman) datetime64[ns] 2026-01-27T08:00:00
    Veri değişkenleri
    yoğunlaşma izleri (longitude, latitude, flight_level, time) float32 0.0 0.0 0.0 0.0 ... 0.0 ...
    Özellikler
    inference_pipeli... contrails.forecast-pipeline_20260115.02_p0
    api_version : contrails.api-service_20260125.00_p0
    aircraft_class : varsayılan

  • Belirli bir coğrafi sınırla sınırlı ve belirli bir uçak türüne göre filtrelenmiş bir ızgarayı almak için (zaman, Unix dönemi tam sayısı olarak belirtilir):

    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},
)

  • contrails ve expected_effective_energy_forcing katmanlarıyla, uçuş seviyelerinin bir alt kümesi ve belirli bir bölgeyle sınırlı bir ızgara almak için:

    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},
)