Hava Durumu API'si

Tahmin#

Parametreler

Yanıt

{
  "latitude": 48.85,
  "longitude": 2.35,
  "timezone": "Europe/Paris",
  "grid": {
    "latitude": 48.85, "longitude": 2.35,
    "distance_km": 0.42, "resolution_km": 1.3
  },
  "elevation": {
    "applied": true,
    "model_elevation_m": 91.0,
    "location_elevation_m": 113,
    "temperature_offset_c": -0.14
  },
  "source": {
    "model": "mf_arome",
    "model_run": "20260801T00Z",
    "reference_time": "2026-08-01T00:00:00+00:00",
    "data_age_hours": 3.95,
    "stale": false,
    "attribution": "Data: Météo-France (etalab-2.0)"
  },
  "hourly": {
    "time": ["2026-08-01T00:00:00+02:00", "..."],
    "temperature_2m": [18.1, 17.9, 17.6, "..."],
    "apparent_temperature": [17.4, "..."],
    "weather_code": [0, 1, 2, "..."]
  },
  "daily": {
    "date": ["2026-08-01", "..."],
    "temperature_2m_max": [26.6, "..."],
    "temperature_2m_min": [16.2, "..."],
    "precipitation_sum": [0.0, "..."],
    "uv_index_max": [7.6, "..."],
    "sunrise": ["2026-08-01T06:24:00+02:00", "..."],
    "sunset": ["2026-08-01T21:24:00+02:00", "..."],
    "daylight_hours": [15.0, "..."]
  }
}

Yükü küçültmek

15 gün için tam saatlik blok yaklaşık 32 alan × 360 saattir. Bunlardan üçünü çiziyorsanız üçünü isteyin:

GET /v1/forecast?lat=48.85&lon=2.35&days=3
    &hourly=temperature_2m,precipitation,weather_code
    &include_daily=false

Fiyat aynı — maliyet arşivi okumakta, seri hâle getirmekte değil — ama bayt sayısı onda bir ve telefonda ayrıştırması gözle görülür biçimde daha hızlı.

Şehre göre tahmin#

Yapabildiğiniz yerde bunu ham koordinatlara tercih edin. Katalog, bir koordinatın sağlayamayacağı iki şeyi sağlar: şehrin gerçek rakımı, böylece arazi düzeltmesi siz vermeden uygulanır; ve saat dilimi, böylece günlük toplulaştırmalar doğru yerel günde kesilir.

GET /v1/forecast/city/dz/alger      # Fransızca slug
GET /v1/forecast/city/dz/algiers    # İngilizce slug — aynı şehir
GET /v1/forecast/city/fr/paris

country, küçük harfli bir ISO-3166-1 alpha-2 kodudur. slug aksana duyarsızdır: bejaia, Béjaïa'yı bulur. Bilinmeyen bir slug, bir suggestions dizisiyle birlikte 404 city_not_found döndürür — çıkmaz sokak yerine onu gösterin.

/v1/forecast'ın bütün sorgu parametreleri, kataloğun sağladığı lat, lon ve elevation dışında geçerli olmayı sürdürür. timezone geçmek şehrin kendi dilimini geçersiz kılar ki bu neredeyse hiçbir zaman istediğiniz şey değildir.

Anlık koşullar#

Sıcaklık, nem, rüzgâr ve basınç, o anı kuşatan iki model adımı arasında doğrusal olarak şu ana iç değerlenir.

Bunu "şu anda" görünümü için kullanın. Zaman içinde karşılaştıracağınız her şey için /v1/forecast'ı kullanıp istediğiniz saati okuyun: seri kararlıdır, oysa şu an iki çağrı arasında ayağınızın altından kayar.

Alan referansı#

Saatlik alanlar

Bunların 21'i varsayılan olarak döner. Geri kalanı istemenizle sizindir — hourly= içinde virgülle ayırarak adlandırın — ve şüpheden değil, maliyetten ötürü geri tutulurlar: saklanan her alan ayrı bir sıkıştırılmış okumadır; 45'ini birden taşıyan bir varsayılan yanıt, kar kalınlığını isteyen azınlığın maliyetini herkese ödetirdi.

GET /v1/forecast?lat=45.19&lon=5.72&hourly=temperature_2m,snow_line_altitude,soil_temperature_8cm

