Method: publicAlerts.lookup

แสดงการแจ้งเตือนสภาพอากาศสาธารณะสำหรับสถานที่ที่ระบุ

คำขอ HTTP

GET https://weather.googleapis.com/v1/publicAlerts:lookup

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์การค้นหา

พารามิเตอร์
location

object (LatLng)

ต้องระบุ สถานที่ที่จะรับการแจ้งเตือนสภาพอากาศสาธารณะ บริการจะแสดงการแจ้งเตือนที่มีพื้นที่ได้รับผลกระทบซึ่งทับซ้อนกับตำแหน่งนี้
pageSize

integer

ไม่บังคับ จำนวนสูงสุดของระเบียนการแจ้งเตือนสภาพอากาศสาธารณะที่จะแสดงต่อหน้า
pageToken

string

ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ publicAlerts.lookup ก่อนหน้านี้ ระบุข้อมูลนี้เพื่อดึงข้อมูลหน้าถัดไป เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ publicAlerts.lookup ต้องตรงกับการเรียกที่ระบุโทเค็นหน้าเว็บ
languageCode

string

ไม่บังคับ อนุญาตให้ไคลเอ็นต์เลือกภาษาสำหรับคำตอบ หากไม่มีข้อมูลสำหรับภาษานั้น API จะใช้ข้อมูลที่ใกล้เคียงที่สุด ค่าที่อนุญาตจะขึ้นอยู่กับมาตรฐาน IETF BCP-47 ค่าเริ่มต้นคือ "en"

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

