รับการแจ้งเตือนสภาพอากาศ

ปลายทาง publicAlerts จะให้รายละเอียดการแจ้งเตือนเหตุการณ์สภาพอากาศที่เฉพาะเจาะจงซึ่งออกโดย หน่วยงานระดับชาติและนานาชาติที่เชื่อถือได้ การแจ้งเตือนเหล่านี้จะให้ข้อมูลที่สำคัญ ซึ่งอาจช่วยชีวิตได้

ปลายทางจะแสดงการแจ้งเตือนสภาพอากาศที่เกิดขึ้นแบบเรียลไทม์สำหรับละติจูดและลองจิจูดที่ระบุ เหตุการณ์สภาพอากาศที่รองรับมีดังนี้

• หยาดน้ำฟ้า: ฝน หิมะ ลูกเห็บ ภัยแล้ง และอื่นๆ
• อุณหภูมิสุดขั้ว: หนาว ร้อน เย็นจัด น้ำค้างแข็ง อุณหภูมิที่รู้สึก และ ความชื้น
• เหตุการณ์ลมและพายุ: พายุหิมะ พายุเฮอริเคน พายุทอร์นาโด พายุโซนร้อน พายุฝนฟ้าคะนอง และอื่นๆ
• ทัศนวิสัยไม่ดี: หมอก พายุฝุ่น และลมหิมะ
• อันตรายที่เกี่ยวข้องกับน้ำ: น้ำท่วม สึนามิ น้ำทะเลหนุน อันตรายจากบริเวณชายฝั่ง และอื่นๆ
• เหตุการณ์ทางธรณีฟิสิกส์และธรณีวิทยา: แผ่นดินไหว ดินถล่ม และกิจกรรมภูเขาไฟ
• เหตุการณ์ไฟไหม้: ไฟป่า สภาพอากาศที่เอื้อต่อการเกิดไฟไหม้ และอื่นๆ

ดูรายการเหตุการณ์สภาพอากาศที่รองรับทั้งหมดได้ที่ประเภทเหตุการณ์สภาพอากาศ

การแจ้งเตือนอาจมีหรือไม่มีคำอธิบายที่แปลเป็นภาษาท้องถิ่นก็ได้ ทั้งนี้ขึ้นอยู่กับสิ่งที่แหล่งข้อมูลมีให้ เนื่องจากข้อจำกัดของแหล่งข้อมูล ระบบจึงแสดงข้อมูลตามที่เป็นอยู่ (เนื้อหาดิบ) ดูข้อมูลเพิ่มเติมเกี่ยวกับแหล่งที่มาของการแจ้งเตือนสภาพอากาศได้ที่แหล่งข้อมูล

API จะแสดงข้อมูลต่อไปนี้สำหรับการแจ้งเตือนสภาพอากาศที่ระบุ

• ประเภทของเหตุการณ์สภาพอากาศที่เชื่อมโยงกับการแจ้งเตือน
• รายชื่อพื้นที่ที่ได้รับผลกระทบพร้อมพิกัดที่กำหนดขอบเขตทางภูมิศาสตร์ของพื้นที่เหล่านั้น
• สรุปเหตุการณ์สภาพอากาศใน 1 ประโยค
• ระดับความรุนแรง ความแน่นอน และความเร่งด่วน
• คำอธิบายของวิธีการแนะนำการดำเนินการสำหรับกลุ่มเป้าหมาย
• คำแนะนำด้านความปลอดภัย
• เวลาเริ่มต้นและเวลาสิ้นสุดของการแจ้งเตือน
• ชื่อและเว็บไซต์ของหน่วยงานที่เผยแพร่

โปรแกรมสำรวจ API ช่วยให้คุณส่งคำขอแบบเรียลไทม์เพื่อให้คุ้นเคยกับ API และตัวเลือก API ดังนี้

เกี่ยวกับคำขอการแจ้งเตือนสภาพอากาศ

หากต้องการขอข้อมูลการแจ้งเตือนสภาพอากาศ ให้ส่งคำขอ GET ของ HTTP ไปยัง

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

ใส่พิกัดละติจูดและลองจิจูดของสถานที่ในพารามิเตอร์ URL ของคำขอ

เกี่ยวกับการตอบกลับการแจ้งเตือนสภาพอากาศ

Weather API จะแสดงผลฟิลด์ต่อไปนี้ในเนื้อหาการตอบกลับ

แหล่งข้อมูล

ปลายทางของการแจ้งเตือนสภาพอากาศจะแสดงข้อมูลที่เผยแพร่โดยผู้ให้บริการที่ระบุไว้ในตารางต่อไปนี้ อิงตามพิกัดละติจูดและลองจิจูดที่ระบุในคำขอ เนื้อหาการตอบกลับจะแสดงข้อมูลจากหน่วยงานท้องถิ่นที่เหมาะสม

ผู้ให้บริการที่รวมอยู่ในฟีดจะปฏิบัติตามหลักเกณฑ์การเตือนภัยสาธารณะของ Google Google อาจอัปเดตรายชื่อผู้ให้บริการได้ทุกเมื่อ

การระบุแหล่งที่มา

ในจอแสดงผลทั้งหมดที่มีการนำเสนอข้อมูล แอปพลิเคชันของลูกค้าต้อง รวมการระบุแหล่งที่มาของแหล่งที่มาเดิมโดยใช้ฟิลด์ dataSource ดังนี้

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

การระบุแหล่งที่มาต้องมีชื่อเต็มของแหล่งข้อมูล (ตามที่ระบุไว้ใน ฟิลด์ name) และไฮเปอร์ลิงก์ไปยังแหล่งข้อมูลโดยใช้ URL ที่ระบุไว้ใน ฟิลด์ authorityUri (เช่น "National Weather Service")

ประเภทเหตุการณ์สภาพอากาศ

ระบบรองรับประเภทเหตุการณ์สภาพอากาศต่อไปนี้

ลักษณะการทำงานของการแปลคำตอบ

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

1. เลือกไอคอน API api ทางด้านขวาของหน้า

2. แก้ไขพารามิเตอร์คำขอ (ไม่บังคับ)

3. เลือกปุ่มดำเนินการ ในกล่องโต้ตอบ ให้เลือกบัญชี ที่ต้องการใช้เพื่อส่งคำขอ

4. ในแผงโปรแกรมสำรวจ API ให้เลือกไอคอนเต็มหน้าจอ fullscreen เพื่อขยายหน้าต่างโปรแกรมสำรวจ API