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

全球海洋网格预报图层

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

接口说明

本接口提供全球海洋温度、盐度、海流可视化图层，基于公里级高精度的预报数据，利用专业的可视化和图形渲染技术，生成鲜艳、直观的图层产品，包含已配色图层和中间体图层，支持您进行自定义前端配色。可以轻松的与第三方地图库集成，如中科星图地图、高德地图、腾讯地图、百度地图等。
空间范围：全球海洋
空间分辨率：8km
时间范围：查询时间过去24小时至未来7天
更新频次：1次/天
预报时效：未来0~3天逐1小时，未来3~7天逐3小时
数据要素：海表温度、盐度、海流流速
数据格式：webp、png、json
配色方案：标准配色以及支持定制化配色
使用方式：通过API获取图层文件，并与地图叠加，最终可实现拖拽、放大缩小等诸多功能。您既可以展示静态的单张图片，亦可连续播放形成动态展示。

调用方式

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

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

请求参数

参数名	含义	规则数据	是否必填	缺省值
productCode	产品类型，见产品类型代码表	string	是	/
start	查询开始时间，格式为yyyyMMddHH	string	是	/
end	查询开始时间，格式为yyyyMMddHH	string	是	/
meteCodes	要素类型，见要素代码表	string	是	/

productCode产品类型代码表：

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

meteCodes要素代码表：

要素代码	要素说明
sss	海表盐度，单位：PSU
sst	海表温度，单位：°C
current_speed	水洋流流速，单位：m/s

返回参数

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

调用示例

请求示例

https://api.open.geovisearth.com/v2/view/ocean/forecast?productCode=mfv&meteCode=sss&start=2024072600&end=2024072800&token=您的token

返回示例

{
    "date": {
        "timeZone": "Asia/Shanghai",
        "time": "20241022191940"
    },
    "result": {
        "meteCode": "sss",
        "urls": {
            "2024102200": [
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/current/202410/2108/sss_2024102200f5b9bda96b7587982d.webp",
                "https://io-qos.geovisearth.com/getfile/35/visual/vucloud/mfv/current/202410/2108/sss_2024102200f5b9bda96b7587982d.json"
            ]
        },
        "productCode": "mfv",
        "dataCode": "current",
        "timeRange": [
            "2024102200",
            "2024102200"
        ]
    },
    "version": "v1",
    "status": 0
}