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

水体提取

更新时间：2025-08-08 13:51:06

接口说明

利用语义分割算法或水体指数阈值分割算法对高分辨卫星影像中水体进行提取，包括河流、坑塘、湖泊

调用方式

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

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

请求参数

参数名	含义	数据类型	是否必填	缺省值
bbox	圈选的范围	string	是	/
map	数据源选择(default:星图云底图 custom:其它底图 no:用户自有数据)	string	否	default
options	用户参数设置，见options字段含义下示例。	map	map=custom 必填	/
path	用户自己上传文件服务器生成链接，支持阿里云，七牛云等文件服务器	string	map=no 必填	/
async	是否异步执行，提交后通过任务接口异步获取结果，false-同步执行 true-异步执行	boolean	否	false

options字段含义

示例：options={"serviceType":"tms","source":"https://tiles.geovisearth.com/base/v1/img/{z}/{x}/{y}","token":"您的tms或者wmts服务的token"}

参数名	含义	数据类型	是否必填
options.serviceType	数据底图选择TMS/WMTS(当map=custom时,请设置该参数)	string	map=custom 必填
options.source	数据底图地址(当map=custom时,请设置该参数)	string	map=custom 必填
options.token	您的tms服务的token，当options.serviceType=tms时，传入参数为token	string	map=custom 并且 options.serviceType=tms 必填
options.tk	您的wmts服务的token，当options.serviceType=wmts时，传入参数为tk	string	map=custom 并且 options.serviceType=wmts 必填

返回参数

参数名	含义	规则数据
status	String	状态码，非success表示没有正常获取到数据
detail	String	返回详情
detail-resultPath	String	结果路径地址
taskTypeCh	String	任务类型中文名
taskType	String	任务类型

调用示例

请求示例（星图云底图）

https://api.open.geovisearth.com/v2/ai/water/extraction?bbox=%5B114.6872474990300077,26.4538289058699938,114.7306790308749953,26.4784792347549960%5D&map=default&token=您的token

请求示例（其他底图，瓦片服务类型为TMS）

https://api.open.geovisearth.com/v2/ai/water/extraction?bbox=%5B114.6872474990300077,26.4538289058699938,114.7306790308749953,26.4784792347549960%5D&map=custom&options={"serviceType":"tms","source":"https://tiles.geovisearth.com/base/v1/img/{z}/{x}/{y}","token":"底图服务商的token"}&token=您的token

请求示例（其他底图，瓦片服务类型为WMTS）

https://api.open.geovisearth.com/v2/ai/water/extraction?bbox=%5B114.6872474990300077,26.4538289058699938,114.7306790308749953,26.4784792347549960%5D&map=custom&options={"serviceType":"WMTS","source":"http://t0.tianditu.gov.cn/img_w/wmts?SERVICE=WMTS","tk":"底图服务商的token"}&token=您的token

请求示例（用户自有数据上传）

https://api.open.geovisearth.com/v2/ai/water/extraction?bbox=%5B114.6872474990300077,26.4538289058699938,114.7306790308749953,26.4784792347549960%5D&map=no&path=https://io-qos.geovisearth.com/getfile/15/geovis-test/wanan_Q4_cut2.tif&token=您的token

返回示例

{
    "code": 200,
    "data": {
        "taskType": "13",
        "detail": {
            "resultPath": "https://api3.geovisearth.com/sample-daas/user_temp_data/Zsy3woMwPEIUYIr2NIZgylUyTKwfdNzO/2024/08/22/daasResult/90a487b7a249931cd1116141b0efd06054ad27ccbae0f7bbd82a08c8563f4341789e51645f423b8b92b6ec0d2967a1a60c9ed9e25ad1c7eb0faea1a830eba030.geojson"
        },
        "status": "success",
        "taskTypeCh": "waterExtraction-水体提取"
    },
    "message": "success"
}