Mendapatkan peringatan cuaca

Endpoint publicAlerts memberikan detail untuk notifikasi peristiwa cuaca tertentu yang dikeluarkan oleh lembaga nasional dan internasional yang berwenang. Peringatan ini memberikan informasi penting yang berpotensi menyelamatkan nyawa.

Endpoint ini menampilkan peringatan cuaca yang terjadi secara real time untuk lintang dan bujur tertentu. Peristiwa cuaca yang didukung meliputi:

• Presipitasi: Hujan, salju, hujan es, kekeringan, dan lainnya
• Suhu ekstrem: Dingin, panas, beku, embun beku, angin dingin, dan kelembapan
• Peristiwa angin dan badai: Badai salju, angin topan, tornado, badai tropis, badai petir, dan lainnya
• Gangguan visibilitas: Kabut, badai debu, dan embusan salju
• Bahaya terkait air: Banjir, tsunami, gelombang badai, bahaya pesisir, dan lainnya
• Peristiwa geofisika dan geologi: Gempa bumi, tanah longsor, dan aktivitas vulkanik
• Insiden kebakaran: Kebakaran hutan, cuaca kebakaran, dan lainnya

Untuk mengetahui daftar lengkap peristiwa cuaca yang didukung, lihat Jenis peristiwa cuaca.

Perhatian: Peringatan cuaca bisa rumit dan mungkin tidak selalu mematuhi standar, format, atau aturan yang konsisten di berbagai sumber. Meskipun Google berupaya memastikan konsistensi data dan ketersediaan tepat waktu, konten, kualitas, dan frekuensi pembaruan tunduk pada sumber resmi dan dapat berubah setiap kali pembaruan dikeluarkan dari sumber tersebut; Google tidak menjamin bahwa peringatan cuaca akan diperbarui atau bahwa masalah apa pun yang terkait dengan data di penyedia akan diselesaikan dalam jangka waktu tertentu.

Notifikasi mungkin berisi atau tidak berisi deskripsi yang dilokalkan, bergantung pada apa yang tersedia dari sumber data. Karena batasan sumber data, informasi ditayangkan apa adanya (konten mentah). Untuk mengetahui informasi selengkapnya tentang sumber notifikasi cuaca, lihat Sumber data.

API menampilkan informasi berikut untuk peringatan cuaca tertentu:

• Jenis peristiwa cuaca yang terkait dengan peringatan
• Daftar area yang terpengaruh beserta koordinat yang menentukan batas geografis area tersebut
• Ringkasan satu kalimat tentang peristiwa cuaca
• Tingkat keparahan, kepastian, dan urgensi
• Deskripsi petunjuk rekomendasi tindakan untuk target audiens
• Rekomendasi keamanan
• Waktu mulai dan berakhir untuk notifikasi
• Nama dan situs otoritas penerbit

APIs Explorer memungkinkan Anda membuat permintaan langsung sehingga Anda dapat memahami API dan opsi API:

Cobalah!

Tentang permintaan peringatan cuaca

Untuk meminta informasi peringatan cuaca, kirim permintaan HTTP GET ke:

https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE

Sertakan koordinat lintang dan bujur lokasi dalam parameter URL permintaan Anda.

Catatan: Menyertakan parameter kode bahasa bersifat opsional dan hanya akan menerjemahkan judul pemberitahuan. Karena data peringatan cuaca disajikan apa adanya (konten mentah) dari lembaga partner, petunjuk dan rekomendasi keselamatan ditampilkan dalam bahasa asli yang dipublikasikan oleh lembaga tersebut. Untuk mengetahui informasi selengkapnya, lihat Perilaku terjemahan respons.

Tentang respons peringatan cuaca

Weather API menampilkan kolom berikut dalam isi respons:

