ปลายทาง
publicAlerts
จะให้รายละเอียดการแจ้งเตือนเหตุการณ์สภาพอากาศที่เฉพาะเจาะจงซึ่งออกโดย
หน่วยงานระดับชาติและนานาชาติที่มีอำนาจ การแจ้งเตือนเหล่านี้จะให้ข้อมูลที่สำคัญ
ซึ่งอาจช่วยชีวิตได้
ปลายทางจะแสดงการแจ้งเตือนสภาพอากาศที่เกิดขึ้นแบบเรียลไทม์สำหรับละติจูดและลองจิจูดที่ระบุ เหตุการณ์สภาพอากาศที่รองรับมีดังนี้
- การเกิดฝน: ฝน หิมะ ลูกเห็บ ภัยแล้ง และอื่นๆ
- อุณหภูมิสุดขั้ว: หนาว ร้อน เย็นจัด น้ำค้างแข็ง ความเย็นจากลม และความชื้น
- เหตุการณ์ลมและพายุ: พายุหิมะ เฮอร์ริเคน ทอร์นาโด พายุโซนร้อน พายุฝนฟ้าคะนอง และอื่นๆ
- การบดบังทัศนวิสัย: หมอก พายุฝุ่น และลมหิมะ
- อันตรายที่เกี่ยวข้องกับน้ำ: น้ำท่วม สึนามิ น้ำทะเลหนุนสูง อันตรายจากบริเวณชายฝั่ง และอื่นๆ
- เหตุการณ์ทางธรณีฟิสิกส์และธรณีวิทยา: แผ่นดินไหว ดินถล่ม และกิจกรรมภูเขาไฟ
- เหตุการณ์ไฟไหม้: ไฟป่า สภาพอากาศที่เสี่ยงต่อการเกิดไฟไหม้ และอื่นๆ
ดูรายการเหตุการณ์สภาพอากาศที่รองรับทั้งหมดได้ที่ประเภทเหตุการณ์สภาพอากาศ
การแจ้งเตือนอาจมีหรือไม่มีคำอธิบายที่แปลเป็นภาษาท้องถิ่นก็ได้ ทั้งนี้ขึ้นอยู่กับสิ่งที่แหล่งข้อมูลมีให้ เนื่องจากข้อจำกัดของแหล่งข้อมูล ระบบจึงแสดงข้อมูลตามที่เป็นอยู่ (เนื้อหาดิบ) ดูข้อมูลเพิ่มเติมเกี่ยวกับแหล่งที่มาของการแจ้งเตือนสภาพอากาศได้ที่แหล่งข้อมูล
API จะแสดงข้อมูลต่อไปนี้สำหรับการแจ้งเตือนสภาพอากาศที่ระบุ
- ประเภทเหตุการณ์สภาพอากาศที่เชื่อมโยงกับการแจ้งเตือน
- รายชื่อพื้นที่ที่ได้รับผลกระทบพร้อมพิกัดที่กำหนดขอบเขตทางภูมิศาสตร์ของพื้นที่เหล่านั้น
- สรุปเหตุการณ์สภาพอากาศใน 1 ประโยค
- ระดับความรุนแรง ความแน่นอน และความเร่งด่วน
- คำอธิบายของวิธีการแนะนำการดำเนินการสำหรับกลุ่มเป้าหมาย
- คำแนะนำด้านความปลอดภัย
- เวลาเริ่มต้นและเวลาสิ้นสุดของการแจ้งเตือน
- ชื่อและเว็บไซต์ของหน่วยงานที่เผยแพร่
โปรแกรมสำรวจ API ช่วยให้คุณส่งคำขอแบบเรียลไทม์เพื่อให้คุ้นเคยกับ API และตัวเลือก API ดังนี้
เกี่ยวกับการขอรับการแจ้งเตือนสภาพอากาศ
หากต้องการขอข้อมูลการแจ้งเตือนสภาพอากาศ ให้ส่งคำขอ HTTP GET ไปยัง
https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE
ใส่พิกัดละติจูดและลองจิจูดของสถานที่ในพารามิเตอร์ URL ของคำขอ
เกี่ยวกับการตอบกลับการแจ้งเตือนสภาพอากาศ
Weather API จะแสดงผลช่องต่อไปนี้ในเนื้อหาการตอบกลับ
| ช่อง | ประเภท | คำอธิบาย | ต้องระบุหรือไม่บังคับ |
|---|---|---|---|
alertId |
สตริง | รหัสการแจ้งเตือน คุณยังดูข้อมูลนี้ได้ในเว็บไซต์ของผู้ให้บริการข้อมูลด้วย | ต้องระบุ |
alertTitle |
สตริง | ชื่อของการแจ้งเตือนซึ่งอธิบายเหตุการณ์สภาพอากาศ หมายเหตุ: สตริงนี้เป็นสตริงเดียวที่จะได้รับการแปลเมื่อรวมพารามิเตอร์รหัสภาษาไว้ในคำขอ |
ต้องระบุ |
eventType |
ค่าแจกแจง | ประเภทเหตุการณ์สภาพอากาศที่เชื่อมโยงกับการแจ้งเตือน ดูรายการเหตุการณ์สภาพอากาศที่รองรับทั้งหมดได้ที่ประเภทเหตุการณ์สภาพอากาศ |
ต้องระบุ |
areaName |
สตริง | ชื่อพื้นที่ทางภูมิศาสตร์ที่ได้รับผลกระทบจากการแจ้งเตือน ซึ่งรวมถึงสถานที่ที่ขอ | ต้องระบุ |
polygon |
สตริง | พิกัดที่กำหนดพื้นที่มิติข้อมูลที่ปิดของการแจ้งเตือน | ไม่บังคับ |
description |
สตริง | วลีสั้นๆ ที่สรุปคำอธิบายเหตุการณ์ในภาษาที่ระบุ (เช่น "คำเตือนพายุทอร์นาโด") | ไม่บังคับ |
severity |
ค่าแจกแจง | ระดับความรุนแรงของการแจ้งเตือน:
|
ไม่บังคับ |
certainty |
ค่าแจกแจง | ระดับความแน่นอนของการแจ้งเตือน:
|
ไม่บังคับ |
urgency |
ค่าแจกแจง | ระดับความเร่งด่วนของการแจ้งเตือน:
|
ไม่บังคับ |
instruction |
สตริง | คำอธิบายของวิธีการดำเนินการที่ตอบสนองสำหรับกลุ่มเป้าหมาย | ไม่บังคับ |
safetyRecommendations |
สตริง | คำแนะนำด้านความปลอดภัยตามรหัสของหน่วยงานภาครัฐ ประกอบด้วยคำสั่งระดับบนสุดและข้อความย่อยพร้อมข้อมูลเพิ่มเติม | ไม่บังคับ |
timezoneOffset |
สตริง | ค่าชดเชยเขตเวลาของเหตุการณ์ในรูปแบบ +/-HH:MM | ต้องระบุ |
startTime |
DateTime | วันที่และเวลา Epoch ที่มีผล (เวลา UTC) ของข้อมูลในข้อความแจ้ง | ไม่บังคับ |
expirationTime |
DateTime | วันที่และเวลา Epoch (เวลา UTC) ที่คาดว่าการแจ้งเตือนจะสิ้นสุด อาจเป็นค่า Null สำหรับเหตุการณ์ที่ยาวนานอย่างไม่มีกำหนด ในกรณีนี้พาดหัวจะระบุว่าเหตุการณ์ "มีผล" | ไม่บังคับ |
dataSource |
ค่าแจกแจง | รายละเอียดเกี่ยวกับแหล่งที่มา ซึ่งรวมถึงผู้เผยแพร่ ชื่อ และ URL | ต้องระบุ |
regionCode |
ค่าแจกแจง | รหัสภูมิภาคของสถานที่ที่ขอ | ไม่บังคับ |
แหล่งข้อมูล
ปลายทางของการแจ้งเตือนสภาพอากาศจะแสดงข้อมูลที่เผยแพร่โดยผู้ให้บริการที่ระบุไว้ใน ตารางต่อไปนี้ อิงตามพิกัดละติจูดและลองจิจูดที่ระบุในคำขอ เนื้อหาการตอบกลับจะแสดงข้อมูลจากหน่วยงานท้องถิ่นที่เหมาะสม
ผู้ให้บริการที่รวมอยู่ในฟีดจะปฏิบัติตามหลักเกณฑ์การแจ้งเตือนสาธารณะของ Google Google อาจอัปเดตรายชื่อผู้ให้บริการได้ทุกเมื่อ
การระบุแหล่งที่มา
ในจอแสดงผลทั้งหมดที่มีการนำเสนอข้อมูล แอปพลิเคชันของลูกค้าต้องระบุแหล่งที่มาของแหล่งข้อมูลเดิมโดยใช้ฟิลด์ dataSource ดังนี้
"dataSource": {
"publisher": "NOAA",
"name": "National Weather Service",
"authorityUri": "https://www.weather.gov/"
}
การระบุแหล่งที่มาต้องมีชื่อเต็มของแหล่งข้อมูล (ตามที่ระบุไว้ใน
ฟิลด์ name) และไฮเปอร์ลิงก์ไปยังแหล่งข้อมูลโดยใช้ URL ที่ระบุไว้ใน
ฟิลด์ authorityUri (เช่น "National Weather
Service")
ประเภทเหตุการณ์สภาพอากาศ
ระบบรองรับประเภทเหตุการณ์สภาพอากาศต่อไปนี้
| ประเภทเหตุการณ์สภาพอากาศ | |
|---|---|
ACID_RAINAVALANCHEBLIZZARDBLOWING_SNOWCOASTAL_FLOODCOASTAL_HAZARDCOLDCYCLONEDROUGHTEXTRATROPICAL_CYCLONEFIRE_WEATHERFLASH_FLOODFLOODFOGFREEZINGFREEZING_AIR_TEMPERATUREFREEZING_DRIZZLEFREEZING_RAINFROSTGALEGLAZEHAILHAZARDOUS_SEASHEATHUMIDITYHURRICANEICE_STORMLAKE_EFFECT_SNOWMONSOONMUDDY_FLOODOUTFLOWRAIN
|
RIVER_FLOODINGSEVERE_THUNDERSTORM_WARNINGSNOWSNOWSQUALLSTORMSTORM_SURGETHUNDERTHUNDERSTORMTORNADOTORNADO_WARNINGTROPICAL_CYCLONETROPICAL_CYCLONE_WARNINGS_AND_WATCHESTROPICAL_DISTURBANCETROPICAL_STORMTYPHOONWINDWIND_CHILLWIND_WAVEWINTER_STORMWILDFIREBUSHFIREFIRELANDSLIDEEARTHQUAKEDUST_STORMAFTERSHOCKTSUNAMIVOLCANIC_ASHVOLCANIC_ERUPTIONRADIATION |
ลักษณะการทำงานของการแปลคำตอบ
Google จะแปลเฉพาะฟิลด์ alertTitle ระบบอาจแปลฟิลด์อื่นๆ เช่น eventType, areaName, instruction และ safetyRecommendations ด้วย ทั้งนี้ขึ้นอยู่กับการรองรับภาษาของแหล่งข้อมูลต้นฉบับ อย่างไรก็ตาม Google ไม่สามารถแปลฟิลด์เหล่านี้แยกกันได้
ตามพารามิเตอร์ languageCode ที่รวมอยู่ในคำขอ ฟิลด์ alertTitle จะมีลักษณะการทำงานดังนี้
- รองรับ
languageCode: หากมีการระบุและรองรับlanguageCodeที่ขอ ระบบจะแสดงคำตอบในภาษาที่ขอ - ไม่รองรับ
languageCode: ในกรณีที่ระบบไม่รองรับlanguageCodeที่ขอและไม่พบทางเลือกที่ใกล้เคียงกัน ปลายทางจะแสดงการตอบกลับเป็นภาษาอังกฤษโดยค่าเริ่มต้น - ไม่มี
languageCode: ค่าเริ่มต้นคือปลายทางจะแสดงคำตอบเป็นภาษาอังกฤษ
ตัวอย่างคำขอการแจ้งเตือนสภาพอากาศ
ตัวอย่างคำขอต่อไปนี้จะขอข้อมูลการแจ้งเตือนสภาพอากาศสำหรับเมืองในรัฐนอร์ทแคโรไลนา
curl -X GET "https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=35.824635 &location.longitude=-78.3168047 &languageCode=en"
เนื้อหาการตอบกลับมีดังนี้
{ "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" }
ลองใช้งาน
โปรแกรมสำรวจ API ช่วยให้คุณส่งคำขอตัวอย่างได้ เพื่อให้คุ้นเคยกับ API และตัวเลือก API
เลือกไอคอน API api ทางด้านขวาของหน้า
แก้ไขพารามิเตอร์คำขอ (ไม่บังคับ)
เลือกปุ่มดำเนินการ ในกล่องโต้ตอบ ให้เลือกบัญชี ที่ต้องการใช้เพื่อส่งคำขอ
ในแผงโปรแกรมสำรวจ API ให้เลือกไอคอนเต็มหน้าจอ fullscreen เพื่อขยายหน้าต่างโปรแกรมสำรวจ API