保存标注
优质
小牛编辑
118浏览
2023-12-01
接口说明
该接口已经废弃，请使用【单体化、标绘、压平 -> GEOJSON上传】接口
如果需要标识模型上某个位置信息，可以通过调用该接口，来记录标识的位置
可以设置的内容有名称、位置信息以及标注图标和字体颜色
如需调用，请访问 开发者文档 来查看详细的接口使用说明
该接口仅开放给已获取SDK的开发者
API地址
POST /api/marker/1.0.0/add
是否需要登录
是
请求字段说明
| 参数 | 类型 | 请求类型 | 是否必须 | 说明 |
|---|---|---|---|---|
| sId | string | form | 是 | 场景ID |
| text | string | form | 是 | 名称 |
| x | number | form | 是 | 坐标位置x |
| y | number | form | 是 | 坐标位置y |
| z | number | form | 是 | 坐标位置z |
| iconPath | string | form | 是 | 标注图标 |
| fontColor | string | form | 是 | 字体颜色 |
| posx | number | form | 是 | 相机位置，从camera.position中获取 |
| posy | number | form | 是 | 相机位置，从camera.position中获取 |
| posz | number | form | 是 | 相机位置，从camera.position中获取 |
| directionx | number | form | 是 | 相机位置，从camera.direction中获取 |
| directiony | number | form | 是 | 相机位置，从camera.direction中获取 |
| directionz | number | form | 是 | 相机位置，从camera.direction中获取 |
| upx | number | form | 是 | 相机位置，从camera.up中获取 |
| upy | number | form | 是 | 相机位置，从camera.up中获取 |
| upz | number | form | 是 | 相机位置，从camera.up中获取 |
响应字段说明
无
响应成功示例
{
"code": 200,
"data": {
"markerGuid": "7bbf39cd-41e0-42cc-a324-8956cdcda59a",
"viewpointGuid": "7bbf39cd-41e0-42cc-a324-8956cdcda59a"
},
"message": "OK"
}响应失败示例
{
"code": 500,
"message": "未知错误，请及时联系管理人员进行处理"
}响应接受类型
application/json:charset=utf-8
响应状态码
| HTTP状态码 | 原因 |
|---|---|
| 204 | No Content |
| 401 | Unauthorized |
| 403 | Forbidden |
| 40001 | 查询结果为空 |
| 40001 | 查询结果不是JSON数据 |
| 40001 | 查询结果JSON不符合要求 |
| 40002 | 请求接口失败 |
| 40003 | 参数无效 |
| 40004 | 令牌无效 |
| 40004 | 令牌为空 |
示例代码
$.ajax({
url:'/api/marker/1.0.0/add',
type:'POST',
data:'sId=&posx=&posy=&posz=&x=&y=&directionx=&z=&directiony=&text=&directionz=&iconPath=&upx=&fontColor=&upz=&upy=',
dataType:'text',
cache:false,
contentType: "application/x-www-form-urlencoded",
xhrFields: {
withCredentials: true
},
crossDomain: true,
success:function(data){
// 成功返回值
},
error:function(XMLHttpRequest, textStatus, errorThrown){
}
})