Kolom	Jenis	Deskripsi	Wajib diisi atau opsional
alertId	String	ID pemberitahuan. Informasi ini juga dapat ditemukan di situs penyedia data.	Wajib
alertTitle	String	Judul pemberitahuan, yang menjelaskan peristiwa cuaca. Catatan: Ini adalah satu-satunya string yang diterjemahkan saat parameter kode bahasa disertakan dalam permintaan.	Wajib
eventType	Enum	Jenis peristiwa cuaca yang terkait dengan notifikasi. Untuk mengetahui daftar lengkap peristiwa cuaca yang didukung, lihat Jenis peristiwa cuaca.	Wajib
areaName	String	Nama area geografis yang terpengaruh oleh pemberitahuan, yang mencakup lokasi yang diminta.	Wajib
polygon	String	Koordinat yang menentukan area dimensi tertutup dari pemberitahuan.	Opsional
description	String	Frasa singkat yang merangkum deskripsi peristiwa dalam bahasa yang ditentukan (misalnya, "Peringatan tornado").	Opsional
severity	Enum	Tingkat keparahan untuk pemberitahuan: Ekstrem: Ancaman luar biasa terhadap nyawa atau properti Berat: Ancaman signifikan terhadap nyawa atau harta Sedang: Kemungkinan ancaman terhadap nyawa atau properti Ringan: Ancaman minimal hingga tidak ada ancaman yang diketahui terhadap nyawa atau properti Tidak diketahui: Tingkat keparahan tidak diketahui	Opsional
certainty	Enum	Tingkat kepastian untuk peringatan: Diamati: Ditentukan telah terjadi atau sedang berlangsung Sangat Mungkin: Sangat mungkin telah terjadi atau sedang berlangsung Kemungkinan: Kemungkinan (p > ~50%) telah terjadi atau sedang berlangsung Mungkin: Mungkin terjadi atau sedang terjadi, tetapi tidak mungkin (p <= ~50%) Tidak mungkin: Tidak diharapkan terjadi (p ~ 0) Tidak diketahui: Kepastian tidak diketahui	Opsional
urgency	Enum	Tingkat urgensi untuk pemberitahuan: Segera: Tindakan responsif HARUS segera dilakukan Diperkirakan: Tindakan responsif HARUS segera dilakukan (dalam satu jam ke depan) Mendatang: Tindakan responsif HARUS dilakukan dalam waktu dekat Sebelumnya: Tindakan responsif tidak lagi diperlukan Tidak diketahui: Tingkat urgensi tidak diketahui	Opsional
instruction	String	Deskripsi petunjuk tindakan responsif untuk target audiens.	Opsional
safetyRecommendations	String	Rekomendasi keselamatan berdasarkan kode otoritas publik. Mencakup arahan tingkat atas dan subteks dengan informasi tambahan.	Opsional
timezoneOffset	String	Selisih zona waktu acara, dalam format +/-HH:MM.	Wajib
startTime	Tanggal dan Waktu	Tanggal dan waktu Epoch yang berlaku (waktu UTC) untuk informasi dalam pesan pemberitahuan.	Opsional
expirationTime	Tanggal dan Waktu	Tanggal dan waktu Epoch (waktu UTC) yang diharapkan menjadi akhir notifikasi. Nilainya mungkin null untuk peristiwa yang berlangsung tanpa batas waktu, dan dalam hal ini, judul akan menunjukkan bahwa peristiwa "berlaku".	Opsional
dataSource	Enum	Detail otoritas, termasuk penayang, nama, dan URL.	Wajib
regionCode	Enum	Kode wilayah lokasi yang telah diminta.	Opsional

Catatan: Jika tidak ada peringatan aktif di lokasi yang diminta atau kolom wajib diisi dari penyedia asli tidak ada, isi respons hanya menyertakan kolom regionCode. Jika kolom opsional dari penyedia asli tidak ada, kolom opsional tersebut tidak disertakan dalam isi respons.

Sumber data

Endpoint peringatan cuaca menampilkan data yang dipublikasikan oleh penyedia yang tercantum dalam tabel berikut. Berdasarkan koordinat lintang dan bujur yang diberikan dalam permintaan, isi respons menampilkan data dari otoritas lokal yang sesuai.

Penyedia yang disertakan dalam feed harus mematuhi pedoman Google Siap Siaga. Google dapat memperbarui daftar penyedia kapan saja.

Negara	Agensi iklan
Australia	ACT Emergency Services Agency (ACT ESA)
	New South Wales Rural Fire Service (NSW RFS)
	South Australian Country Fire Service (SA CFS)
	Tasmania Fire Service (TFS)
	Queensland Fire and Emergency Services (QFES)
Austria	GeoSphere Austria melalui MeteoAlarm
Belgia	Royal Meteorological Institute of Belgium melalui MeteoAlarm
Bosnia-Herzegovina	Federal Hydro-meteorological Institute (FHMZ) melalui MeteoAlarm
Bulgaria	National Institute of Meteorology & Hydrology melalui MeteoAlarm
Brasil	Centro Nacional de Gerenciamento de Riscos e Desastres (CENAD)
	Instituto Nacional de Meteorologia (INMET)
