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

道路变化检测接口

更新时间：2025-08-08 13:50:42

接口说明

利用语义分割算法对高分辨卫星影像道路中进行变化检测

调用方式

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

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

请求参数

参数名	含义	数据类型	是否必填	缺省值
bbox	圈选的范围	string	否	/
map	数据源选择(default:星图云底图 custom:其它底图 no:用户自有数据)	string	否	default
options	用户参数设置，示例：options={"serviceType":"tms","source":"https://tiles.geovisearth.com/base/v1/img/{z}/{x}/{y}","token":"您的tms或者wmts服务的token"}	map	map=custom 必填	/
path	用户自己上传文件服务器生成链接，支持阿里云，七牛云等文件服务器	string	map=no 必填	/
path1	用于对比的文件，用户自己上传文件服务器生成链接，支持阿里云，七牛云等文件服务器	string	map=no 必填	/
async	是否异步执行，提交后通过任务接口异步获取结果，false-同步执行 true-异步执行	boolean	否	false

options字段含义

参数名	含义	数据类型	是否必填
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/service/roadChange?bbox=%5b116.26696662316385,40.08570861640331,116.2745351398155,40.0889903533475%5d&token=您的token

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

https://api.open.geovisearth.com/v2/ai/service/roadChange?bbox=%5b117.15063513016383,31.833520038165773,117.17544975291798,31.850905358662416%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/service/roadChange?bbox=%5b117.15063513016383,31.833520038165773,117.17544975291798,31.850905358662416%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/service/roadChange?bbox=%5b117.15063513016383,31.833520038165773,117.17544975291798,31.850905358662416%5d&map=no&path=https://io-qos.geovisearth.com/getfile/15/geovis-test/wanan_Q4_cut2.tif&path1=https://io-qos.geovisearth.com/getfile/15/geovis-test/wanan_Q4_cut2.tif&token=您的token

返回示例

{
    "code": 200,
    "message": "success",
    "data": {
        "status": "success",
        "detail": {
            "resultPath": "https://inf.geovisearth.com/sample-daas/user_temp_data/e85adcfc-e544-4421-b79f-3d20b6d679dd/2025/03/27/daasResult/5e79f96676163c4239cb9db2286be778.geojson",
            "resultViewPath": null
        },
        "taskTypeCh": "RoadChange-道路变化检测",
        "taskType": "21"
    }
}