Bir modelin yayımlamadığı alan, yanıttan kaybolmak yerine o modelin kapsadığı tahmin diliminde null olarak döner — yani AROME ile başlayıp ICON-EU ile süren bir zincir baştan sona visibility döndürür, ilk 51 saatte boş olarak. Bilinmeyen bir alan adı ise en yakın eşleşme önerisiyle birlikte 400 unknown_field'dır; eskiden sessizce yok sayılırdı.

Günlük alanlar

date, temperature_2m_max, temperature_2m_min, temperature_2m_mean, precipitation_sum, wind_speed_max, wind_gust_max, shortwave_radiation_sum (MJ/m²), uv_index_max, sunrise, sunset, daylight_hours, weather_code.

UTC'ye göre değil, yerel takvim günlerine göre toplulaştırılır. Aralığın iki ucundaki eksik gün, yanıltıcı bir maksimumla raporlanmak yerine atlanır — yani 7 günlük bir istek haklı olarak 6 günlük satır döndürebilir.

Modeller ve çözünürlük#

Hem noktanızı hem de vadenizi kapsayan en ince modeli sunarız. Modeli asla siz seçmezsiniz; seçim source.model içinde bildirilir, böylece hangisinin yanıtladığını her zaman anlarsınız.

Yüksek çözünürlüklü modellerin hepsi kısa vadelidir — 1 km'de atmosfer iki gün içinde kaotikleşir, dolayısıyla daha ileriye tahmin anlamsız olurdu — ve bu yüzden tahmin ilerledikçe çözünürlük kademe kademe düşer:

gün 0 ─────── gün 2 ─────── gün 5 ───────────────── gün 15
  AROME 1,3 km (Fransa)
  ICON-D2 2,2 km (Almanya, Alpler, Benelüks)
  HRRR 3 km (ABD ve Kanada'nın güneyi)
              ICON-EU 6,5 km (Avrupa)
                          ICON 13 km · ECMWF 28 km (küresel)
                                              AIFS (yalnızca eğilim)

Bir modelin alan sınırındaki geçişler çapraz olarak yumuşatılır; böylece sınırın iki yanındaki iki kasaba asla basamaklı bir farkla ayrışmaz.

/v1/models anahtar gerektirmez; bu da onu bir durum sayfasından yoklamak ya da satın almadan önce kontrol etmek için doğru araç yapar: her modelin en son koşusunu ve yaşını bildirir, yani "veri taze mi" sorusu kredi harcamadan yanıtlanabilir.

Topluluk olasılıkları#

Tek bir tahmin perşembe 22 °C der. Bu, gerçekmiş gibi sunulan bir tahmindir. Bu uç nokta, aslında üzerine karar verdiğiniz soruyu yanıtlar: ne kadar emin ve planlamaya değer yağmur olasılığı ne.

ECMWF topluluğundan hesaplanır — aynı modelin biraz farklı başlangıç koşullarından 50 kez çalıştırılmış hâli. Koşuların uyuştuğu yerde tahmin kendinden emindir. Dağıldıkları yerde belirsiz olan atmosferin kendisidir ve ne kadar iyi olursa olsun hiçbir model size daha fazlasını söyleyemez.

{
  "members": 50,
  "hourly": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "temperature_2m_p10": [26.4],
    "temperature_2m_p50": [26.78],
    "temperature_2m_p90": [27.3],
    "temperature_2m_spread": [0.4],
    "precipitation_probability_0_1mm": [10.0],
    "precipitation_probability_1_0mm": [0.0],
    "precipitation_probability_5_0mm": [0.0],
    "precipitation_probability_10_0mm": [0.0],
    "precipitation_p90": [0.1]
  }
}

Nasıl okunur

p10 ve p90, üyelerin ortadaki %80'ini kuşatır: onda biri p10'dan soğuk, onda biri p90'dan sıcak bekler. 0,4 °C'lik bir spread, güvenebileceğiniz oturmuş bir durumdur; 3 °C ise modellerin anlaşamadığı anlamına gelir ve birini seçmek yerine bunu kullanıcılarınıza söylemelisiniz.

Yağmur eşikleri yuvarlak sayılar değil, kararlardır — 0,1 mm hiç olmazsa ıslak, 1 mm mont al, 5 ve 10 mm bu bir sorun demektir. precipitation_p90 kötü durumdur: üyelerin yalnızca onda biri bundan daha yağışlıdır.

