星图云开放平台
格点历史降水量统计
更新时间:2025-08-20 10:34:15
接口说明

本接口提供全国范围的历史降水量统计,指定经纬度位置,统计查询当前时刻,其过去1、3、6、12,24,48、72小时共六个时次累积降水,得到6个总降水量数值。

 

空间范围:中国区(70~140°E,0~60°N)
时间范围:当前时刻为T,可查询过去1小时(T-1),可查询过去3小时(T-3),过去6小时(T-6),过去12小时(T-12),过去24小时(T-24),过去48小时(T-48),过去72小时(T-72)
空间分辨率:5km
数据要素:1小时累计降水量、3小时累积降水量,6小时累积降水量,12小时累积降水量,24小时累积降水量等,48小时累积降水量等,72小时累积降水量等,详见“要素代码”

调用方式

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

服务地址https://api.open.geovisearth.com/pj/v1/weather/grid/realtime/stat/data?location={location}&meteCode={meteCode}&token={token}
请求方式GET 方法
接口鉴权服务密钥授权,您需要 申请 token将 token 作为必填参数拼接在服务地址中一起请求
调用限制服务调用量的限制请点击 这里 查阅
请求参数
参数名含义规则数据是否必填缺省值
location查询的经纬度信息,经度和纬度用英文逗号分隔double[]/
meteCode查询的要素集合,见下表中的要素代码String/

 

meteCode要素代码表

要素代码

要素说明

tp_1h过去1小时累积降水量,单位:mm
tp_3h过去3小时累积降水量,单位:mm
tp_6h过去6小时累积降水量,单位:mm
tp_12h过去12小时累积降水量,单位:mm
tp_24h过去24小时累积降水量,单位:mm
tp_48h过去48小时累积降水量,单位:mm
tp_72h过去72小时累积降水量,单位:mm
返回参数
参数名类型说明
statusint状态码,非0表示没有正常获取到数据
timeString请求时间,格式:yyyyMMddHHmmss(当地时间)
valuedouble数据结果
调用示例

请求示例

https://api.open.geovisearth.com/pj/v1/weather/grid/realtime/stat/data?location=106.11554,41.2451&meteCode=tp_72h&token=您的token

返回示例

{
    "status": 0,
    "version": "v1",
    "date": {
        "time": "20250814184252",
        "timeZone": "Asia/Shanghai"
    },
    "result": {
        "value": 0.0
    }
}