-
样式 本章节介绍世界地图的样式各配置项的含义。 尺寸位置 W：设置图表的宽，单位为px。 H：设置图表的高，单位为px。 X：设置图表在画布中的位置，单位为px。 Y：设置图表在画布中的位置，单位为px。 不透明度：设置图表在画布上的透明度，可通过滑动条进行设置，也可手动输入百分比，比例越大透明程度越低。 图1 尺寸位置 全局样式 地图视角：有太平洋版和大西洋版两种视角。 太平洋版：切换地图样式为以太平洋为中心。 大西洋版：切换地图样式为以大西洋为中心。 地图中心：设置地图中心在图层中的位置。 维度：设置地图中心的维度，输入值必须在-180到180之间。 经度：设置地图中心的经度，输入值必须在-180到180之间。 地图缩放：根据经纬度设置的中心点，对整个地图进行缩放，缩放范围0.1~50。 图2 全局样式 填充设置 透明度：设置填充的透明度，输入值必须在0到1之间。 填充颜色：设置填充的颜色。 宽度：设置填充的宽度，输入值必须在0到10之间。 图3 填充设置 视觉映射 显示/隐藏视觉映射：单击“标签”右侧的勾选框，表示显示视觉映射，表示隐藏视觉映射。 映射类型：单击下拉选项设置视觉映射的映射类型，可以设置为连续型或分段型。 方向：单击下拉选项设置视觉映射的映射方向，可以设置为水平或垂直。 宽度：设置视觉映射的宽度。 高度：设置视觉映射的高度。 左侧：设置视觉映射时距离图层左侧的距离。 底部：设置视觉映射时距离图层底部的距离。 文字：设置视觉映射时文本的字体颜色和字号大小。 颜色范围：设置视觉映射时颜色范围。 图4 视觉映射 标签 显示标签：勾选标签后，地图中的标签只展示有数据的部分，无数据则不展示。 显示全量：选中全量后无数据的部分也正常显示。 显示度量：显示字段中选择的度量字段。 字体：用户可自定义设置标签的字体。 颜色：用户可自定义设置标签的字体颜色。 字号：用户可自定义设置标签的字体字号，范围10~100之间。 字体粗细：用户可以设置标签字体的粗细，类型有Normal、Bold、Bolder、Lighter。 选中样式 颜色：单击颜色编辑器设置颜色。 标签颜色：单击颜色编辑器设置标签颜色。 数据值：单击“数据值”右侧的勾选框，表示显示数据值，表示隐藏数据值。 数据名：单击“数据名”右侧的勾选框，表示显示数据名，表示隐藏数据名。 文本样式：设置文本的颜色、字号和字体粗细样式。 图5 选中样式 开启缩放：支持设置是否开启缩放。勾选，可在预览、查看中缩放地图，不勾选，在预览、查看中不能缩放地图。 开启平移：支持设置是否开启平移。勾选，可在预览、查看中平移地图，不勾选，在预览、查看中不能平移地图。
-
查看工作空间内的数据资产 数据地图围绕数据搜索，服务于数据分析、数据开发、数据挖掘、数据运营等数据表的使用者和拥有者，提供方便快捷的数据搜索服务，拥有功能强大的血缘信息及影响分析。 搜索：在进行数据分析前，使用数据地图进行关键词搜索，帮助快速缩小范围，找到对应的数据。 详情：使用数据地图根据表名直接查看表详情，快速查阅明细信息，掌握使用规则。 血缘：通过数据地图的血缘分析可以查看每个数据表的来源、去向，并查看每个表及字段的加工逻辑。 父主题： 查看工作空间数据地图
-
样式 尺寸位置 图表尺寸：设置图表的宽和高。单位为px。 图表位置：设置图表在画布中的位置。单位为px。 图1 尺寸位置-3D世界地图 添加子组件 地图的子组件包括地图飞线、地图散点、柱状层。 地图飞线 以动态飞线的形式连接地图中的两个地理位置，飞线的样式、位置的经纬值参考以下步骤进行配置。 单击“添加子组件”，添加地图飞线。 图2 添加地图飞线-3D世界地图 单击“地图飞线”，进入地图飞线的配置页面。 在“样式”页签，配置飞线的飞行速率、飞线粗细、飞线长度和颜色。 图3 配置地图飞线样式-3D世界地图 在“数据”页签，配置飞线的起点和终点的经纬度。 数据格式：from为飞线的起点，to为飞线的终点。 自动更新请求：勾选自动更新请求，并设置更新间隔后，动态数据将根据间隔时间自动轮询。 地图散点 以散点的形式表现地图中的某些地理位置的数据信息，散点的样式、经纬度参考以下步骤进行配置。 单击“添加子组件”，添加地图散点。 图4 添加地图散点-3D世界地图 单击“地图散点”，进入地图散点的配置页面。 在“样式”页签，配置散点的散点大小、样式、颜色和透明度。 图5 配置地图散点样式-3D世界地图 在“数据”页签，配置散点的经纬度和大小。 数据格式：lon为散点的经度；lat为散点的纬度；value为散点的值，与样式中散点大小一起决定散点的大小，value值越大，散点越大。 自动更新请求：勾选自动更新请求，并设置更新间隔后，动态数据将根据间隔时间自动轮询。 柱状层 以3D柱状的形式表现地图中的某些地理位置的数据信息，柱状层的样式、经纬度参考以下步骤进行配置。 单击“添加子组件”，添加柱状层。 图6 添加柱状层-3D世界地图 单击“柱状层”，进入柱状层的配置页面。 在“样式”页签，配置柱状层的柱子粗细、柱子的最小高度值、柱子的颜色和颜色透明度。 图7 配置柱状层样式-3D世界地图 在“数据”页签，配置柱子的经纬度和高度。 数据格式：lon为柱子的经度；lat为柱子的纬度；value为柱子的值，value值越大，柱子越高。 自动更新请求：勾选自动更新请求，并设置更新间隔后，动态数据将根据间隔时间自动轮询。 全局样式 地图中心：设置地图中心在图层中的位置。 地球旋转：设置地图的缩放距离、水平旋转角度、垂直旋转角度。 地图颜色：设置地图中区域块的填充色。 边线选项：设置地图中区域边线的颜色和宽度。 图8 全局样式-3D世界地图
-
响应参数 状态码：201 表4 响应Body参数 参数 参数类型 描述 url String 地图资源地址。 id Integer 地图ID。 created_at Double 创建时间。 updated_at Double 更新时间。 file FileCreateSrlz object 地图文件信息。 version String v1.4.0 - v1.4.0 v1.5.0 - v1.5.0 v1.6.0 - v1.6.0 v1.6.1 - v1.6.1 v1.7.0 - v1.7.0 agreement_confirm Boolean 是否同意免责声明，必须为true。 表5 FileCreateSrlz 参数 参数类型 描述 url String 文件资源地址。 sha256 String 文件sha256值。 created_at Double 创建时间。 updated_at Double 更新时间。 post post object POST预签链接信息，用于上传文件。 put_url String PUT预签链接地址，用于上传文件。优先使用POST方法上传。 get_url String GET地址，用于下载文件。 expire Integer 默认失效时间为600秒。 ready Boolean 文件状态。完成文件上传状态为true，未完成文件上传状态为false。 filename String 文件名。 表6 post 参数 参数类型 描述 url String POST预签链接信息，用于上传文件。 fields PostResponseField object POST预签链接信息，调用POST预签链接上传文件时用于构造请求。 表7 PostResponseField 参数 参数类型 描述 key String Post预签链接Key字段，在创建请求时需要添加到请求头。 x-amz-algorithm String Post预签链接x-amz-algorithm字段，在创建请求时需要添加到请求头。 x-amz-credential String Post预签链接x-amz-credential字段，在创建请求时需要添加到请求头。 x-amz-date String Post预签链接x-amz-date字段，在创建请求时需要添加到请求头。 policy String Post预签链接policy字段，在创建请求时需要添加到请求头。 x-amz-signature String Post预签链接x-amz-signature字段，在创建请求时需要添加到请求头。
-
请求示例 创建场景地图 POST https://{endpoint}/v2/{project_id}/sim/sm/maps/
{
"version" : "v1.6.0",
"file" : {
"sha256" : "8717ae1874a4b063267211bb575373b7eb73aaa99d6ed531352fff3776dc3a60",
"filename" : "ALKS_Road_straight.xodr"
}
}
-
响应示例 状态码：201 请求成功 {
"url" : "/v2/my_project_id/sim/sm/maps/2631662/",
"id" : 2631662,
"created_at" : 1.699954027366838E9,
"updated_at" : 1.699954027366882E9,
"file" : {
"url" : "/v2/my_project_id/sim/sm/files/8717ae1874a4b063267211bb575373b7eb73aaa99d6ed531352fff3776dc3a60/",
"sha256" : "8717ae1874a4b063267211bb575373b7eb73aaa99d6ed531352fff3776dc3a60",
"created_at" : 1.699954027363056E9,
"updated_at" : 1.699954027363114E9,
"post" : {
"url" : "https://post_url",
"fields" : {
"key" : "sim/ifiles/map/8717ae1874a4b063267211bb575373b7eb73aaa99d6ed531352fff3776dc3a60.xodr",
"x-amz-algorithm" : "AWS4-HMAC-SHA256",
"x-amz-credential" : "my-x-amz-credential",
"x-amz-date" : "20231114T092707Z",
"policy" : "my-policy",
"x-amz-signature" : "my-x-amz-signature"
},
"put_url" : "my-put-url",
"get_url" : null,
"expire" : 600,
"ready" : false,
"filename" : "ALKS_Road_straight.xodr"
},
"version" : "v1.6.0"
},
"agreement_confirm" : true
}
-
请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 file 是 FileCreateSrlz object 地图文件信息。 version 是 String v1.4.0 - v1.4.0 v1.5.0 - v1.5.0 v1.6.0 - v1.6.0 v1.6.1 - v1.6.1 v1.7.0 - v1.7.0 agreement_confirm 是 Boolean 是否同意免责声明，必须为true。 表3 FileCreateSrlz 参数 是否必选 参数类型 描述 sha256 是 String 文件sha256值。 filename 是 String 文件名。
-
请求示例 HTTP的示例 GET /controller/campus/v1/indoormapservice/floors/75ade72a-e7a9-4c81-8fca-894e7ca9c2c2 HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-AC
CES S-TOKEN: x-yyyyyy
-
响应参数 返回状态码为200：查询成功，响应体参考QueryFloorDetailsResponse。 表2 QueryFloorDetailsResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "error" data REFERENCE 详细请参见表3。 楼层详细信息 - 表3 FloorDetails对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 name string - - 楼层名称。 "F3" number string - - 楼层号。 "7" image byte - - 楼层图纸。 "iVBORw0KGgoAAAANSUhEUgAAAEIAAAA8CAYAAADSfGxZAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAAEXRFWHRTb2Z0d2FyZQBTbmlwYXN0ZV0Xzt0AAAEKSURBVGiB7dvRaoMwGEDhP3Hv/4I+hPei/rs5Slo2lw1KITsHSi0m0X54acpxHBkRUUqJiIjMvI6fuzv3fD4zo123Z87dmLOvxvZe625s/XHmP0kIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChKChINqX13/bUBDtG/cnSi/OUBCZGeu6xrZtDwA9GMNBzPMcy7Jcv9vvu8pIG1cy81rv/Hw3duiNK7XWqPXxL+373jf3FTf07k6MzIxpmrrmfLzyht7R+cj37O9qG/KJ+EtCkBAkBAlBQpAQ9AkRmWqufm0+xwAAAABJRU5ErkJggg==" scale double - - 比例尺，表示图上距离与实际距离的比，例如：图上0.01米代表实际1米，则比例尺为0.01。 "0.022" 返回状态码为400：请求参数错误，无响应体。 详细信息请参见实际响应消息体。 返回状态码为500：内部服务器错误，无响应体。 详细信息请参见实际响应消息体。
-
响应示例 返回状态码为200：查询成功，响应体参考QueryFloorDetailsResponse。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"errcode" : "0",
"errmsg" : "error",
"data" : {
"name" : "F3",
"number" : "7",
"image" : "iVBORw0KGgoAAAANSUhEUgAAAEIAAAA8CAYAAADSfGxZAAAACXBIWXMAAA7EAAAOxAGVKw4bAAAAEXRFWHRTb2Z0d2FyZQBTbmlwYXN0ZV0Xzt0AAAEKSURBVGiB7dvRaoMwGEDhP3Hv/4I+hPei/rs5Slo2lw1KITsHSi0m0X54acpxHBkRUUqJiIjMvI6fuzv3fD4zo123Z87dmLOvxvZe625s/XHmP0kIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChCAhSAgSgoQgIUgIEoKEICFICBKChKChINqX13/bUBDtG/cnSi/OUBCZGeu6xrZtDwA9GMNBzPMcy7Jcv9vvu8pIG1cy81rv/Hw3duiNK7XWqPXxL+373jf3FTf07k6MzIxpmrrmfLzyht7R+cj37O9qG/KJ+EtCkBAkBAlBQpAQ9AkRmWqufm0+xwAAAABJRU5ErkJggg==",
"scale" : "0.022"
}
} 返回状态码为400：请求参数错误，无响应体。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
返回状态码为500：内部服务器错误，无响应体。 HTTP/1.1 500 Internal Server Error
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
请求示例 HTTP的示例 POST /controller/campus/v3/digitalmap/application/list HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-ACCESS-TOKEN: x-yyyyyy
{
"siteId" : "",
"keyword" : "",
"status" : "abnormal",
"startTime" : "1702971000000",
"endTime" : "1703027770000",
"pageIndex" : 1,
"pageSize" : 20,
"appIdList" : [
"10491"
]
}
-
响应示例 返回状态码为200：接口调用成功，响应体参考MapListResp。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"statusCode" : "",
"errorCode" : "",
"errorMsg" : "",
"costTime" : "",
"totalRecords" : 10,
"data" : [
{
"appId" : "10491",
"appName" : "ZOOM",
"status" : "abnormal",
"totalTraffic" : 300,
"abnormalFlowCount" : 300,
"totalFlowCount" : 300,
"latency" : 0.1,
"packetLossRate" : 3.4,
"guaranteeServicesNum" : 5,
"detailUrl" : "/eviewwebsite/index.html#path=/app/detail&appId=426&appName=dhcp&isDpi=0&timeRange={\\\"dateFrom\\\":1703001600000,\\\"dateTo\\\":1703037861834,\\\"key\\\":\\\"TODAY\\\"}&isQuality=1&displayMode=1&type=traffic",
"isDpi" : "1"
}
]
} 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
响应参数 返回状态码为200：接口调用成功，响应体参考MapListResp。 表3 MapListResp对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 statusCode int32 - 200 状态码 - errorCode int32 - 0 错误码 - errorMsg string - Successful. 错误消息 - costTime int32 - 0 花费时间。 - totalRecords int64 - - 应用总数。 10 data ARRAY_REFERENCE 详细请参见表4。 应用数据。 - 表4 MapListModel对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 appId string - - 应用ID。 "10491" appName string - - 应用名称。 "ZOOM" status string - - 应用状态。 "abnormal" totalTraffic int64 - - 总流量。单位Byte。 300 abnormalFlowCount int64 - - 异常流条数。单位条。 300 totalFlowCount int64 - - 流总数。单位条。 300 latency double - - 延迟。单位ms。 0.1 packetLossRate double - - 丢包率。单位% 3.4 guaranteeServicesNum int64 - - 有保障对象的应用数量。 5 detailUrl string - - 跳转到流量分析的URL。 "/eviewwebsite/index.html#path=/app/detail&appId=426&appName=dhcp&isDpi=0&timeRange={\\\"dateFrom\\\":1703001600000,\\\"dateTo\\\":1703037861834,\\\"key\\\":\\\"TODAY\\\"}&isQuality=1&displayMode=1&type=traffic" isDpi string - - dpi状态值。只有0和1。 "1" 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。
-
响应参数 返回状态码为200：查询成功，响应体参考QueryLocatedDeviceDetailsResponse。 表3 QueryLocatedDeviceDetailsResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "error" data ARRAY_REFERENCE 详细请参见表4。 已布放设备详情列表。 - 表4 LocatedDeviceDetails对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string - - 设备ID，格式UUID。 "c2b378d8-145f-4e46-8d71-c3709695dd06" name string - - 设备名称。 "AP6605" status string 0 1 3 4 - 设备状态 0: 正常 1: 告警 3: 离线 4: 未注册 "0" esn string - - 设备ESN号。 "AA50082925AAAA001154" mac string - - MAC地址。 "xx:xx:xx:xx:xx:xx" description string - - 设备备注信息。 "HUAWEI" apType string cloud AP distributed AP cloud central AP - AP分类 cloud AP：云AP distributed AP：云分布式AP cloud central AP：云中心AP "cloud AP" positionX int32 - - 设备布放坐标X，单位：像素。 "32" positionY int32 - - 设备布放坐标Y，单位：像素。 "32" planPositionX int32 - - 设备规划坐标X，单位：像素。 "32" planPositionY int32 - - 设备规划坐标Y，单位：像素。 "32" planPointId string - - 网规规划点ID，格式UUID。 "75ade72a-e7a9-4c81-8fca-894e7ca9c2c2" 返回状态码为400：请求参数错误，无响应体。 详细信息请参见实际响应消息体。 返回状态码为500：内部服务器错误，无响应体。 详细信息请参见实际响应消息体。
-
响应示例 返回状态码为200：查询成功，响应体参考QueryLocatedDeviceDetailsResponse。 HTTP/1.1 200 OK
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
{
"errcode" : "0",
"errmsg" : "error",
"data" : [
{
"id" : "c2b378d8-145f-4e46-8d71-c3709695dd06",
"name" : "AP6605",
"status" : "0",
"esn" : "AA50082925AAAA001154",
"mac" : "xx:xx:xx:xx:xx:xx",
"description" : "HUAWEI",
"apType" : "cloud AP",
"positionX" : "32",
"positionY" : "32",
"planPositionX" : "32",
"planPositionY" : "32",
"planPointId" : "75ade72a-e7a9-4c81-8fca-894e7ca9c2c2"
}
]
} 返回状态码为400：请求参数错误，无响应体。 HTTP/1.1 400 Bad Request
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
返回状态码为500：内部服务器错误，无响应体。 HTTP/1.1 500 Internal Server Error
Date: Sun,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
