根据ID获取场景(公开场景)
优质
小牛编辑
132浏览
2023-12-01
接口说明
场景分公开私有,私有的场景只能自己查看或者团队,公开的场景可以对所有人查看,包括游客(没有登录的用户),此接口是为了分享场景给其他人查看,无需进行登录操作就可以查看到场景的相关信息
如需调用,请访问 开发者文档 来查看详细的接口使用说明
该接口仅开放给已获取SDK的开发者
API地址
POST
/api/scene/1.0.0/getPublic
是否需要登录
否
请求字段说明
参数 | 类型 | 请求类型 | 是否必须 | 说明 |
---|---|---|---|---|
id | string | form | 是 | 场景ID |
响应字段说明
参数 | 类型 | 说明 |
---|---|---|
guid | String | 场景唯一标识 |
coverImg | String | 缩略图 |
title | String | 标题 |
descript | String | 描述 |
baseMap | String | 底图 |
authorGuid | String | 创建者 |
keyword | String | 标签 |
addTime | String | 创建时间 |
viewTimes | String | 预览次数 |
viewpointGuid | String | 默认视角 |
isDel | String | 是否删除 |
terrain | String | 地形 |
scenepower | String | 数据权限,1公开;2私有 |
watermarke | String | LOGO |
username | String | 用户名 |
photo | String | 头像 |
powers | String | 权限 |
响应成功示例
{ "code": 200, "data": { "coverImg": "data/image/76e29616-3312-4b25-bcc6-5d20483a6b1f.jpg", "addTime": "1534473349000", "watermarke": "data/image/76e29616-3312-4b25-bcc6-5d20483a6b1f.jpg", "guid": "7bbf39cd-41e0-42cc-a324-8956cdcda59a", "authorGuid": "0829b03d-4458-87c0-e67671a8291a", "scenepower": "2", "title": "我的场景", "descript": "这是场景描述", "keyword": "实景三维,标签", "viewTimes": 7, "isDel": 0, "viewpointGuid": "0829b03d-4458-87c0-e67671a8291a" }, "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 | 令牌为空 |
40005 | 接口使用错误,场景为私有场景,请使用私有场景的接口 |
示例代码
$.ajax({ url:'/api/scene/1.0.0/getPublic', type:'POST', data:'id=', dataType:'text', cache:false, contentType: "application/x-www-form-urlencoded", xhrFields: { withCredentials: true }, crossDomain: true, success:function(data){ // 成功返回值 }, error:function(XMLHttpRequest, textStatus, errorThrown){ } })