Kolombia	Unidad Nacional para la Gestión del Riesgo de Desastres (UNGRD)
Côte d'Ivoire	Société d'Exploitation et de Développement Aéroportuaire, Aéronautique et Météorologique
Kroasia	Croatian Meteorological and Hydrological Service melalui MeteoAlarm
Siprus	Department of Meteorology melalui MeteoAlarm
Ceko	Czech Hydrometeorological Institute melalui MeteoAlarm
Denmark	Danish Meteorological Institute melalui MeteoAlarm
Ekuador	Instituto Nacional de Meteorología e Hidrología
Estonia	Ministry of Climate melalui MeteoAlarm
Finlandia	Finnish Meteorological Institute melalui MeteoAlarm
Prancis	Météo-France melalui MeteoAlarm
Jerman	DWD - The German Weather Service
Yunani	Hellenic National Meteorological Service melalui MeteoAlarm
Guinea	Agence Nationale de la Météorologie
Hungaria	HungaroMet Nonprofit Zrt melalui MeteoAlarm
Islandia	Icelandic Meteorological Office melalui MeteoAlarm
Irlandia	Met Eirann melalui MeteoAlarm
Italia	Italian Meteorological Service melalui MeteoAlarm
Jamaika	Meteorological Service of Jamaica
Jepang	Japan Meteorological Agency (JMA)
Latvia	Latvian Environment, Geology and Meteorology Centre melalui MeteoAlarm
Lituania	Lithuanian Hydrometeorological Service melalui MeteoAlarm
Luksemburg	MeteoLux melalui MeteoAlarm
Madagaskar	Météo Madagascar
Meksiko	Centro de Instrumentación y Registro Sísmico A.C. (CIRES)
Belanda	Royal Netherlands Meteorological Institute melalui MeteoAlarm
Makedonia Utara	National Hydrometeorological Service melalui MeteoAlarm
Norwegia	Norwegian Meteorological Institute melalui MeteoAlarm
Selandia Baru	GNS Science (GeoNet)
	MetService
Filipina	Philippine Atmospheric, Geophysical & Astronomical Services Administration (PAGASA)
Polandia	Institute of Meteorology and Water Management melalui MeteoAlarm
Portugal	Portuguese Institute for Sea and Atmosphere melalui MeteoAlarm
Rumania	National Meteorological Administration melalui MeteoAlarm
Serbia	Republic Hydrometeorological Institute of Serbia melalui MeteoAlarm
Singapura	Meteorological Service Singapore
Slovakia	Slovak Hydrometeorological Institute melalui MeteoAlarm
Slovenia	Hydrometeorological Institute of Slovenia melalui MeteoAlarm
Kepulauan Solomon	Solomon Islands Meteorological Services
Korea Selatan	Korea Meteorological Administration
Spanyol	State Meteorological Agency melalui MeteoAlarm
Swedia	Swedish Meteorological and Hydrological Institute melalui MeteoAlarm
Swiss	Federal Office of Meteorology and Climatology MeteoSwiss melalui MeteoAlarm
Taiwan	National Science and Technology Center for Disaster Reduction (NCDR)
Thailand	Thai Meteorological Department
Inggris Raya	Met Office melalui MeteoAlarm
	UK Environment Agency
Amerika Serikat	National Tsunami Warning Center
	US National Weather Service
Vietnam	National Center for Hydrometeorological Forecasting

Atribusi

Di semua tampilan tempat data disajikan, aplikasi pelanggan harus mencantumkan atribusi ke sumber asli menggunakan kolom dataSource:

"dataSource": {
        "publisher": "NOAA",
        "name": "National Weather Service",
        "authorityUri": "https://www.weather.gov/"
      }

Atribusi harus menyertakan nama lengkap sumber data (seperti yang diberikan di kolom name) dan hyperlink ke sumber data menggunakan URL yang diberikan di kolom authorityUri (misalnya, "National Weather Service").

Jenis peristiwa cuaca

Jenis peristiwa cuaca berikut didukung:

Jenis peristiwa cuaca
ACID_RAIN AVALANCHE BLIZZARD BLOWING_SNOW COASTAL_FLOOD COASTAL_HAZARD COLD CYCLONE DROUGHT EXTRATROPICAL_CYCLONE FIRE_WEATHER FLASH_FLOOD FLOOD FOG FREEZING FREEZING_AIR_TEMPERATURE FREEZING_DRIZZLE FREEZING_RAIN FROST GALE GLAZE HAIL HAZARDOUS_SEAS HEAT HUMIDITY HURRICANE ICE_STORM LAKE_EFFECT_SNOW MONSOON MUDDY_FLOOD OUTFLOW RAIN	RIVER_FLOODING SEVERE_THUNDERSTORM_WARNING SNOW SNOWSQUALL STORM STORM_SURGE THUNDER THUNDERSTORM TORNADO TORNADO_WARNING TROPICAL_CYCLONE TROPICAL_CYCLONE_WARNINGS_AND_WATCHES TROPICAL_DISTURBANCE TROPICAL_STORM TYPHOON WIND WIND_CHILL WIND_WAVE WINTER_STORM WILDFIRE BUSHFIRE FIRE LANDSLIDE EARTHQUAKE DUST_STORM AFTERSHOCK TSUNAMI VOLCANIC_ASH VOLCANIC_ERUPTION RADIATION

Perilaku terjemahan respons

Google hanya menyediakan terjemahan untuk kolom alertTitle. Kolom lain seperti eventType, areaName, instruction, dan safetyRecommendations juga dapat diterjemahkan, bergantung pada dukungan bahasa sumber data asli; namun, Google tidak dapat memberikan terjemahan independen untuk kolom ini.

