星图云开放平台
瓦片图层可视化接口
更新时间:2025-08-07 19:05:19
接口说明

本气象可视化瓦片服务是一款基于高精度气象数据的动态可视化解决方案,支持多维度气象要素的实时渲染与分层展示。通过标准化瓦片地图服务接口,可无缝集成至各类数字平台(如智慧城市、交通调度、航空航海、灾害预警等系统),为用户提供直观、高效的气象决策支持。

根据传入的数据编码和要素编码获取未来48小时的瓦片信息,接口返回的连接替换掉x,y,z,即可获取响应的瓦片。其中z为层级、xx轴瓦片编号、yy轴瓦片编码。

调用方式

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

服务地址https://api.open.geovisearth.com/v2/view/tiles/index
请求方式GET 方法
接口鉴权服务密钥授权,您需要 申请 token将 token 作为必填参数拼接在服务地址中一起请求
调用限制服务调用量的限制请点击 这里 查阅
请求参数
参数类型说明必选缺省值
dataCodestring数据类型,见数据类型代码表/
meteCodestring要素类型(详情见下)/
dataCode说明
gfs美国GFS数据
metaCode说明
cp对流性降水(mm)
vis能见度(m)
wind10风速(m/s)
pre_1h逐小时降水量(mm)
返回参数
参数名规则说明含义

status

int

状态码,非0表示没有正常获取到数据

meteCode

String

要素编码

fcTimes

String[]

预报数据时间,格式:yyyyMMddHH

urls

String[]

各时次瓦片对应的请求地址,请求时替换

调用示例

请求示例

https://api.open.geovisearth.com/v2/view/tiles/index?dataCode=gfs&meteCode=cp&token=您的token

返回示例

{
    "status": 0,
    "version": "v2",
    "date": {
        "time": "20250425174515",
        "timeZone": "Asia/Shanghai"
    },
    "result": {
        "meteCode": "wind10",
        "fcTimes": [
            "202504251800",
            "202504251900",
            "202504252000",
            "202504252100",
            "202504252200",
            "202504252300",
            "202504260000",
            "202504260100",
            "202504260200",
            "202504260300",
            "202504260400",
            "202504260500",
            "202504260600",
            "202504260700",
            "202504260800",
            "202504260900",
            "202504261000",
            "202504261100",
            "202504261200",
            "202504261300",
            "202504261400",
            "202504261500",
            "202504261600",
            "202504261700",
            "202504261800",
            "202504261900",
            "202504262000",
            "202504262100",
            "202504262200",
            "202504262300",
            "202504270000",
            "202504270100",
            "202504270200",
            "202504270300",
            "202504270400",
            "202504270500",
            "202504270600",
            "202504270700",
            "202504270800",
            "202504270900",
            "202504271000",
            "202504271100",
            "202504271200",
            "202504271300",
            "202504271400",
            "202504271500",
            "202504271600",
            "202504271700"
        ],
        "urls": [
            "https://wapi.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745575200000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745578800000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745582400000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745586000000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745589600000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745593200000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745596800000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745600400000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745604000000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745607600000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745611200000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745614800000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745618400000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745622000000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745625600000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745629200000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745632800000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745636400000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745640000000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745643600000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745647200000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745650800000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745654400000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745658000000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745661600000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745665200000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745668800000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745672400000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745676000000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745679600000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745683200000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745686800000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745690400000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745694000000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745697600000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745701200000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745704800000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745708400000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745712000000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745715600000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745719200000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745722800000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745726400000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745730000000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745733600000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745737200000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745740800000&x={x}&y={y}&z={z}",
            "https://wapi.open.geovisearth.com/v2/view/tiles/png/gfs/wind10?fcTime=1745744400000&x={x}&y={y}&z={z}"
        ]
    }
}