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

ปลายทาง 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