Berdasarkan parameter languageCode yang disertakan dalam permintaan, perilaku berikut diharapkan untuk kolom alertTitle:

• Didukung languageCode: Jika languageCode yang diminta disediakan dan didukung, respons akan ditampilkan dalam bahasa yang diminta.
• Tidak didukung languageCode: Jika languageCode yang diminta tidak didukung dan alternatif yang mendekati tidak dapat ditemukan, endpoint akan menampilkan respons dalam bahasa Inggris secara default.
• Tidak ada languageCode yang diberikan: Endpoint akan menampilkan respons dalam bahasa Inggris secara default.

Contoh permintaan peringatan cuaca

Contoh berikut meminta informasi peringatan cuaca untuk sebuah kota di North Carolina:

curl -X GET "https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=35.824635&location.longitude=-78.3168047&languageCode=en"

Isi responsnya adalah sebagai berikut:

{
  "weatherAlerts": [
    {
      "alertId": "urn:oid:2.49.0.1.840.0.2416b1b5a6f51d29ef4b94948328dca303fbbb5c.001.1",
      "alertTitle": {
        "text": "Flash Flood Warning",
        "languageCode": "en"
      },
      "eventType": "FLASH_FLOOD",
      "areaName": "Franklin, NC; Johnston, NC; Nash, NC; Wake, NC",
      "polygon": "{\"type\":\"Polygon\",\"coordinates\":[[[-78.450000,35.820000],[-78.410000,35.730000],[-78.280000,35.660000],
        [-78.180000,35.740000],[-77.840000,36.150000],[-77.890000,36.140000],[-77.900000,36.160000],[-77.920000,36.170000],
        [-77.930000,36.190000], [-77.940000,36.190000],[-77.950000,36.180000],[-77.970000,36.190000],[-77.970000,36.180000],
        [-77.980000,36.180000],[-78.010000,36.210000],[-78.040000,36.210000],[-78.110000,36.210000],[-78.130000,36.230000],
        [-78.350000,35.940000],[-78.450000,35.820000]]]}",
      "description": "FFWRAH\n\nThe National Weather Service in Raleigh has issued a\n\n* Flash Flood Warning for...
        \nEastern Franklin County in central North Carolina...\nNorth Central Johnston County in central North Carolina...
        \nWestern Nash County in central North Carolina...\nEast Central Wake County in central North Carolina...
        \n\n* Until 530 PM EDT.\n\n* At 224 PM EDT, local law enforcement reported flash flooding in\nSpring Hope. Between 3 and 5 inches of rain have fallen.
        \nAdditional rainfall amounts of 1 to 3 inches are possible in the\nwarned area.\n\nHAZARD...Life threatening flash flooding.
        Heavy rain producing\nflash flooding.\n\nSOURCE...Law enforcement reported.\n\nIMPACT...Life threatening flash flooding of creeks and streams,\nurban areas,
        highways, streets and underpasses.\n\n* Some locations that will experience flash flooding include...
        \nZebulon, Bunn, Wendell, Spring Hope, Middlesex, Castalia,\nCenterville, Pilot, Emit and Aventon.",
      "severity": "SEVERE",
      "certainty": "LIKELY",
      "urgency": "IMMEDIATE",
      "instruction": [
        "Turn around, don't drown when encountering flooded roads. Most flood\ndeaths occur in vehicles."
      ],
      "safetyRecommendations": [
        {
          "directive": "Build an emergency kit and make a family communications plan.",
          "subtext": "Follow the instructions at http://www.ready.gov/build-a-kit for building 
            an emergency kit and http://www.ready.gov/make-a-plan for a family communications plan."
        },
        {
          "directive": "Be aware that flash flooding can occur. ",
          "subtext": "If there is any possibility of a flash flood, move immediately to higher ground. Do not wait for instructions to move."
        },
        ...
      ],
      "timezoneOffset": "-14400s",
      "startTime": "2025-08-06T18:24:00Z",
      "expirationTime": "2025-08-06T21:30:00Z",
      "dataSource": {
        "publisher": "NOAA",
        "name": "National Weather Service",
        "authorityUri": "https://www.weather.gov/"
      }
    }
  ],
  "regionCode": "US"
}

Cobalah!

APIs Explorer memungkinkan Anda membuat contoh permintaan sehingga Anda dapat memahami API dan opsi API.

1. Pilih ikon API api di sisi kanan halaman.

2. Edit parameter permintaan secara opsional.

3. Pilih tombol Execute. Dalam dialog, pilih akun yang ingin Anda gunakan untuk membuat permintaan.

4. Di panel APIs Explorer, pilih ikon layar penuh fullscreen untuk meluaskan jendela APIs Explorer.