星图云开放平台-以卫星遥感为核心的空天信息服务开放平台

全国天气预警

更新时间：2026-01-04 11:16:31

接口说明

获取指定城市生效中的各类天气预警信号，如寒潮、高温、暴雨等。本天气预警产品，为气象部门针对各类气象高影响天气第一时间发布的预警信号，是天气产品中非常重要的组成部分。
天气预警产品是您在面对自然灾害和恶劣天气时的得力助手。不论是突如其来的暴雨、狂风，还是不可预测的火灾风险，我们的预警系统将为您提供及时准确的信息，帮助您做出明智的决策，保护好自己和您身边的人。
空间范围：中国
更新时间：实时更新
数据要素：区域预警条数、预警发布单位、预警类型、预警等级、生效时间、失效时间、具体预警信息文本等要素。

调用方式

使用 API 前，需要先注册账号并完成用户认证，查看开发指南

服务地址	https://api.open.geovisearth.com/v2/cn/weather/alert
请求方式	GET 方法
接口鉴权	服务密钥授权，您需要申请 token，将 token 作为必填参数拼接在服务地址中一起请求
调用限制	服务调用量的限制请点击这里查阅

请求参数

参数名	含义	规则数据	是否必填	缺省值
location	国内市区县代码（全国市区县代码表下载）	string	是	/

返回参数

参数名	类型	说明
status	int	状态码，非0表示没有正常获取到数据
time	String	请求时间，格式：yyyyMMddHHmmss
areaCode	String	市区县代码信息
path	String	行政区划路径，省、市、区县名称，以英文逗号分隔
dataSize	int	预警数据长度（预警数量）
alerts	double[]	预警数据集合
geoCode	String	预警地区邮政编码
sender	String	预警发布机构
typeCode	String	预警类型编码，见预警编码表
type	String	预警类型
levelCode	String	预警级别编码，见预警编码表
level	String	预警级别说明
effective	String	预警生效时间，格式为yyyy-MM-dd HH:mm:ss
expires	String	预警失效时间，格式为yyyy-MM-dd HH:mm:ss
title	String	标题信息
detail	String	预警内容信息

调用示例

请求示例

https://api.open.geovisearth.com/v2/cn/weather/alert?location=WTX_CH101280800&token=您的token

返回示例

{
    "date": {
        "timeZone": "Asia/Shanghai",
        "time": "20240911132036"
    },
    "result": {
        "alerts": [
            {
                "levelCode": "Yellow",
                "effective": "2024-09-11 10:01:00",
                "expires": "2024-09-14 10:01:00",
                "sender": "佛山市气象台",
                "level": "黄色预警",
                "geoCode": "440600",
                "detail": "【禅城区高温黄色预警信号发布】佛山市气象台09月11日10时01分发布：预计未来三天最高气温将达到35℃左右，禅城区高温黄色预警信号生效。禅城区应急管理局、佛山市气象局禅城工作组提醒您，请注意防暑降温。",
                "type": "高温",
                "title": "佛山市气象台发布高温黄色预警[III级/较重]",
                "typeCode": "11B09"
            }
        ],
        "dataSize": 1,
        "dataCode": "alert"
    },
    "location": {
        "path": "广东省,佛山市,佛山",
        "areaCode": "WTX_CH101280800"
    },
    "version": "v1",
    "status": 0
}