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 欄位提供的網址超連結至資料來源 (例如「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" }
試試看！
您可以使用 APIs Explorer 提出範例要求，熟悉 API 和 API 選項。
選取頁面右側的 API 圖示 api。
視需要編輯要求參數。
選取「Execute」按鈕。在對話方塊中，選擇要用來提出要求的帳戶。
在 APIs Explorer 面板中，選取全螢幕圖示 fullscreen 即可展開 APIs Explorer 視窗。