API Cuaca · 1,3 km sampai 28 km · 15 hari
Model terhalus yang menaungi titik Anda. Dipilih tiap permintaan.
Sebagian besar API cuaca menjalankan satu model global di mana-mana. Yang ini menyimpan 8 dan menentukan mana yang menjawab koordinat tertentu pada rentang waktu tertentu — sehingga sebuah desa di Pegunungan Alpen tidak menerima sel 28 km yang sama dengan Atlantik terbuka.
120 km pantai yang sama, seperti dilihat tiap model 28 km teluknya hilang 1.3 km pulaunya ada
Resolusi bukan detail lembar spesifikasi. Ia menentukan apakah sebuah teluk, lembah atau pulau ada di dalam model — dan sel yang merata-ratakan laut dan darat memberi Anda suhu yang bukan keduanya.
8 model, diselesaikan otomatis
Anda tidak pernah memilih model. Anda mengirim koordinat; API mengambil yang terhalus yang menaunginya, menggabungkan di tepi domain agar nilainya tidak melompat, dan memberi tahu di respons model mana yang menjawab.
| Model | Resolusi | Cakupan | Siklus | Jangkauan | Tersedia setelah |
|---|---|---|---|---|---|
| Météo-France AROME | 1.3 km | Prancis dan sekitarnya | 8 ×/hari | 51 h | 4 h |
| DWD ICON-D2 | 2.2 km | Eropa Tengah | 4 ×/hari | 48 h | 2 h |
| NOAA HRRR | 3 km | Amerika Serikat daratan | 4 ×/hari | 48 h | 1.5 h |
| DWD ICON-EU | 6.5 km | Eropa, Afrika Utara, Timur Dekat | 2 ×/hari | 120 h | 3 h |
| DWD ICON | 13 km | Dunia | 2 ×/hari | 180 h | 4 h |
| ECMWF IFS | 28 km | Dunia — selalu tersedia | 2 ×/hari | 240 h | 7 h |
| ECMWF AIFS | 28 km | Dunia, hari 11–15 | 2 ×/hari | 360 h | 7 h |
| ECMWF wave | 28 km | Hanya samudra dan laut | 2 ×/hari | 240 h | 7 h |
Tepi domain
Tidak ada jahitan di tempat sebuah model berhenti
Mengganti model secara mendadak di sebuah batas membuat dua kota bertetangga berbeda tanpa alasan fisis. Setiap domain membawa margin penggabungan: dekat tepi, bobot model halus meluruh dan sisanya beralih ke model berikutnya. Di dalam domain Anda mendapat model halus tanpa campuran.
Rentang waktu
Halus di awal, global kemudian
AROME berhenti di 51 jam dan HRRR di 48. Setelah itu penentu turun melalui ICON-EU dan ICON sampai ECMWF, dalam permintaan yang sama. Deret tujuh hari Anda dijahit dari model terbaik pada setiap langkah, dan responsnya mencatat campurannya.
Apa yang kembali
45 bidang per jam — 27 tersimpan, 18 dihitung saat itu juga. 21 kembali secara bawaan; sebutkan sisanya di hourly=, atau sebutkan lebih sedikit dan perkecil respons.
Suhu & kelembapan
temperature_2m, maksimum dan minimum harian, dewpoint_2m, kelembapan relatif, suhu terasa, indeks panas, dingin angin, suhu permukaan.
Angin
Komponen u/v pada 10 m dan 100 m untuk pasar energi angin, kecepatan, arah, arah mata angin, skala Beaufort, dan wind_gust_10m.
Presipitasi
Presipitasi total yang didekumulasi per selang, salju sebagai setara air, dan kode WMO precipitation_type yang memisahkan hujan, salju dan hujan beku.
Awan & jarak pandang
Tutupan total plus rendah, menengah dan tinggi secara terpisah — awan rendahlah yang membuat hari kelabu, sirus nyaris tak meredupkan matahari. Okta untuk penerbangan dan visibility untuk kabut.
Radiasi & matahari
Iradiansi gelombang pendek, dipisah menjadi langsung dan baur untuk hasil surya. Elevasi dan azimut matahari, penanda siang, terbit dan terbenam, serta indeks UV perkiraan.
Tekanan & ketakstabilan
Tekanan permukaan laut dan permukaan, kecenderungan tiga jam, cape untuk potensi konvektif, dan uap air total pada kolom.
Tanah
Suhu tanah di permukaan dan di zona akar 7–28 cm — lapisan yang penting bagi pertanian — dari ICON. soil_temperature_0cm dan soil_temperature_8cm.
Salju
Ketebalan, setara air, tinggi titik beku, dan snow_line_altitude — ketinggian di atasnya presipitasi turun sebagai salju, sebuah keputusan yang bisa ditindaklanjuti otoritas jalan.
Ringkasan
Satu weather_code WMO per langkah waktu, agar klien menggambar satu ikon alih-alih menulis ulang logika yang mengubah tujuh bidang menjadi „hujan ringan”.
Dua koreksi yang dilewati kebanyakan API
Ketinggian
Gunung milik model bukan gunung Anda
Model numerik menghaluskan relief ke kisinya. Desa di dasar lembah bisa berada 400 m di bawah ketinggian yang dikira model, dan suhu mentahnya keliru sebesar gradien suhu pada selisih itu.
Kirim elevation bersama permintaan Anda dan nilainya dikoreksi terhadap orografi model itu sendiri. Di daerah berbukit itu biasanya bernilai 1–3 °C. Responsnya melaporkan ketinggian model, ketinggian Anda dan pergeseran yang diterapkan — jadi Anda bisa memeriksanya, atau mengabaikannya.
Kesegaran
Usang lebih baik daripada tiada, dan ia mengatakannya
Jika siklus terbaru kami lebih tua dari yang diharapkan, Anda tetap mendapat data, dengan "stale": true dan data_age_hours di blok source. Prakiraan berumur delapan jam lebih berguna bagi pengguna Anda daripada galat 500.
Yang tidak pernah Anda dapatkan adalah angka usang yang tampak segar. Putuskan di kode Anda sendiri apakah menampilkannya, memperingatkan, atau beralih.
{
"grid": { "distance_km": 8.04, "resolution_km": 28.0 },
"elevation": {
"applied": true,
"model_elevation_m": 91.0,
"location_elevation_m": 113,
"temperature_offset_c": -0.14
},
"source": {
"model": "ecmwf_ifs",
"model_run": "20260725T00Z",
"data_age_hours": 8.95,
"stale": false,
"attribution": "Data: ECMWF (CC-BY-4.0)"
}
}Di kunci yang sama, bukan di tagihan berikutnya
Empat hal yang di tempat lain biasanya produk terpisah. Di sini semuanya titik akhir pada paket yang sudah Anda beli.
/v1/probability
Seberapa yakin prakiraannya?
Satu nilai berkata 22 °C pada Kamis — tebakan yang disajikan sebagai fakta. Ini mengembalikan p10, p50, p90 dan sebaran dari ansambel 50 anggota ECMWF, plus probabilitas hujan pada 0,1, 1, 5 dan 10 mm.
Sebaran 0,4 °C berarti keadaan mapan. Sebaran 3 °C berarti atmosfernya sendiri tidak pasti, dan pengguna Anda pantas diberi tahu.
/v1/air-quality
Partikulat, ozon, NO₂ — dan debu Sahara
Dari Copernicus CAMS, dengan nilai panduan WHO ikut di setiap respons sehingga sebuah angka bisa ditempatkan tanpa dicari dulu.
Debu penting di Afrika Utara dan Mediterania: satu episode mendorong PM10 melewati seribu µg/m³ selama berhari-hari, dan layanan konsumen gratis menutupinya dengan buruk.
/v1/marine
Keadaan laut di seluruh dunia
Tinggi gelombang signifikan, arah dan perioda dari model gelombang ECMWF, hingga sepuluh hari. Titik di darat mengembalikan 404 not_at_sea alih-alih satu kolom nilai kosong yang terbaca seperti kegagalan.
/v1/hydrology
Berapa banyak air yang tiba di sini
Debit sungai dari Copernicus GloFAS pada jaringan sungai 0,05° — bukan berapa banyak hujan yang turun di hulu, melainkan berapa banyak air yang mencapai titik ini, yang dipisahkan oleh sebuah daerah aliran dan sehari perjalanan.
Hanya informasi. Menerbitkan peringatan banjir adalah kewenangan otoritas nasional dan daerah.
Di mana ia bekerja
Produk cuaca
Halaman kota, aplikasi dan widget. Satu kode WMO per langkah untuk ikon, agregat harian yang dipotong di zona waktu pengguna, dan katalog kota dengan pencarian serta titik terdekat.
Energi
Angin 100 m untuk tinggi poros, iradiansi langsung dan baur untuk hasil PV, dan sebaran ansambel untuk sisi risiko sebuah posisi.
Pertanian
Suhu dan suhu tanah pada empat kedalaman, masukan evapotranspirasi, risiko embun beku dari suhu minimum, dan embusan untuk jendela penyemprotan.
Logistik & jalan
Batas salju, tinggi titik beku, jenis presipitasi dan jarak pandang — empat bidang yang menentukan apakah sebuah jalur pegunungan ditutup.
Maritim & luar ruang
Tinggi, perioda dan arah gelombang, embusan angin, indeks UV dan lama siang untuk perencanaan yang harus dilakukan seminggu sebelumnya.
Penjual kembali
Anda boleh menyebarkan ulang. Bangun produk di atasnya dan jual, dengan satu baris atribusi di footer sebagai satu-satunya kewajiban yang mengikuti Anda.
Apa yang dikerjakannya dengan buruk
Kami lebih suka Anda tahu batasnya sekarang daripada menemukannya di produksi.
Kuat
Suhu, tekanan, angin sinoptik, kelembapan, penyinaran matahari. Galat khas suhu 2 m pada 24 jam sekitar 1–1,5 °C. ECMWF adalah model deterministik global terbaik di dunia, dan itulah yang Anda dapatkan.
Lemah
Badai konvektif — sel 28 km tidak bisa mengurai badai petir, dan bahkan 3 km hanya mengisyaratkannya. Posisi dan waktu persis hujan lokal. Iklim mikro pesisir dan pegunungan di bawah resolusi model. Angin laut dan kantong udara dingin di lembah, yang tidak dimodelkan koreksi ketinggian.
Jujur secara geografis
Di Prancis, Jerman, Amerika Serikat dan Kanada kami menyajikan model nasional 1,3–3 km dan sebuah desa kecil benar-benar mendapat selnya sendiri. Wilayah seberang laut, Alaska, Hawaii, dan Kanada utara berada di luar domain tersebut dan turun ke 13 km. Di Eropa lainnya Anda mendapat 6,5 km. Di Afrika, Timur Tengah dan sebagian besar Asia, model publik terbaik yang tersedia adalah 13–28 km: Anda mendapat cuaca wilayah, bukan cuaca jalan. Koreksi ketinggian mempersempit jurang itu; ia tidak menutupnya.
Bukan layanan peringatan
Tanpa peringatan, tanpa warna tingkat bahaya, tanpa instruksi bertindak. Itu milik otoritas, yang juga bisa menutup jalan dan mengevakuasi sebuah desa.
Pertanyaan umum
Model mana yang akan melayani lokasi saya?
Yang terhalus yang menaunginya: AROME 1,3 km di Prancis, ICON-D2 2,2 km di Eropa Tengah, HRRR 3 km di Amerika Serikat, ICON-EU 6,5 km di Eropa dan Afrika Utara, ICON 13 km di seluruh dunia, dan ECMWF IFS 28 km sebagai dasar yang selalu tersedia.
Panggil /v1/models untuk melihat daftar terkini dan domain tiap model, atau baca source.model di respons mana pun.
Seberapa sering diperbarui?
Model global dua kali sehari pada 00 dan 12 UTC; model nasional resolusi tinggi empat kali sehari pada 00, 06, 12 dan 18 UTC. Data mulai bisa dipakai antara 90 menit dan 7 jam setelah waktu siklus tergantung penyedianya — tabel di atas menyebut satu per satu.
Respons prakiraan disinggahkan lima menit di tepi, yang menyerap lalu lintas berulang halaman kota tanpa pernah menyajikan siklus yang lebih lama dari yang kami pegang.
Bisakah saya meminta banyak lokasi sekaligus?
Satu koordinat per permintaan. Penyimpanan dipotong sedemikian rupa sehingga seluruh deret waktu sebuah area kecil berada dalam satu potongan — satu titik sepanjang semua langkah adalah kueri yang murah, dan itulah kueri yang hampir setiap produk benar-benar lakukan.
Untuk lalu lintas berbentuk kota, /v1/forecast/city/{country}/{slug} membawa zona waktu dan ketinggian kota, sehingga Anda tidak perlu.
Apakah ada unduhan massal?
Tidak, di paket mana pun. Arsip itulah yang Anda bayar, dan ekspor tanpa batas adalah cara pesaing memperolehnya dalam satu sore. Ekspor CSV derajat-hari ada dan sengaja dibatasi.
Berapa biayanya?
Gratis untuk 10.000 kredit per bulan tanpa kartu. 19 € per bulan untuk 50.000 kredit termasuk API Derajat-hari, riwayat dan CSV. 79 € untuk 400.000 kredit dan semua sisanya. Satu permintaan prakiraan bernilai satu kredit.
Cobalah pada koordinat Anda sendiri
Tingkat gratis mengembalikan data yang sama dengan tingkat berbayar. Arahkan ke tempat yang Anda kenal baik dan nilai sendiri angkanya.