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

全国精细化网格实况

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

接口说明

本接口提供全国范围的高时空分辨率格点实况产品，满足各类气象敏感行业的专业化、个性化需求。利用多源观测资料，使用前沿的多模态融合技术，生成更加精准、智能的分钟级格点实况产品，助力用户实现精准感知天气、高效决策判断。本接口提供全国任意经纬度的1小时前至当前时刻的逐10分钟实况天气数据，要素包括天气现象、温度、10min降水量、1小时累计降水量、降水类型、能见度、相对湿度、总云量、气压、风速、风向等，适宜各类气象敏感行业专业化需求。
空间范围：中国区（70~140°E，0~60°N）
时间范围：查询时间前24小时至当前时刻
时间分辨率：10min
空间分辨率：1km
更新频次：10min
数据要素：天气现象、温度、10min降水量、1小时累计降水量、降水类型、能见度、相对湿度、总云量、气压、风速、风向等，详见“要素代码”

调用方式

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

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

请求参数

参数名	是否必填	类型	说明	示例
location	是	double[]	查询的经纬度信息，经度和纬度用英文逗号分隔	116.9,40.5
meteCodes	是	String[]	查询的要素集合，见下表中的要素代码，要素代码以英文逗号分隔	icon,tmp,tp

meteCodes要素代码表

要素代码	要素说明
icon	天气现象ID
tmp	温度（℃）
tp	10min降水量（mm）
tp_1h	1小时累计降水量（mm）
tp_type	降水类型（0-非降水；1-降水；2-雪；3-雨夹雪）
vis	能见度（m）
rh	相对湿度(%)
tcdc	总云量（%）
pres	地面气压（hPa）
ws	风速（m/s）
wd	风向（°）

返回参数

参数名	数据类型	说明	异常值
status	int	状态码，非0表示没有正常获取到数据	无
time	String	请求时间，格式：yyyyMMddHHmmss	无
start	String	查询开始时间	-
end	String	查询结束时间	-
size	int	返回的数据时次数	-
meteCodes	String[]	查询的要素集合	-
datas	Object[]	数据集合	-
data_time	String	数据时间，格式：yyyy-MM-dd HH:mm:ss	-
values	double[]	数据结果集合，顺序和meteCodes请求内容对应	-

调用示例

请求示例

https://api.open.geovisearth.com/v2/precision_grid/real/live?location=116.4,40&meteCodes=ws,wd,icon,tmp,tp&token=用户的token

返回示例

{
  "date": {
    "timeZone": "Asia/Shanghai",
    "time": "20250313105333"
  },
  "result": {
    "size": 7,
    "datas": [
      {
        "data_time": "2025-03-13 09:40:00",
        "values": [1.198, 43.404, 0, 10.102, 0]
      },
      {
        "data_time": "2025-03-13 09:50:00",
        "values": [1.691, 65.883, 0, 10.427, 0]
      },
      {
        "data_time": "2025-03-13 10:00:00",
        "values": [1.841, 51.93, 0, 10.755, 0]
      },
      {
        "data_time": "2025-03-13 10:10:00",
        "values": [2.067, 49.731, 0, 11.13, 0]
      },
      {
        "data_time": "2025-03-13 10:20:00",
        "values": [1.331, 44.106, 0, 11.314, 0]
      },
      {
        "data_time": "2025-03-13 10:30:00",
        "values": [1.618, 88.486, 0, 11.52, 0]
      },
      {
        "data_time": "2025-03-13 10:40:00",
        "values": [1.98, 89.086, 0, 11.829, 0]
      }
    ],
    "meteCodes": [
      "ws",
      "wd",
      "icon",
      "tmp",
      "tp"
    ],
    "start": "2025-03-13 09:40:00",
    "end": "2025-03-13 10:40:00"
  },
  "version": "v1",
  "status": 0
}