星图云开放平台
开发指南
大棚提取
更新时间:2025-05-15 17:13:51
接口说明

利用语义分割算法对高分辨卫星影像中大棚进行智能提取

调用方式

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

服务地址https://api.open.geovisearth.com/v2/ai/greenhouse/extraction
请求方式GET 方法
接口鉴权服务密钥授权,您需要 申请 token将 token 作为必填参数拼接在服务地址中一起请求
调用限制服务调用量的限制请点击 这里 查阅
请求参数
参数名含义数据类型是否必填缺省值
bbox圈选的范围string/
map数据源选择(default:星图云底图 custom:其它底图 no:用户自有数据)stringdefault
options用户参数设置,见options字段含义下示例。mapmap=custom 必填/
path用户自己上传文件服务器生成链接,支持阿里云,七牛云等文件服务器stringmap=no 必填/
async是否异步执行,提交后通过任务接口异步获取结果,false-同步执行  true-异步执行booleanfalse

 

options字段含义

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

参数名含义数据类型是否必填
options.serviceType数据底图选择TMS/WTMS(当map=custom时,请设置该参数)stringmap=custom 必填
options.source数据底图地址(当map=custom时,请设置该参数)stringmap=custom 必填
options.token您的tms服务的token,当options.serviceType=tms时,传入参数为tokenstringmap=custom 并且 options.serviceType=tms 必填
options.tk您的wmts服务的token,当options.serviceType=wtms时,传入参数为tkstringmap=custom 并且 options.serviceType=wmts 必填
返回参数
参数名含义规则数据
statusString状态码,非success表示没有正常获取到数据
detailString返回详情
detail-resultPathString结果路径地址
taskTypeChString任务类型中文名
taskTypeString任务类型
调用示例

请求示例(星图云底图)

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

请求示例(其他底图,瓦片服务类型为TMS)

https://api.open.geovisearth.com/v2/ai/greenhouse/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/greenhouse/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/greenhouse/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": "4",
        "detail": {
            "resultPath": "https://api3.geovisearth.com/sample-daas/user_temp_data/Zsy3woMwPEIUYIr2NIZgylUyTKwfdNzO/2024/08/22/daasResult/73d43c568ac8b396cf455a242abb420f80c969074cd22f5970a4cee1a17ce08961ac332459038687efd3757f0def0218a493c89abbd3219b74c50efd2544b6c0.geojson"
        },
        "status": "success",
        "taskTypeCh": "greenhouseExtraction-大棚提取"
    },
    "message": "success"
}