Hava kalitesi#

Bu, Kuzey Afrika ve Akdeniz genelinde en çok önem taşıyan uç noktadır. Bir toz olayı PM10'u günlerce metreküpte binlerce mikrogramın üzerine taşır ki bu bir sayıdan çok bir sağlık kararıdır ve ücretsiz tüketici servislerinde kötü kapsanır.

{
  "current": {
    "pm2_5": 38.7,
    "band": "poor",
    "who_guidelines_ug_m3": {"pm2_5": 15.0, "pm10": 45.0,
                             "nitrogen_dioxide": 25.0, "ozone": 100.0}
  },
  "hourly": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "pm2_5": [38.7], "pm10": [85.8], "ozone": [43.4],
    "nitrogen_dioxide": [19.0], "dust_aod_550nm": [0.24]
  },
  "units": {"pm2_5": "ug/m3", "pm10": "ug/m3", "dust_aod_550nm": "1"}
}

Bütün derişimler, hava kalitesinin her yerde bildirildiği birim olan µg/m³ cinsindendir. dust_aod_550nm bir optik derinliktir ve birimi yoktur: yaklaşık 0,5'in üstünde gökyüzü gözle görülür biçimde puslu, 1,0'in üstünde güneş sönüktür.

DSÖ'nün kısa vadeli kılavuz değerleri her yanıtta birlikte gelir; böylece bir sayı, arayıp bulmaya gerek kalmadan yerine oturtulabilir. band, PM2,5 için Avrupa hava kalitesi indeksini izler: iyi, makul, orta, kötü, çok kötü, aşırı kötü.

Kar ve kar sınırı#

Dört alan ve farklı soruları yanıtlıyorlar. snowfall ne kadar düştüğüdür; geri kalanı yerde ne olduğunu ve nerede olduğunu betimler.

Onları adıyla isteyin — varsayılan yanıtta yoklar:

GET /v1/forecast?lat=45.19&lon=5.72&hourly=snowfall,snow_depth,snow_water_equivalent,snow_line_altitude,freezing_level_altitude

Okunmaya değer olan kar sınırıdır. "800 m'de yağmur, 1200 m'de kar yağıyor" bir kayak merkezinin, bir karayolu idaresinin ya da bir sürücünün üzerine hareket edebileceği bir bilgidir; "3 mm yağış" değildir. Kuzey Afrika'da da önemlidir — Atlas'ta Chréa ve Tikjda'da kayak alanları vardır ve Sétif, Batna ile Djelfa'daki yüksek platolar 1000 m'nin üstündedir.

Bunlar dünyayı 13 km'de kapsayan DWD'nin ICON'undan gelir. ECMWF'in açık verisi kar kalınlığını yayımlar ama kar sınırını yayımlamaz; yani burası daha kaba modelin daha yararlı olduğu yerlerden biridir. snow_line_altitude bölgesel bir üründür: ICON-EU ve ICON-D2 bunu yayımlar, küresel ICON yayımlamaz; dolayısıyla Avrupa dışında donma seviyesini ve kalınlığı alırsınız ama sınırın kendisini almazsınız.

Deniz — deniz durumu#

{
  "hourly": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "wave_height": [0.32],
    "wave_direction": [264.3],
    "wave_period": [3.79],
    "wave_peak_period": [4.21]
  }
}

Dalga yüksekliği, belirgin dalga yüksekliğidir — en yüksek üçte birlik dalgaların ortalaması; yani denizdeki bir gözlemcinin bildirdiğine kabaca denk düşen değer. Tek tek dalgalar bunun yaklaşık iki katına ulaşır ve denize çıkıp çıkmamaya karar veriyorsanız asıl önemli sayı odur. Yön, rüzgâr yönü gibi, dalgaların geldiği yöndür.

Nehirler#

Hiçbir hava modelinin yapamayacağını yanıtlar: yukarı havzaya ne kadar yağmur düştüğünü değil, buraya ne kadar su geldiğini — yağmurdan bir havza, bir toprak nem durumu ve bir iki günlük akış süresiyle ayrılmış, farklı bir sayı.

{
  "disclaimer": "Information only. Only national and regional authorities
                 are authorised to issue flood warnings.",
  "daily": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "river_discharge": [4.953],
    "soil_wetness_index": [0.448]
  }
}