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 日期和时间（世界协调时间 [UTC]）。 | 可选 |
expirationTime |
DateTime | 预计警报结束的 Epoch 日期和时间（世界协调时间 [UTC]）。对于无限期事件，此值可能为 null，在这种情况下，标题将指示事件“有效”。 | 可选 |
dataSource |
枚举 | 授权机构详细信息，包括发布者、名称和网址。 | 必填 |
regionCode |
枚举 | 所请求地点的地区代码。 | 可选 |
数据源
天气警报端点会返回下表中所列提供商发布的数据。根据请求中提供的经纬度坐标，响应正文会显示来自相应地方当局的数据。
Feed 中包含的提供商遵循 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。
（可选）修改请求参数。
选择执行按钮。在对话框中，选择要用于发出请求的账号。
在 APIs Explorer 面板中，选择全屏图标 fullscreen 以展开 APIs Explorer 窗口。