Tahmin bölgelerini alma

GET https://contrails.googleapis.com/v2/regions: GeoJSON çokgen biçiminde uçak izi önleme bölgelerini alın.

Başarılı olursa yanıt, GeoJSON biçiminde bir FeatureCollection olur.

Poligon biçiminde döndürülen yoğunlaşma izi önleme bölgeleri, her uçuş seviyesi için 1 ile 4 arasında değişen şiddet düzeylerine göre derecelendirilir. Değer ne kadar yüksekse yoğunlaşma izi o kadar belirgindir.

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
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]
threshold

integer

İsteğe bağlı. Minimum önem düzeyi eşiği. Bu alan ayarlandığında yalnızca eşiğe eşit veya eşikten daha yüksek önem derecesine sahip bölgeler döndürülür.

Biçim: Geçerli değerler 1 ile 4 (bu değerler dahil) arasındadır.
aircraftClass

string

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

Örnekler

  • Belirli bir zamandaki tüm uçak izi önleme bölgelerini almak için:

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

    GeoJSON yanıtında, tüm uçak izi önleme bölgeleri poligon biçiminde listelenir:

    geometri flight_level eşik zamanı forecast_reference_time aircraft_class
    0 MULTIPOLYGON Z (((166.25 81.12 8229.6, 168.37 ... 270 1 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 varsayılan
    1 MULTIPOLYGON Z (((92.38 45.5 8229.6, 93 46.62 ... 270 2 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 varsayılan
    2 MULTIPOLYGON Z (((83.38 65 8229.6, 84 66.12 82... 270 3 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 varsayılan
    3 MULTIPOLYGON Z (((57.38 76 8229.6, 57.75 76.88... 270 4 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 varsayılan
    4 MULTIPOLYGON Z (((162.38 79 8534.4, 162.75 79.... 280 1 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 varsayılan

  • Belirli uçuş seviyeleriyle sınırlı, yoğuşma izi önleme bölgelerini almak için zamanı Unix dönemi tam sayısı olarak belirtin:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={
    "time": 1768942800,
    "flightLevel": [300,310,320,330]
  },
  headers={"x-goog-api-key": API_KEY},
)

  • Belirli uçuş seviyeleriyle sınırlı ve 3 şiddet seviyesi eşiğine eşit veya üzerinde olan yoğunlaşma izi önleme bölgelerini almak için:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/regions",
  params={
    "time": 2026-01-27T12:00:00Z,
    "flightLevel": [300,310,320,330],
    "threshold": 3
  },
  headers={"x-goog-api-key": API_KEY},
)