
本接口提供国内3300+市区县的逐小时预报产品,具有更新频率高、预报时效长的特点,要素涵盖天气现象、体感温度、降水量、能见度等与日常生活生产密切相关的气象要素。基础版、进阶版、专业版三种版本可选,预报时效最高可达120小时,满足各类需求。
空间范围:国内3300+市区县
预报时效:查询时间起24小时
时间分辨率:1小时
更新频次:7次/天
数据要素:天气现象、温度、体感温度、露点温度、风向、风速、能见度、云量、气压、降水量等,详见“响应参数说明”

参数名 | 含义 | 规则数据 | 是否必填 | 缺省值 |
location | 如果按市区县代码查询,则为市区县代码(全国市区县代码表下载) | string | 是 | / |
| 如果按经纬度查询,则为经纬度数据,经度和纬度用英文逗号分隔 | double[] |
| 参数名 | 类型 | 说明 |
| status | int | 状态码,非0表示没有正常获取到数据 |
| time | String | 请求时间,格式:yyyyMMddHHmmss(查询地点当地时间) |
| areaCode | String | 市区县代码信息,传入经纬度时无该字段返回 |
| path | String | 行政区划路径,省、市、区县名称,以英文逗号分隔,传入经纬度时无该字段返回 |
| location | Object | 大区信息,传入经纬度时无该字段返回 |
| start | String | 数据开始时间,格式:yyyyMMddHH |
| end | String | 数据结束时间,格式:yyyyMMddHH |
| size | String | 数据长度(预报小时数) |
| fc_time | String | 预报时间,格式:yyyyMMddHH |
| wp_code | String | 天气现象编码,详见天气现象编码表 |
| wp | String | 天气现象 |
| tem | double | 温度,单位:℃ |
| real_tem | double | 体感温度,单位:℃ |
| dp_tem | double | 露点温度,单位:℃ |
| ws | double | 风速,单位:m/s |
| ws_desc | String | 风力级别 |
| wd | double | 风向角度,单位:° |
| wd_desc | String | 风向描述 |
| rh | int | 相对湿度,单位:% |
| prs | int | 地面气压,单位:hPa |
| vis | int | 能见度,单位:m |
| cloud_cover | int | 云量,单位:% |
| pre | double | 1小时降水量,单位:mm |
请求示例
https://api.open.geovisearth.com/v2/cn/hourly/basic?location=WTX_CH101280702&token=您的token返回示例
{
"date": {
"timeZone": "Asia/Shanghai",
"time": "20240911133842"
},
"result": {
"size": 24,
"datas": [
{
"vis": 26276,
"pre": 0.0,
"wd": 72.0,
"wd_desc": "东风",
"prs": 1004.0,
"dp_tem": 25.0,
"fc_time": "2024091113",
"rh": 66,
"ws_desc": "2级",
"cloud_cover": 10,
"wp": "晴",
"real_tem": 36.0,
"ws": 2.5,
"tem": 32.0,
"wp_code": "00"
},
{
"vis": 31027,
"pre": 0.0,
"wd": 84.0,
"wd_desc": "东风",
"prs": 1003.0,
"dp_tem": 25.0,
"fc_time": "2024091114",
"rh": 64,
"ws_desc": "2级",
"cloud_cover": 10,
"wp": "晴",
"real_tem": 36.0,
"ws": 2.8,
"tem": 32.0,
"wp_code": "00"
},
{
"vis": 27432,
"pre": 0.0,
"wd": 113.0,
"wd_desc": "东南风",
"prs": 1002.0,
"dp_tem": 24.0,
"fc_time": "2024091115",
"rh": 65,
"ws_desc": "2级",
"cloud_cover": 10,
"wp": "晴",
"real_tem": 35.0,
"ws": 3.1,
"tem": 32.0,
"wp_code": "00"
},
{
"vis": 23837,
"pre": 0.0,
"wd": 155.0,
"wd_desc": "东南风",
"prs": 1002.0,
"dp_tem": 24.0,
"fc_time": "2024091116",
"rh": 66,
"ws_desc": "2级",
"cloud_cover": 10,
"wp": "晴",
"real_tem": 34.0,
"ws": 3.3,
"tem": 31.0,
"wp_code": "00"
},
{
"vis": 20242,
"pre": 0.0,
"wd": 177.0,
"wd_desc": "南风",
"prs": 1002.0,
"dp_tem": 24.0,
"fc_time": "2024091117",
"rh": 67,
"ws_desc": "2级",
"cloud_cover": 10,
"wp": "晴",
"real_tem": 34.0,
"ws": 3.3,
"tem": 30.0,
"wp_code": "00"
},
{
"vis": 16515,
"pre": 0.0,
"wd": 179.0,
"wd_desc": "南风",
"prs": 1002.0,
"dp_tem": 24.0,
"fc_time": "2024091118",
"rh": 70,
"ws_desc": "2级",
"cloud_cover": 10,
"wp": "晴",
"real_tem": 34.0,
"ws": 3.1,
"tem": 30.0,
"wp_code": "00"
},
{
"vis": 12788,
"pre": 0.0,
"wd": 176.0,
"wd_desc": "南风",
"prs": 1003.0,
"dp_tem": 25.0,
"fc_time": "2024091119",
"rh": 73,
"ws_desc": "2级",
"cloud_cover": 10,
"wp": "晴",
"real_tem": 34.0,
"ws": 2.9,
"tem": 30.0,
"wp_code": "00"
},
{
"vis": 9062,
"pre": 0.0,
"wd": 177.0,
"wd_desc": "南风",
"prs": 1003.0,
"dp_tem": 25.0,
"fc_time": "2024091120",
"rh": 76,
"ws_desc": "2级",
"cloud_cover": 10,
"wp": "晴",
"real_tem": 34.0,
"ws": 2.8,
"tem": 30.0,
"wp_code": "00"
},
{
"vis": 8328,
"pre": 0.0,
"wd": 193.0,
"wd_desc": "南风",
"prs": 1004.0,
"dp_tem": 25.0,
"fc_time": "2024091121",
"rh": 78,
"ws_desc": "2级",
"cloud_cover": 9,
"wp": "晴",
"real_tem": 33.0,
"ws": 2.9,
"tem": 29.0,
"wp_code": "00"
},
{
"vis": 7595,
"pre": 0.0,
"wd": 217.0,
"wd_desc": "西南风",
"prs": 1004.0,
"dp_tem": 25.0,
"fc_time": "2024091122",
"rh": 79,
"ws_desc": "2级",
"cloud_cover": 9,
"wp": "晴",
"real_tem": 32.0,
"ws": 3.1,
"tem": 29.0,
"wp_code": "00"
},
{
"vis": 6861,
"pre": 0.0,
"wd": 230.0,
"wd_desc": "西南风",
"prs": 1004.0,
"dp_tem": 25.0,
"fc_time": "2024091123",
"rh": 80,
"ws_desc": "2级",
"cloud_cover": 10,
"wp": "晴",
"real_tem": 32.0,
"ws": 3.3,
"tem": 28.0,
"wp_code": "00"
},
{
"vis": 5500,
"pre": 0.0,
"wd": 230.0,
"wd_desc": "西南风",
"prs": 1004.0,
"dp_tem": 25.0,
"fc_time": "2024091200",
"rh": 82,
"ws_desc": "2级",
"cloud_cover": 10,
"wp": "晴",
"real_tem": 32.0,
"ws": 3.3,
"tem": 28.0,
"wp_code": "00"
},
{
"vis": 4139,
"pre": 0.0,
"wd": 224.0,
"wd_desc": "西南风",
"prs": 1004.0,
"dp_tem": 25.0,
"fc_time": "2024091201",
"rh": 84,
"ws_desc": "2级",
"cloud_cover": 11,
"wp": "晴",
"real_tem": 32.0,
"ws": 3.1,
"tem": 28.0,
"wp_code": "00"
},
{
"vis": 2778,
"pre": 0.0,
"wd": 222.0,
"wd_desc": "西南风",
"prs": 1004.0,
"dp_tem": 26.0,
"fc_time": "2024091202",
"rh": 87,
"ws_desc": "2级",
"cloud_cover": 10,
"wp": "晴",
"real_tem": 32.0,
"ws": 2.9,
"tem": 28.0,
"wp_code": "00"
},
{
"vis": 2846,
"pre": 0.0,
"wd": 230.0,
"wd_desc": "西南风",
"prs": 1003.0,
"dp_tem": 25.0,
"fc_time": "2024091203",
"rh": 87,
"ws_desc": "2级",
"cloud_cover": 7,
"wp": "晴",
"real_tem": 32.0,
"ws": 2.8,
"tem": 28.0,
"wp_code": "00"
},
{
"vis": 2914,
"pre": 0.0,
"wd": 246.0,
"wd_desc": "西南风",
"prs": 1003.0,
"dp_tem": 25.0,
"fc_time": "2024091204",
"rh": 87,
"ws_desc": "2级",
"cloud_cover": 6,
"wp": "晴",
"real_tem": 31.0,
"ws": 2.8,
"tem": 27.0,
"wp_code": "00"
},
{
"vis": 2982,
"pre": 0.0,
"wd": 264.0,
"wd_desc": "西风",
"prs": 1003.0,
"dp_tem": 25.0,
"fc_time": "2024091205",
"rh": 87,
"ws_desc": "2级",
"cloud_cover": 10,
"wp": "晴",
"real_tem": 31.0,
"ws": 2.8,
"tem": 27.0,
"wp_code": "00"
},
{
"vis": 3862,
"pre": 0.0,
"wd": 281.0,
"wd_desc": "西风",
"prs": 1004.0,
"dp_tem": 25.0,
"fc_time": "2024091206",
"rh": 86,
"ws_desc": "2级",
"cloud_cover": 19,
"wp": "晴",
"real_tem": 31.0,
"ws": 2.8,
"tem": 27.0,
"wp_code": "00"
},
{
"vis": 4741,
"pre": 0.0,
"wd": 297.0,
"wd_desc": "西北风",
"prs": 1004.0,
"dp_tem": 25.0,
"fc_time": "2024091207",
"rh": 85,
"ws_desc": "2级",
"cloud_cover": 29,
"wp": "多云",
"real_tem": 31.0,
"ws": 2.8,
"tem": 27.0,
"wp_code": "01"
},
{
"vis": 5621,
"pre": 0.0,
"wd": 307.0,
"wd_desc": "西北风",
"prs": 1004.0,
"dp_tem": 25.0,
"fc_time": "2024091208",
"rh": 83,
"ws_desc": "2级",
"cloud_cover": 34,
"wp": "多云",
"real_tem": 32.0,
"ws": 2.8,
"tem": 28.0,
"wp_code": "01"
},
{
"vis": 8615,
"pre": 0.0,
"wd": 311.0,
"wd_desc": "西北风",
"prs": 1005.0,
"dp_tem": 25.0,
"fc_time": "2024091209",
"rh": 79,
"ws_desc": "2级",
"cloud_cover": 29,
"wp": "多云",
"real_tem": 33.0,
"ws": 2.7,
"tem": 29.0,
"wp_code": "01"
},
{
"vis": 11608,
"pre": 0.0,
"wd": 310.0,
"wd_desc": "西北风",
"prs": 1005.0,
"dp_tem": 25.0,
"fc_time": "2024091210",
"rh": 75,
"ws_desc": "2级",
"cloud_cover": 19,
"wp": "晴",
"real_tem": 35.0,
"ws": 2.5,
"tem": 30.0,
"wp_code": "00"
},
{
"vis": 14602,
"pre": 0.0,
"wd": 312.0,
"wd_desc": "西北风",
"prs": 1005.0,
"dp_tem": 26.0,
"fc_time": "2024091211",
"rh": 72,
"ws_desc": "2级",
"cloud_cover": 10,
"wp": "晴",
"real_tem": 36.0,
"ws": 2.4,
"tem": 32.0,
"wp_code": "00"
},
{
"vis": 15737,
"pre": 0.0,
"wd": 320.0,
"wd_desc": "西北风",
"prs": 1004.0,
"dp_tem": 26.0,
"fc_time": "2024091212",
"rh": 72,
"ws_desc": "2级",
"cloud_cover": 7,
"wp": "晴",
"real_tem": 37.0,
"ws": 2.3,
"tem": 32.0,
"wp_code": "00"
}
],
"start": "2024091113",
"end": "2024091212"
},
"location": {
"path": "广东省,珠海市,斗门",
"areaCode": "WTX_CH101280702"
},
"version": "v1",
"status": 0
}