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。您也可以在数据提供方网站上找到此 ID。 | 必需 |
alertTitle |
字符串 | 警报的标题，用于描述天气事件。 注意： 这是在请求中添加语言代码参数时唯一会翻译的字符串。 |
必需 |
eventType |
枚举 | 与提醒相关联的天气事件的类型。 如需查看支持的天气事件的完整列表，请参阅天气事件类型。 |
必需 |
areaName |
字符串 | 受提醒影响的地理区域的名称，其中包括请求的位置。 | 必需 |
polygon |
字符串 | 用于定义提醒的封闭维度区域的坐标。 | 可选 |
description |
字符串 | 简短的短语，用于以指定语言总结事件说明（例如“龙卷风警报”）。 | 可选 |
severity |
枚举 | 提醒的严重程度：
|
可选 |
certainty |
枚举 | 提醒的确定性：
|
可选 |
urgency |
枚举 | 提醒的紧急程度：
|
可选 |
instruction |
字符串 | 针对目标受众的响应措施说明。 | 可选 |
safetyRecommendations |
字符串 | 基于公共机构代码的安全建议。包括顶级指令和包含其他信息的副文本。 | 可选 |
timezoneOffset |
字符串 | 事件的时区偏移量，格式为 +/-HH:MM。 | 必需 |
startTime |
DateTime | 提醒消息中信息的有效纪元日期和时间（世界协调时间）。 | 可选 |
expirationTime |
DateTime | 提醒预计结束的纪元日期和时间（世界协调时间）。对于无限期长的事件，此字段可能为 null，在这种情况下，标题将表明事件“正在生效”。 | 可选 |
dataSource |
枚举 | 机构详细信息，包括发布商、名称和网址。 | 必需 |
regionCode |
枚举 | 已请求的位置的区域代码。 | 可选 |
数据源
天气提醒端点会返回下表中列出的提供方发布的数据。根据请求中提供的纬度和经度坐标，响应正文会显示相应当地机构的数据。
Feed 中包含的提供方遵循 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 。
您可以选择修改请求参数。
选择执行 按钮。在对话框中，选择您要用于发出请求的账号 。
在 APIs Explorer 面板中，选择全屏图标 fullscreen 以展开 APIs Explorer 窗口。