星图云开放平台
全国城市24小时逐小时预报
更新时间:2026-01-27 16:23:43
接口说明

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

示例
调用方式

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

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

参数名

含义

规则数据

是否必填

缺省值

location

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

string

/

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

double[]

返回参数
参数名类型说明
statusint状态码,非0表示没有正常获取到数据
timeString请求时间,格式:yyyyMMddHHmmss(查询地点当地时间)
areaCodeString市区县代码信息,传入经纬度时无该字段返回
pathString行政区划路径,省、市、区县名称,以英文逗号分隔,传入经纬度时无该字段返回
locationObject大区信息,传入经纬度时无该字段返回
startString数据开始时间,格式:yyyyMMddHH
endString数据结束时间,格式:yyyyMMddHH
sizeString数据长度(预报小时数)
fc_timeString预报时间,格式:yyyyMMddHH
wp_codeString天气现象编码,详见天气现象编码表
wpString天气现象
temdouble温度,单位:℃
real_temdouble体感温度,单位:℃
dp_temdouble露点温度,单位:℃
wsdouble风速,单位:m/s
ws_descString风力级别
wddouble风向角度,单位:°
wd_descString风向描述
rhint相对湿度,单位:%
prsint地面气压,单位:hPa
visint能见度,单位:m
cloud_coverint云量,单位:%
predouble1小时降水量,单位: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
}