publicAlerts 端点提供由权威的国家级和国际级机构发布的特定天气事件警报的详细信息。这些提醒可提供至关重要、可能挽救生命的信息。
该端点会返回指定纬度和经度的实时天气警报。支持的天气事件包括：
- 降水：雨、雪、冰雹、干旱等
- 极端温度：寒冷、高温、冰冻、霜冻、风寒效应和湿度
- 风暴事件：暴风雪、飓风、龙卷风、热带风暴、雷暴等
- 能见度障碍：雾、沙尘暴和高吹雪
- 与水相关的灾害：洪水、海啸、风暴潮、沿海灾害等
- 地球物理和地质事件：地震、滑坡和火山活动
- 火灾事件：野火、火灾天气等
如需查看支持的天气事件的完整列表，请参阅天气事件类型。
提醒可能包含本地化说明，也可能不包含，具体取决于数据源中是否有本地化说明。由于数据源限制，信息按原样（原始内容）提供。如需详细了解天气警报来源，请参阅数据源。
该 API 会针对指定的天气预警返回以下信息：
- 与提醒关联的天气事件类型
- 受影响区域的列表，以及用于定义这些区域的地理边界的坐标
- 天气事件的一句话摘要
- 严重程度、确定性和紧急程度级别
- 针对目标受众群体的行动建议说明
- 安全建议
- 提醒的开始时间和结束时间
- 发布机构的名称和网站
借助 API 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
在请求网址参数中添加相应位置的纬度和经度坐标。
关于天气警报回答
天气 API 会在响应正文中返回以下字段：
| 字段 | 类型 | 说明 | 必填或可选 |
|---|---|---|---|
alertId |
字符串 | 提醒 ID。您也可以在数据提供商网站上找到此信息。 | 必需 |
alertTitle |
字符串 | 提醒的标题，用于描述天气事件。 注意：如果请求中包含语言代码参数，则只有此字符串会被翻译。 |
必需 |
eventType |
枚举 | 与提醒相关联的天气事件类型。 如需查看受支持的天气事件的完整列表，请参阅天气事件类型。 |
必需 |
areaName |
字符串 | 受相应提醒影响的地理区域的名称，包括所请求的位置。 | 必需 |
polygon |
字符串 | 用于定义提醒的闭合维度区域的坐标。 | 可选 |
description |
字符串 | 以指定语言总结事件说明的简短词组（例如“龙卷风警报”）。 | 可选 |
severity |
枚举 | 提醒的严重程度：
|
可选 |
certainty |
枚举 | 相应提醒的确定程度：
|
可选 |
urgency |
枚举 | 相应提醒的紧急程度：
|
可选 |
instruction |
字符串 | 针对目标受众群体提供的自适应操作说明的说明。 | 可选 |
safetyRecommendations |
字符串 | 基于公共机构代码的安全建议。包括顶级指令和包含其他信息的副文本。 | 可选 |
timezoneOffset |
字符串 | 相应事件的时区偏移量，采用 +/-HH:MM 格式。 | 必需 |
startTime |
DateTime | 提醒消息中信息的有效纪元日期和时间（世界协调时间）。 | 可选 |
expirationTime |
DateTime | 相应提醒预计结束的 Epoch 日期和时间（世界协调时间）。对于无限期长的活动，此值可能为 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" }
试试看！
借助 API Explorer，您可以发出示例请求，以便熟悉 API 和 API 选项。
选择页面右侧的 API 图标 api。
（可选）修改请求参数。
选择执行按钮。在对话框中，选择您要用于提出请求的账号。
在 APIs Explorer 面板中，选择全屏图标 fullscreen 以展开 APIs Explorer 窗口。