Endpoint API Cuaca

GET https://api.data.gov.my/weather/forecast
GET https://api.data.gov.my/weather/warning
GET https://api.data.gov.my/weather/warning/earthquake

Sumber Data Cuaca

API Cuaca menyediakan maklumat cuaca secara pada masa nyata, termasuk ramalan umum 7 hari dan amaran cuaca secara langsung. Amaran gempa bumi juga disediakan dalam 'endpoint' yang berlainan kerana format ia yang unik. Data-data ini disediakan oleh MET Malaysia (Jabatan Meteorologi Malaysia). Untuk maklumat cuaca yang lebih komprehensif dan untuk mengakses sumber tambahan, anda boleh mengunjungi Portal Rasmi MET Malaysia (opens in a new tab).

Catatan: Data ramalan laut masih tidak tersedia pada masa ini.

Kekerapan Kemaskini Data

• Data ramalan umum 7 hari dikemaskini setiap hari.
• Data amaran (termasuk data gempa bumi) dikemaskini apabila diperlukan.

Format Permintaan & Respons

Untuk menyaring dan meminta data, gunakan operasi penyaringan standard dalam Permintaan Pertanyaan. Untuk maklumat tentang bagaimana API ini memberi respons kepada permintaan anda, rujuk bahagian Format Respons.

Ramalan Umum 7 Hari

GET https://api.data.gov.my/weather/forecast

Contoh Permintaan

Untuk mendapatkan data dari API Cuaca, gunakan perintah curl berikut. Buka terminal anda dan masukkan perintah ini:

curl --location 'https://api.data.gov.my/weather/forecast?limit=3'

Permintaan Bidang-Bidang Bersarang

    {
        // gunakan 'double underscore'
        "location": {
            "location_id": "Ds001", // location__location_id
            "location_name": "Langkawi" // location__location_name
        },
        "date": "1957-08-31",
        "morning_forecast": "Hujan di satu dua tempat",
        "afternoon_forecast": "Ribut petir di satu dua tempat",
        "night_forecast": "Tiada hujan",
        "summary_forecast": "Ribut petir di satu dua tempat",
        "summary_when": "Petang",
        "min_temp": 26,
        "max_temp": 32
    },

Data respons mempunyai struktur seperti di atas. Anda boleh mengakses bidang-bidang bersarang dengan menggunakan 'double underscore'. Sebagai contoh, untuk menyaring data ramalan di Langkawi, anda boleh menggunakan parameter pertanyaan ?contains=Langkawi@location__location_name.

Penyaringan Mengikut Kategori Lokasi

GET https://api.data.gov.my/weather/forecast?contains=<prefix>@location__location_id

location_id berada dalam format "AA000," di mana abjad awalan mewakili jenis lokasi. Terdapat lima jenis kategori lokasi yang boleh digunakan:

• St untuk Negeri
• Rc untuk Pusat Rekreasi
• Ds untuk Daerah
• Tn untuk Bandar
• Dv untuk Bahagian

Untuk menyaring data ramalan untuk kategori lokasi tertentu, parameter pertanyaan contains boleh digunakan. Sebagai contoh, untuk mendapatkan data ramalan lokasi Negeri sahaja, gunakan ?contains=St@location__location_id.

Fahami Nilai Bidang-Bidang

Nilai-nilai yang sah bagi Bidang *_forecast

Nilai-nilai sah untuk morning_forecast, afternoon_forecast, night_forecast, dan summary_forecast:

• Berjerebu
• Tiada hujan
• Hujan
• Hujan di beberapa tempat
• Hujan di satu dua tempat
• Hujan di satu dua tempat di kawasan pantai
• Hujan di satu dua tempat di kawasan pedalaman
• Ribut petir
• Ribut petir di beberapa tempat
• Ribut petir di beberapa tempat di kawasan pedalaman
• Ribut petir di satu dua tempat
• Ribut petir di satu dua tempat di kawasan pantai
• Ribut petir di satu dua tempat di kawasan pedalaman

Nilai-nilai sah untuk Bidang summary_when

• Pagi
• Malam
• Petang
• Pagi dan Petang
• Pagi dan Malam
• Petang dan Malam
• Sepanjang Hari

Nota: Nilai-nilai sah ini hanya tersedia dalam Bahasa Melayu.

Ramalan Amaran

GET https://api.data.gov.my/weather/warning

Contoh Permintaan

Untuk mendapatkan data dari API Cuaca, gunakan perintah curl berikut. Buka terminal anda dan masukkan perintah ini:

curl --location 'https://api.data.gov.my/weather/warning?limit=3'

Permintaan Bidang-Bidang Bersarang

    {
        // gunakan 'double underscore'
        "warning_issue": {
            "issued": "1957-08-31T00:00:00", // warning_issue__issued
            "title_bm": "", // warning_issue__title_bm
            "title_en": "" // warning_issue__title_en
        },
        "valid_from": "1957-08-31T00:00:00",
        "valid_to": "2023-08-31T00:00:00",
        "heading_en": "",
        "text_en": "",
        "instruction_en": "",
        "heading_bm": "",
        "text_bm": "",
        "instruction_bm": ""
    },

Data respons mempunyai struktur seperti di atas. Anda boleh mengakses bidang-bidang bersarang menggunakan 'double underscore'. Sebagai contoh, untuk menyaring amaran yang dikeluarkan bermula dari 1957-08-31 ke atas, anda boleh menggunakan parameter permintaan ?timestamp_start=1957-08-31 00:00:00@warning_issue__issued.

Fahami Nilai Bidang-Bidang

Amaran Gempa Bumi

GET https://api.data.gov.my/weather/warning/earthquake

Data gempa bumi disediakan dalam 'endpoint' yang tersendiri yang asing daripada endpoint weather/warning disebabkan format ia yang unik.

Contoh Permintaan

Untuk mendapatkan data dari API Cuaca, gunakan perintah curl berikut. Buka terminal anda dan masukkan perintah ini:

curl --location 'https://api.data.gov.my/weather/warning/earthquake?limit=3'

Fahami Nilai Bidang-Bidang