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

全国空气质量实况图层

更新时间：2025-08-07 19:05:19

接口说明

本接口提供全国空气质量实况可视化图层，可以实现全国空气质量状况在地图界面的直观展现，包含已配色图层和中间体图层，支持您进行自定义前端配色。

空间范围：全国陆地范围

空间分辨率：12.5km

时间范围：最多支持过去240小时

更新频次：逐小时

数据要素：AQI

数据格式：png、json

配色方案：标准配色以及支持定制化配色

使用方式：通过API获取图层文件，并与地图叠加，最终可实现拖拽、放大缩小等诸多功能。您既可以展示静态的单张图片，亦可连续播放形成动态展示。

调用方式

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

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

请求参数

参数名	含义	规则数据	是否必填	缺省值
productCode	产品类型，见产品类型代码表	string	是	/
start	查询开始时间（yyyyMMddHH）	string	是	/
end	查询结束时间（yyyyMMddHH）	string	是	/

productCode产品类型代码表

代码	说明	使用说明
sev	3857可视化产品（返回png红黑图及json文件）	红黑图配合json文件可求解出各像素点气象要素值，详见下方红黑图使用说明或咨询技术支持
sevg	4326可视化产品（返回png红黑图及json文件）	红黑图配合json文件可求解出各像素点气象要素值，详见下方红黑图使用说明或咨询技术支持
mfv	墨卡托投影整图产品（返回png彩图及json文件）	彩图可直接叠加地图进行显示（配色方案下载）

返回参数

参数名	类型	说明
status	int	状态码，非0表示没有正常获取到数据
dataCode	String	数据编码
productCode	String	产品类型编码
meteCode	String	要素编码
timeRange	String[]	请求的数据时间范围，格式： ”yyyyMMddHH”, ”yyyyMMddHH”
urls	Object	时间序列对应的文件，每个时次包括一个webp/png文件和一个json文件

json文件参数说明

参数名	说明
min	气象要素最小值
max	气象要素最大值
width	图片宽度
height	图片高度
lonmin	图片经度最小值
latmin	图片纬度最小值
lonmax	图片经度最大值
latmax	图片纬度最大值

红黑图使用说明

本接口sev、sevg产品以红黑图形式提供，其优点是数据量小，传输速度快、存储量低。png图片中的R通道值与气象要素值存在线性映射关系，利用气象要素的最大值和最小值，将气象要素的真值映射到通道值的0~255，气象要素的最小值和最大值可从对应的json文件中读取。
要将红黑图像素点的通道值换算为气象要素值，公式如下：
气象要素值=min+R通道值/255*(max-min)

调用示例

请求示例

https://api.open.geovisearth.com/v2/cn/bd/rt?productCode=mfv&start=2024112805&end=2024112816&token=用户的token

返回示例

{
  "date": {
    "timeZone": "Asia/Shanghai",
    "time": "20250708163642"
  },
  "result": {
    "meteCode": "aqi",
    "urls": {
      "2025070816": [
        "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/aqi_cn_bd_rt/202507/0816/aqi_00e61282124e9ef42edc.png",
        "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/aqi_cn_bd_rt/202507/0816/aqi_00e61282124e9ef42edc.json"
      ]
    },
    "productCode": "mfv",
    "dataCode": "aqi_cn_bd_rt",
    "timeRange": [
      "2025070816",
      "2025070818"
    ]
  },
  "version": "v1",
  "status": 0
}