publicAlerts 端點提供國家和國際權威機構發布的特定天氣事件警報詳細資料。這些警報會提供重要資訊,
可能挽救生命。
這個端點會傳回指定經緯度的即時天氣警報。支援的天氣事件包括:
- 降水:雨、雪、冰雹、乾旱等
- 極端溫度:寒冷、炎熱、結冰、霜凍、風寒和濕度
- 風暴事件:暴風雪、颶風、龍捲風、熱帶風暴、雷雨等
- 能見度不佳:霧、沙塵暴和吹雪
- 水相關災害:洪水、海嘯、風暴潮、海岸災害等
- 地球物理和地質事件:地震、土石流和火山活動
- 火災事件:野火、火災天氣等
如需支援的天氣事件完整清單,請參閱「天氣事件類型」。
警示不一定會包含本地化說明,具體取決於資料來源提供的內容。由於資料來源限制,資訊會以原始內容的形式提供。如要進一步瞭解天氣警報來源,請參閱「資料來源」。
API 會針對指定的天氣警報傳回下列資訊:
- 與警報相關的天氣事件類型
- 受影響區域的清單,以及定義這些區域地理邊界的座標
- 天氣事件的單句摘要
- 嚴重性、確定性和緊急程度
- 目標對象建議操作說明
- 安全建議
- 快訊的開始和結束時間
- 發布機關的名稱和網站
APIs Explorer 可讓您傳送即時要求,熟悉 API 和 API 選項:
關於天氣警報要求
如要要求天氣警報資訊,請將 HTTP GET 要求傳送至:
https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE
在要求網址參數中,加入地點的經緯度座標。
關於天氣警報的回應
Weather API 會在回應主體中傳回下列欄位:
| 欄位 | 類型 | 說明 | 必填或選填 |
|---|---|---|---|
alertId |
字串 | 快訊 ID。你也可以在資料供應商網站上找到這項資訊。 | 必填 |
alertTitle |
字串 | 警示標題,說明天氣事件。 注意:如果要求中包含語言代碼參數,只有這個字串會翻譯。 |
必填 |
eventType |
列舉 | 與警報相關的天氣事件類型。 如需支援的天氣事件完整清單,請參閱「天氣事件類型」。 |
必填 |
areaName |
字串 | 受警報影響的地理區域名稱,包括所要求的地點。 | 必填 |
polygon |
字串 | 定義快訊封閉維度區域的座標。 | 選用 |
description |
字串 | 以指定語言總結事件說明的簡短詞組 (例如「龍捲風警報」)。 | 選用 |
severity |
列舉 | 快訊的嚴重性等級:
|
選用 |
certainty |
列舉 | 快訊的確定程度:
|
選用 |
urgency |
列舉 | 快訊的緊急程度:
|
選用 |
instruction |
字串 | 目標對象回應動作的操作說明。 | 選用 |
safetyRecommendations |
字串 | 根據公共主管機關法規提供的安全建議。包含頂層指令和子文字,並提供額外資訊。 | 選用 |
timezoneOffset |
字串 | 事件的時區偏移量,格式為 +/-HH:MM。 | 必填 |
startTime |
DateTime | 警示訊息中資訊的生效 Epoch 日期和時間 (世界標準時間)。 | 選用 |
expirationTime |
DateTime | 快訊預計結束的 Epoch 日期和時間 (世界標準時間)。如果事件無限期,則可能為空值,在這種情況下,標題會指出事件「有效」。 | 選用 |
dataSource |
列舉 | 授權詳細資料,包括發布者、名稱和網址。 | 必填 |
regionCode |
列舉 | 所要求地點的區域代碼。 | 選用 |
資料來源
天氣警示端點會傳回下表所列供應商發布的資料。回應主體會根據要求中提供的經緯度座標,顯示適當當地主管機關的資料。
動態饋給中的供應商遵循 Google 災害示警指南。Google 可能隨時更新供應商清單。
歸因
在呈現資料的所有螢幕上,客戶應用程式必須使用 dataSource 欄位,加入原始來源的作者資訊:
"dataSource": {
"publisher": "NOAA",
"name": "National Weather Service",
"authorityUri": "https://www.weather.gov/"
}
出處資訊必須包含資料來源的全名 (如 name 欄位所示),並使用 authorityUri 欄位提供的網址,建立連往資料來源的超連結 (例如「美國國家氣象局」)。
天氣事件類型
支援的天氣事件類型如下:
| 天氣事件類型 | |
|---|---|
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" }
試試看!
APIs Explorer 可讓您提出範例要求,熟悉 API 和 API 選項。
選取頁面右側的 API 圖示 api。
視需要編輯要求參數。
選取「Execute」按鈕。在對話方塊中,選擇要用來提出要求的帳戶。
在 APIs Explorer 面板中,選取全螢幕圖示 fullscreen,展開 APIs Explorer 視窗。