การตอบกลับสำหรับ RPC publicAlerts.lookup

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "weatherAlerts": [
    {
      object (PublicAlerts)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
ช่อง
weatherAlerts[]

object (PublicAlerts)

บันทึกการแจ้งเตือนสภาพอากาศสาธารณะตามจำนวนการแจ้งเตือนและขนาดหน้าเว็บที่ระบุในคำขอ
regionCode

string

รหัส ISO_3166-1 alpha-2 ของภูมิภาคที่สอดคล้องกับสถานที่ที่ระบุในคำขอ ระบุภูมิภาคโดยใช้ ISO_3166-1_alpha-2
nextPageToken

string

โทเค็นที่ส่งเป็น pageToken เพื่อดึงข้อมูลหน้าถัดไปได้ หากละเว้นช่องนี้ จะไม่มีหน้าถัดไป

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/cloud-platform

PublicAlerts

แสดงการแจ้งเตือนสภาพอากาศสาธารณะ

การแสดง JSON 
{
  "alertId": string,
  "alertTitle": {
    object (LocalizedText)
  },
  "eventType": enum (WeatherEventType),
  "areaName": string,
  "instruction": [
    string
  ],
  "safetyRecommendations": [
    {
      object (SafetyRecommendation)
    }
  ],
  "timezoneOffset": string,
  "startTime": string,
  "expirationTime": string,
  "dataSource": {
    object (DataSource)
  },
  "polygon": string,
  "description": string,
  "severity": enum (Severity),
  "certainty": enum (Certainty),
  "urgency": enum (Urgency)
}
ช่อง
alertId

string

ตัวระบุที่ไม่ซ้ำกันสำหรับการแจ้งเตือนนี้
alertTitle

object (LocalizedText)

ชื่อที่แปลแล้วของการแจ้งเตือน
eventType

enum (WeatherEventType)

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

string

ชื่อพื้นที่ที่มีการออกการแจ้งเตือน
instruction[]

string

คำแนะนำที่ผู้เผยแพร่โฆษณาแนะนำ โปรดทราบว่าแม้ว่าควรแปลฟิลด์นี้ แต่ก็ไม่มีการรับประกันว่าจะมีการแปล
safetyRecommendations[]

object (SafetyRecommendation)

คำสั่งแนะนำด้านความปลอดภัยแก่ผู้ใช้ ซึ่งอาจมาจากผู้เผยแพร่โฆษณาหรือหน่วยงานอื่นๆ
timezoneOffset

string

การชดเชยเขตเวลาจาก UTC สำหรับตำแหน่งของการแจ้งเตือน ค่าจะอยู่ในรูปแบบสตริงที่ลงท้ายด้วย "s" เช่น "-14400s" สำหรับ 4 ชั่วโมงหลังเวลา UTC
startTime

string (Timestamp format)

เวลาเริ่มต้นของกิจกรรม

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
expirationTime

string (Timestamp format)

เวลาหมดอายุของกิจกรรม

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
dataSource

object (DataSource)

รายละเอียดของผู้เผยแพร่เนื้อหาที่ออกการแจ้งเตือน
polygon

string

การแสดง GeoJSON ของพื้นที่ที่มีการออกการแจ้งเตือน

ข้อมูล GeoJSON ต้องอยู่ในรูปแบบ RFC 7946 และแสดงถึง Polygon (สำหรับพื้นที่ต่อเนื่องเดียว) หรือ MultiPolygon (สำหรับหลายพื้นที่ที่แตกต่างกัน)

ตัวอย่าง

{ "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] }

ตัวอย่างสตริง GeoJson ของ MultiPolygon มีลักษณะดังนี้

{ "type": "MultiPolygon", "coordinates": [ [ [0, 0], [-1, 0], [-1, 1], [0, 0] ], [ [0, 0], [-2, 0], [-2, 2], [0, 0] ] ]
description

string

ข้อความล่าสุดที่อธิบายการแจ้งเตือนตามที่หน่วยงานทางการออกให้ โปรดทราบว่าแม้ว่าควรแปลฟิลด์นี้ แต่ก็ไม่มีการรับประกันว่าจะมีการแปล
severity

enum (Severity)

ระดับความรุนแรงของการแจ้งเตือน
certainty

enum (Certainty)

ความแน่นอนของการแจ้งเตือน
urgency

enum (Urgency)

ความเร่งด่วนของการแจ้งเตือน

WeatherEventType

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

Enum
WEATHER_EVENT_TYPE_UNSPECIFIED ประเภทเหตุการณ์สภาพอากาศที่ไม่ได้ระบุ
ACID_RAIN เหตุการณ์ฝนกรด
AFTERSHOCK เหตุการณ์อาฟเตอร์ช็อก
AVALANCHE เหตุการณ์หิมะถล่ม
BLIZZARD เหตุการณ์พายุหิมะ
BLOWING_SNOW เหตุการณ์หิมะฟุ้งกระจาย
BUSHFIRE เหตุการณ์ไฟป่า
COASTAL_FLOOD เหตุการณ์น้ำท่วมชายฝั่ง
COASTAL_HAZARD เหตุการณ์อันตรายบริเวณชายฝั่ง
COLD เหตุการณ์ที่ไม่ได้เกิดขึ้น
CYCLONE เหตุการณ์พายุไซโคลน
DROUGHT เหตุการณ์ภัยแล้ง
DUST_STORM เหตุการณ์พายุฝุ่น
EARTHQUAKE เหตุการณ์แผ่นดินไหว
EXTRATROPICAL_CYCLONE เหตุการณ์พายุไซโคลนนอกเขตร้อน
FIRE เหตุการณ์ไฟ
FIRE_WEATHER เหตุการณ์สภาพอากาศที่ทำให้เกิดไฟ
FLASH_FLOOD เหตุการณ์น้ำท่วมฉับพลัน
FLOOD เหตุการณ์น้ำท่วม
FOG เหตุการณ์หมอก
FREEZING เหตุการณ์การหยุดทำงาน
FREEZING_AIR_TEMPERATURE เหตุการณ์อุณหภูมิอากาศหนาวจัด
FREEZING_DRIZZLE เหตุการณ์ฝนเยือกแข็งเบาบาง
FREEZING_RAIN_EVENT เหตุการณ์ฝนเยือกแข็ง
FROST เหตุการณ์น้ำค้างแข็ง
GALE เหตุการณ์ Gale
GLAZE เหตุการณ์เคลือบ
HAIL เหตุการณ์ลูกเห็บ
HAZARDOUS_SEAS เหตุการณ์คลื่นลมแรง
HEAT เหตุการณ์ความร้อน
HUMIDITY เหตุการณ์ความชื้น
HURRICANE เหตุการณ์พายุเฮอริเคน
ICE_STORM เหตุการณ์พายุน้ำแข็ง
INDUSTRIAL_FIRE เหตุการณ์ไฟไหม้ในโรงงานอุตสาหกรรม
LAKE_EFFECT_SNOW เหตุการณ์หิมะที่เกิดจากทะเลสาบ
LANDSLIDE เหตุการณ์ดินถล่ม
MONSOON เหตุการณ์มรสุม
MUDDY_FLOOD เหตุการณ์น้ำท่วมที่มีโคลน
OUTFLOW เหตุการณ์การไหลออก
RADIATION เหตุการณ์การแผ่รังสี
RAIN_EVENT เหตุการณ์ฝนตก
RIVER_FLOODING เหตุการณ์น้ำท่วมในแม่น้ำ
SEVERE_THUNDERSTORM_WARNING เหตุการณ์คำเตือนให้ระวังพายุฝนฟ้าคะนองรุนแรง
SNOWSQUALL เหตุการณ์หิมะและลมกระโชกแรง
SNOW_EVENT หิมะ
STORM เหตุการณ์พายุ
STORM_SURGE เหตุการณ์สตอร์มเซิร์จ
THUNDER เหตุการณ์ฟ้าร้อง
THUNDERSTORM เหตุการณ์พายุฝนฟ้าคะนอง
TORNADO เหตุการณ์ทอร์นาโด
TORNADO_WARNING เหตุการณ์คำเตือนให้ระวังทอร์นาโด
TROPICAL_CYCLONE เหตุการณ์พายุหมุนเขตร้อน
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES เหตุการณ์คำเตือนและเฝ้าระวังพายุหมุนเขตร้อน
TROPICAL_DISTURBANCE เหตุการณ์การแปรปรวนของลมในเขตร้อน
TROPICAL_STORM เหตุการณ์พายุโซนร้อน
TSUNAMI เหตุการณ์สึนามิ
TYPHOON เหตุการณ์พายุไต้ฝุ่น
VOLCANIC_ASH เหตุการณ์เถ้าภูเขาไฟ
VOLCANIC_ERUPTION เหตุการณ์ภูเขาไฟระเบิด
WILDFIRE เหตุการณ์ไฟป่า
WIND เหตุการณ์ลม
WIND_CHILL เหตุการณ์ลมหนาว
WIND_WAVE เหตุการณ์คลื่นลม
WINTER_STORM เหตุการณ์พายุฤดูหนาว

ความรุนแรง

รหัสที่ระบุความรุนแรงของเหตุการณ์ที่เป็นหัวเรื่องของข้อความแจ้งเตือน

Enum
SEVERITY_UNKNOWN ไม่ทราบความรุนแรง
EXTREME ภัยคุกคามต่อชีวิตหรือทรัพย์สินที่ร้ายแรง
SEVERE ภัยคุกคามต่อชีวิตหรือทรัพย์สินอย่างร้ายแรง
MODERATE อาจเป็นภัยคุกคามต่อชีวิตหรือทรัพย์สิน
MINOR ภัยคุกคามต่อชีวิตหรือทรัพย์สินเล็กน้อย

ความแน่นอน

รหัสที่ระบุความแน่นอนของเหตุการณ์ที่เป็นหัวข้อของข้อความแจ้งเตือน

Enum
CERTAINTY_UNKNOWN ไม่ทราบความแน่นอน
OBSERVED พิจารณาว่าเกิดขึ้นแล้วหรือกำลังเกิดขึ้น
VERY_LIKELY เป็นไปได้อย่างมาก
LIKELY มีแนวโน้ม (p > ~50%)
POSSIBLE อาจเป็นไปได้แต่ไม่น่าจะเกิดขึ้น (p <= ~50%)
UNLIKELY ไม่น่าเป็นไปได้ (p ~ 0%)

กรณีเร่งด่วน

รหัสที่ระบุความเร่งด่วนของเหตุการณ์ที่เป็นหัวข้อของข้อความแจ้งเตือน

Enum
URGENCY_UNKNOWN ไม่ทราบความเร่งด่วน
IMMEDIATE ควรดำเนินการตอบสนองทันที
EXPECTED ควรดำเนินการตอบสนองในเร็วๆ นี้ (ภายในชั่วโมงถัดไป)
FUTURE ควรดำเนินการตอบสนองในอนาคตอันใกล้นี้
PAST คุณไม่จำเป็นต้องดำเนินการใดๆ อีกต่อไป

SafetyRecommendation

แสดงคำแนะนำด้านความปลอดภัย

การแสดง JSON 
{
  "directive": string,
  "subtext": string
}
ช่อง
directive

string

คำสั่งสำหรับผู้ใช้ โปรดทราบว่าแม้ว่าควรแปลฟิลด์นี้ แต่ก็ไม่มีการรับประกันว่าจะมีการแปล
subtext

string

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

DataSource

แสดงลิงก์ไปยังแหล่งข้อมูล

การแสดง JSON 
{
  "publisher": enum (Publisher),
  "name": string,
  "authorityUri": string
}
ช่อง
publisher

enum (Publisher)

ผู้เผยแพร่การแจ้งเตือน
name

string

ชื่อผู้เผยแพร่เนื้อหาอย่างเป็นทางการ โปรดทราบว่าแม้ว่าควรแปลฟิลด์นี้ แต่ก็ไม่มีการรับประกันว่าจะมีการแปล
authorityUri

string

URL ของเว็บไซต์ของหน่วยงาน

ผู้เผยแพร่

ผู้เผยแพร่การแจ้งเตือน

Enum
PUBLISHER_UNSPECIFIED ไม่ได้ระบุผู้เผยแพร่โฆษณา
AUSTRALIA_ACT_ESA ออสเตรเลีย ออสเตรเลียนแคพิทอลเทร์ริทอรี
AUSTRALIA_NSW_RFS นิวเซาท์เวลส์
AUSTRALIA_QLD_QFES ควีนส์แลนด์
AUSTRALIA_SA_CFS ออสเตรเลียใต้
METEO_ALARM_AT Meteoalarm / EUMETNET ออสเตรีย
METEO_ALARM_BS บอสเนีย
BRAZIL_CENAD หน่วยงานด้านภัยพิบัติของบราซิล
BRAZIL_INMET สำนักงานอุตุนิยมวิทยาในบราซิล
UK_ENV_AGENCY สหราชอาณาจักร
METEO_ALARM_BG Meteoalarm / EUMETNET บัลแกเรีย
METEO_ALARM_CR โครเอเชีย
METEO_ALARM_CY ไซปรัส
METEO_ALARM_CS เช็กเกีย
METEO_ALARM_DK เดนมาร์ก
EC_INAMHI เอกวาดอร์
METEO_ALARM_FI Meteoalarm / EUMETNET ฟินแลนด์
METEO_ALARM_FR ฝรั่งเศส
DE_DWD เยอรมนี
METEO_ALARM_GB Meteoalarm / EUMETNET บริเตนใหญ่
METEO_ALARM_GR กรีซ
METEO_ALARM_HU ฮังการี
METEO_ALARM_IS ไอซ์แลนด์
METEO_ALARM_IE ไอร์แลนด์
METEO_ALARM_IT อิตาลี
JM_JMS จาเมกา
JMA ญี่ปุ่น
METEO_ALARM_NL Meteoalarm / EUMETNET เนเธอร์แลนด์
METEO_ALARM_LV ลัตเวีย
METEO_ALARM_LT ลิทัวเนีย
METEO_ALARM_LU ลักเซมเบิร์ก
MEXICO_CIRES เม็กซิโก เม็กซิโก CIRES
NZ_GEONET นิวซีแลนด์ GeoNet ของนิวซีแลนด์
NZ_NMS MetService
METEO_ALARM_MK Meteoalarm / EUMETNET มาซิโดเนียเหนือ
METEO_ALARM_NO นอร์เวย์
PHILIPPINES_PAGASA ฟิลิปปินส์
METEO_ALARM_PL Meteoalarm / EUMETNET โปแลนด์
METEO_ALARM_PT โปรตุเกส
METEO_ALARM_RO โรมาเนีย
METEO_ALARM_RS เซอร์เบีย
SG_MSS สิงคโปร์
METEO_ALARM_SK Meteoalarm / EUMETNET สโลวาเกีย
METEO_ALARM_SI สโลวีเนีย
SB_MET หมู่เกาะโซโลมอน
METEO_ALARM_ES Meteoalarm / EUMETNET Spain
METEO_ALARM_SE สวีเดน
METEO_ALARM_CH สวิตเซอร์แลนด์
TAIWAN_NCDR ไต้หวัน
NOAA NOAA ของสหรัฐอเมริกา
WCATWC ศูนย์เตือนภัยสึนามิแห่งชาติ