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

全国天气实况（6要素）

更新时间：2025-06-12 10:18:07

接口说明

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

调用方式

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

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

请求参数

参数名	含义	规则数据	是否必填	缺省值
location	如果按市区县代码查询，则为市区县代码（全国市区县代码表下载）	string	是	/
location	如果按经纬度查询，则为经纬度数据，经度和纬度用英文逗号分隔	double[]	是	/

返回参数

参数名	类型	说明
status	int	状态码，非0表示没有正常获取到数据
time	String	请求时间，格式：yyyyMMddHHmmss
timeZone	String	查询地点时区
areaCode	String	市区县代码信息，传入经纬度时无该字段返回
path	String	行政区划路径，省、市、区县名称，以英文逗号分隔，传入经纬度时无该字段返回
wp_code	String	天气现象编码，详见天气现象编码表
wp	String	天气现象
tem	double	温度，单位：℃
rh	int	相对湿度，单位：%
wd_desc	String	风向描述
ws_desc	String	风力
prs	double	地面气压，单位：hPa

调用示例

请求示例

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

返回示例

{
    "date": {
        "timeZone": "Asia/Shanghai",
        "time": "20240911135031"
    },
    "result": {
        "wd_desc": "东北风",
        "prs": 986.7,
        "rh": 95,
        "ws_desc": "3级",
        "wp": "阴",
        "tem": 26.7,
        "wp_code": "02"
    },
    "location": {
        "path": "广西壮族自治区,崇左市,崇左",
        "areaCode": "WTX_CH101300201"
    },
    "version": "v1",
    "status": 0
}