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

全国天气预警

更新时间：2025-08-07 19:05:19

接口说明

本接口内容响应“预警出参要求”，支持全国任意经纬度或区县编码查询，返回当地未生效中的预警信息，可按拼多多需求支持不传经纬度或区县编码时返回全国生效中预警，数据要素包括预警时间范围、预警类型、预警等级、预警信息概述、预警信息完整描述、预警发布时间、三级地区code。

调用方式

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

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

请求参数

参数名	是否必填	类型	说明	示例
location	是	double[]	如果按经纬度查询，则为经纬度数据，经度和纬度用英文逗号分隔；不传递参数location时，返回全国所有生效中预警信息。	121.29,31.14

返回参数

参数名	类型	说明
status	int	状态码，非0表示没有正常获取到数据
date	Object[]	时间描述信息
time	String	请求时间，格式：yyyyMMddHHmmss
timeZone	String	查询地点时区
timeZoneName	String	查询地点时区名称：UTC+8
location	Object[]	地理描述信息
areaCode	String	市区县代码信息
path	String	行政区划路径，省、市、区县名称，以英文逗号分隔
city	String	城市名称
country	String	国家名称，例：CN
dataSize	int	预警数据长度（预警数量）
alerts	Object[]	预警信息集合
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/pj/v1/weather/alert/pdd/now?location=121.29,31.14&token=您的token

返回示例

{
    "status": 0,
    "version": "v1",
    "date": {
        "time": "20250512174910",
        "timeZone": "Asia/Shanghai",
        "timeZoneName": "UTC+8"
    },
    "location": {
        "areaCode": "WTX_CH101250106",
        "country": "CN",
        "city": "长沙市",
        "path": "湖南省,长沙市,长沙县"
    },
    "result": {
        "dataCode": "alert",
        "dataSize": 1,
        "alerts": [
            {
                "geoCode": "430382",
                "sender": "韶山市气象局",
                "typeCode": "11B09",
                "type": "高温",
                "levelCode": "Yellow",
                "level": "黄色预警",
                "effective": "2024-08-31 09:02:00",
                "expires": "2024-08-31 18:00:00",
                "title": "韶山市气象局发布高温黄色预警[Ⅲ级/较重]",
                "detail": "韶山市气象台2024年8月31日9时2分发布高温黄色预警信号：今天白天韶山市最高气温将升至35℃以上，请注意防范。"
            }
        ]
    }
}