星图云开放平台
全国天气实况(30要素)
更新时间:2026-02-03 11:33:52
接口说明

天气实况,是天气服务中最基础最核心的产品之一,往往占据天气类产品的重要位置。维天信气象研究院通过对多源异构数据的处理加工,含站点观测数据、卫星数据、雷达数据、数字高程模型、空气质量数据等,结合人工智能、图像识别等技术,得以还原所在地的真实天气实况。
该接口可获取中国3300+市区县的分钟级天气实况,包含天气现象、实时温度、体感温度、风力风向、相对湿度、海平面气压、降水量(多时间维度统计)、能见度、露点温度、云量、太阳辐射等诸多要素。共分为基础版、进阶版、专业版三个版本,内容丰富度不断提升,客户可以根据实际需求,选择对应版本。
空间范围:国内3300+市区县
更新频次:5分钟
调取方式:城市ID/任意经纬度
数据要素:天气现象、温度、体感温度、小时最高温、小时高温出现时间、24小时变温、24小时变温描述、相对湿度、露点温度、风向角度数值、风向描述、风速、风力、阵风、阵风级别、紫外线级别、紫外线描述、能见度、云量、地面气压、过去24小时变压、过去24小时变压描述、过去3小时变压、过去3小时变压描述、过去1小时降水、过去3小时累计降水、过去6小时累计降水、过去12小时累计降水、过去24小时累计降水、太阳短波辐射(根据订阅版本要素数量不同,最多达30余种,各版本详细要素见“响应参数说明”)

示例
调用方式

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

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

参数名

含义

规则数据

是否必填

缺省值

location

如果按市区县代码查询,则为市区县代码(全国市区县代码表下载

string

/

如果按经纬度查询,则为经纬度数据,经度和纬度用英文逗号分隔

double[]

返回参数
参数名类型说明
statusint状态码,非0表示没有正常获取到数据
timeString请求时间,格式:yyyyMMddHHmmss
timeZoneString查询地点时区
areaCodeString市区县代码信息,传入经纬度时无该字段返回
pathString行政区划路径,省、市、区县名称,以英文逗号分隔,传入经纬度时无该字段返回
wp_codeString天气现象编码,详见天气现象编码表
wpString天气现象
temdouble温度,单位:℃
real_temdouble体感温度,单位:℃
tem_1h_maxdouble小时最高温,单位:℃
tem_1h_max_timeString小时高温出现时间,格式:yyyyMMddHHmmss
tem_24h_chgdouble24小时变温,单位:℃
tem_24h_descString24小时变温描述
rhint相对湿度,单位:%
dp_temdouble露点温度,单位:℃
wddouble风向角度数值,单位:°
wd_descString风向描述
wsdouble风速,单位:m/s
ws_descString风力
gust_speeddouble阵风,单位:m/s
gust_descString阵风级别
uv_levelint紫外线级别,详见紫外线级别表
uv_descString紫外线描述
visint能见度,单位:m
cloud_coverdouble云量,单位:%
prsdouble地面气压,单位:hPa
prs_24h_chgdouble过去24小时变压,单位:hPa
prs_24h_chg_descString过去24小时变压描述
prs_3h_chgdouble过去3小时变压,单位:hPa
prs_3h_chg_descString过去3小时变压描述
pre_1hdouble过去1小时降水,单位:mm
pre_3hdouble过去3小时累计降水,单位:mm
pre_6hdouble过去6小时累计降水,单位:mm
pre_12hdouble过去12小时累计降水,单位:mm
pre_24hdouble过去24小时累计降水,单位:mm
raddouble太阳短波辐射,单位:W/㎡
调用示例

请求示例

https://api.open.geovisearth.com/v2/cn/area/professional?token=您的token&location=WTX_CH101300201

返回示例

{
    "date": {
        "timeZone": "Asia/Shanghai",
        "time": "20240911134935"
    },
    "result": {
        "tem_24h_chg": -0.2,
        "tem_24h_desc": "Steady",
        "wd": 48.0,
        "wd_desc": "东北风",
        "uv_desc": "不需采取防护措施",
        "dp_tem": 25.8,
        "prs_24h_chg": 2.6,
        "rad": 436.2,
        "cloud_cover": 100,
        "wp": "阴",
        "prs_3h_chg": -2.1,
        "pre_6h": 0.0,
        "ws": 4.4,
        "tem": 26.7,
        "wp_code": "02",
        "uv_level": 1,
        "vis": 23756,
        "tem_1h_max": 27.2,
        "gust_speed": 5.9,
        "pre_3h": 0.0,
        "prs_24h_chg_desc": "Rising",
        "pre_1h": 0.0,
        "prs": 986.7,
        "prs_3h_chg_desc": "Falling",
        "rh": 95,
        "pre_12h": 0.0,
        "pre_24h": 28.5,
        "ws_desc": "3级",
        "tem_1h_max_time": "20240911131000",
        "real_tem": 27.2,
        "gust_desc": "4级"
    },
    "location": {
        "path": "广西壮族自治区,崇左市,崇左",
        "areaCode": "WTX_CH101300201"
    },
    "version": "v1",
    "status": 0
}