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

参数名 | 含义 | 规则数据 | 是否必填 | 缺省值 |
location | 如果按市区县代码查询,则为市区县代码(全国市区县代码表下载) | string | 是 | / |
| 如果按经纬度查询,则为经纬度数据,经度和纬度用英文逗号分隔 | double[] |
| 参数名 | 类型 | 说明 |
| status | int | 状态码,非0表示没有正常获取到数据 |
| time | String | 请求时间,格式:yyyyMMddHHmmss |
| timeZone | String | 查询地点时区 |
| areaCode | String | 市区县代码信息,传入经纬度时无该字段返回 |
| path | String | 行政区划路径,省、市、区县名称,以英文逗号分隔,传入经纬度时无该字段返回 |
| wp_code | String | 天气现象编码,详见天气现象编码表 |
| wp | String | 天气现象 |
| tem | double | 温度,单位:℃ |
| real_tem | double | 体感温度,单位:℃ |
| tem_1h_max | double | 小时最高温,单位:℃ |
| tem_1h_max_time | String | 小时高温出现时间,格式:yyyyMMddHHmmss |
| tem_24h_chg | double | 24小时变温,单位:℃ |
| tem_24h_desc | String | 24小时变温描述 |
| rh | int | 相对湿度,单位:% |
| dp_tem | double | 露点温度,单位:℃ |
| wd | double | 风向角度数值,单位:° |
| wd_desc | String | 风向描述 |
| ws | double | 风速,单位:m/s |
| ws_desc | String | 风力 |
| gust_speed | double | 阵风,单位:m/s |
| gust_desc | String | 阵风级别 |
| uv_level | int | 紫外线级别,详见紫外线级别表 |
| uv_desc | String | 紫外线描述 |
| vis | int | 能见度,单位:m |
| cloud_cover | double | 云量,单位:% |
| prs | double | 地面气压,单位:hPa |
| prs_24h_chg | double | 过去24小时变压,单位:hPa |
| prs_24h_chg_desc | String | 过去24小时变压描述 |
| prs_3h_chg | double | 过去3小时变压,单位:hPa |
| prs_3h_chg_desc | String | 过去3小时变压描述 |
| pre_1h | double | 过去1小时降水,单位:mm |
| pre_3h | double | 过去3小时累计降水,单位:mm |
| pre_6h | double | 过去6小时累计降水,单位:mm |
| pre_12h | double | 过去12小时累计降水,单位:mm |
| pre_24h | double | 过去24小时累计降水,单位:mm |
| rad | double | 太阳短波辐射,单位: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
}