警务辖区相关接口

由于数据部分涉密 ,故示例中返回结果集置空

重要提示：由于数据部分涉及敏感信息，示例中返回结果集已置空或模糊处理，实际调用需遵循数据安全规范。

# 一、获取警务辖区子节点（不包含孙节点）

# 1.1 接口基本信息

接口名称：获取警务辖区子节点（不包含孙节点）
接口地址：/one-map-server/om/OmStation/getStationChildTreeNoSon
请求方式：POST
请求数据类型：application/json
响应数据类型：application/json
接口描述：根据机构编码（orgSerial）查询警务辖区的直接子节点（仅包含一级子节点，不包含孙节点），返回平铺的节点列表。

# 1.2 请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	示例值	备注
orgSerial	机构编码	query	可选	string	"650000000000"	若未传参，默认查询根节点下的所有一级子节点；传参时查询指定节点的子节点

# 1.3 响应参数说明

参数名称	参数说明	类型	示例值	备注
alertMsg	提示消息（如操作结果、错误信息）	string	"操作成功"	成功时通常为空，失败时返回具体错误描述
alertType	提示消息类型（`0`：无提示；`1`：成功；`2`：警告；`3`：错误）	integer(int32)	`1`	对应业务状态的可视化提示类型
code	状态码（`0`：成功；非`0`：失败）	integer(int32)	`0`	非`0`时需结合`alertMsg`分析错误原因
data	业务数据（节点列表）	array[Object]	见响应示例	每个元素为`OmTreeNode`对象，包含节点属性和子节点信息
location	跳转地址（预留字段，当前接口暂不使用）	string	""	无需处理

# `OmTreeNode`对象属性说明

属性名称	说明	类型	示例值	备注
adcode	行政区划代码	string	"650100"	可选字段，与地理区域关联
childHas	是否包含子节点（`YES`/`NO`）	string	"YES"	标识当前节点是否存在子节点（仅表示是否有下一级，不包含实际子节点数据）
children	子节点列表（永远为空，因接口功能限制不返回孙节点）	array	`[]`	该接口中此字段始终为空
code	节点代码	string	"650000000000"	唯一标识节点的编码
fullCode	完整代码路径	string	"65/00/00"	由父节点到当前节点的层级代码组合
fullName	完整名称路径	string	"省/市/区"	由父节点到当前节点的层级名称组合
leavel	节点级别（如`0`：省级；`1`：市级）	string	"0"	具体级别定义需参考业务字典
leavelCode	级别代码（如`province`：省级）	string	"province"	枚举值，与`leavel`对应
name	节点名称	string	"XX省"
parcode	父节点代码	string	"0"	根节点的`parcode`为`null`或`0`
thisObj	当前节点的详细对象（包含空间查询所需ID等关键信息）	object	见响应示例	包含`id`（空间面查询ID）、`geomHas`（是否有空间面）等字段

# 1.4 响应示例

{  
  "alertMsg": "",  
  "alertType": 1,  
  "code": 0,  
  "data": [  
    {  
      "adcode": "",  
      "childHas": "YES",  
      "children": [], // 固定为空，不包含孙节点  
      "code": "650000000000",  
      "fullCode": "650000000000",  
      "fullName": "XX省",  
      "leavel": "0",  
      "leavelCode": "province",  
      "name": "XX省",  
      "parcode": null,  
      "thisObj": {  
        "id": "120392", // 空间面查询ID，用于获取边界数据  
        "name": "XX省",  
        "geomHas": "YES", // 是否存在空间面数据（`YES`/`NO`）  
        // 其他属性省略  
      }  
    }  
  ],  
  "location": ""  
}

# 二、通过搜索获取警务辖区树（平铺列表）

# 2.1 接口基本信息

接口名称：通过搜索获取警务辖区树（平铺列表）
接口地址：/one-map-server/om/OmStation/getStationTreeBySearch
请求方式：POST
请求数据类型：application/json
响应数据类型：application/json
接口描述：根据搜索内容（queryContent）模糊查询警务辖区节点，返回平铺的树结构列表（不包含层级嵌套，仅展示节点属性）。

# 2.2 请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	示例值	备注
queryContent	搜索关键词（支持名称、代码模糊匹配）	query	可选	string	"朝阳警务站"	未传参时返回根节点

# 2.3 响应参数

参数结构与获取警务辖区子节点一致，区别在于：

children字段：在此接口中始终为空，因返回的是平铺列表而非层级树结构。
数据范围：根据搜索关键词过滤节点，返回匹配的所有层级节点（但不包含子节点嵌套）。

# 2.4 响应示例

{  
  "alertMsg": "搜索到5条结果",  
  "alertType": 1,  
  "code": 0,  
  "data": [  
    {  
      "name": "朝阳警务站",  
      "code": "110105001",  
      "thisObj": {  
        "id": "120393",  
        "geomHas": "YES"  
      }  
      // 其他属性省略  
    }  
  ],  
  "location": ""  
}

# 三、通过搜索获取警务辖区树并构建层级树

# 3.1 接口基本信息

接口名称：通过搜索获取警务辖区树并构建层级树
接口地址：/one-map-server/om/OmStation/getStationTreeBySearchToTree
请求方式：POST
请求数据类型：application/json
响应数据类型：application/json
接口描述：根据搜索内容（queryContent）查询警务辖区节点，并按层级结构构建树（包含children嵌套节点），适用于前端树组件渲染。

# 3.2 请求参数

与“通过搜索获取警务辖区树”接口一致，支持模糊搜索节点名称或代码。

# 3.3 响应参数

参数结构与获取警务辖区子节点一致，关键区别：

children字段：包含符合条件的子节点对象，形成层级嵌套结构（深度不限）。
数据结构：返回根节点列表，每个根节点下包含其子节点树。

# 3.4 响应示例

{  
  "data": [  
    {  
      "name": "XX省",  
      "childHas": "YES",  
      "children": [  
        {  
          "name": "XX市",  
          "childHas": "YES",  
          "children": [  
            {  
              "name": "朝阳警务站",  
              "childHas": "NO",  
              "thisObj": {  
                "id": "120393",  
                "geomHas": "YES"  
              }  
            }  
          ]  
        }  
      ]  
      // 其他属性省略  
    }  
  ]  
}

# 四、获取警务辖区边界WKT

# 4.1 接口基本信息

接口名称：获取警务辖区边界WKT
接口地址：/one-map-server/om/OmStationPro/getStationBoxWkt
请求方式：POST
请求数据类型：x-www-form-urlencoded
响应数据类型：application/json
接口描述：通过警务辖区ID（id）获取其地理边界的WKT（Well-Known Text）格式数据，用于地图渲染或空间分析。

# 4.2 请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	示例值	备注
id	警务辖区ID（空间面查询ID）	query	必填	string	"122592"	在前面的接口里面thisObj里面找这个ID

# 4.3 响应参数

参数名称	参数说明	类型	示例值	备注
data	WKT格式地理数据	string	`"POLYGON ((82.122...))"`	遵循OGC WKT标准 (opens new window)，通常为多边形数据
其他参数	同通用响应结构（`code`、`alertMsg`等）	-	-	-

# 4.4 响应示例

# 成功响应（单个辖区）

{  
  "code": 200,  
  "data": "POLYGON ((82.12228206032012 43.57758882289106, ...))", // 完整多边形坐标  
  "alertMsg": "操作成功",  
  "alertType": 1  
}

# 失败响应（无空间面数据）

{  
  "code": 500,  
  "data": null,  
  "alertMsg": "该辖区ID（122592）无对应的空间面数据",  
  "alertType": 3  
}

# 五、获取警务辖区边界GEOJSON

# 5.1 接口基本信息

接口名称：获取警务辖区边界GEOJSON
接口地址：/one-map-server-sso-test/om/OmStationPro/getStationBoxGeoJson
请求方式：POST
请求数据类型：x-www-form-urlencoded
响应数据类型：application/json
接口描述：通过警务辖区ID（id）获取其地理边界的GEOJSON格式数据，适用于Leaflet、Mapbox等前端地图框架。

# 5.2 请求参数

与“获取警务辖区边界WKT”接口一致，id为必填参数。

# 5.3 响应参数

参数名称	参数说明	类型	示例值	备注
data	GEOJSON格式地理数据	object	包含`type`（如`Polygon`）和`coordinates`（坐标数组）的标准GEOJSON结构	遵循RFC 7946标准 (opens new window)
其他参数	同通用响应结构（`code`、`alertMsg`等）	-	-	-

# 5.4 响应示例

# 成功响应（单个辖区）

{  
  "code": 200,  
  "data": {  
    "type": "Polygon",  
    "coordinates": [  
      [  
        [82.1222820603, 43.5775888229],  
        [82.1401675739, 43.5776856322],  
        // 其他坐标点...  
      ]  
    ]  
  },  
  "alertMsg": "操作成功"  
}

# 失败响应（ID无效）

{  
  "code": 400,  
  "data": null,  
  "alertMsg": "参数错误：id格式不正确（需为纯数字字符串）",  
  "alertType": 3  
}

# 六、通过代码精确查找当前节点叶子对象

# 6.1 接口基本信息

接口名称：通过代码精确查找当前节点叶子对象
接口地址：/one-map-server/om/OmStation/getStationsTreeNodeByCode
请求方式：POST
请求数据类型：application/x-www-form-urlencoded
响应数据类型：application/json
接口描述：通过一组警务辖区代码（codes）精确查询对应的叶子节点对象，返回平铺的节点列表（仅包含叶子节点，无子节点嵌套）。

# 6.2 请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	示例值	备注
codes	警务辖区代码（多个代码用英文逗号分隔）	query	必填	string	"650000000001,650000000002"	精确匹配节点代码

# 6.3 响应参数

参数名称	参数说明	类型	备注
data	叶子节点列表（`OmTreeNode`对象）	array[OmTreeNode]	每个节点的`childHas`字段为`NO`，表示无下游子节点
其他参数	同通用响应结构（`code`、`alertMsg`等）	-	`alertMsg`默认返回"操作成功"，`alertType`为`1`（成功）

# 6.4 响应示例

{  
  "code": 200,  
  "alertMsg": "操作成功",  
  "alertType": 1,  
  "data": [  
    {  
      "name": "朝阳警务站",  
      "code": "650000000001",  
      "childHas": "NO",  
      "thisObj": {  
        "id": "120394",  
        "geomHas": "YES"  
      }  
    },  
    {  
      "name": "海淀警务站",  
      "code": "650000000002",  
      "childHas": "NO",  
      "thisObj": {  
        "id": "120395",  
        "geomHas": "NO"  
      }  
    }  
  ]  
}

# 七、通过名称模糊查找当前节点叶子对象

# 7.1 接口基本信息

接口名称：通过名称模糊查找当前节点叶子对象
接口地址：/one-map-server/om/OmStation/getStationsTreeNodeByNameLike
请求方式：POST
请求数据类型：application/x-www-form-urlencoded
响应数据类型：application/json
接口描述：通过名称关键词（nameLikeStr）模糊查询对应的叶子节点对象，返回匹配的节点列表（仅包含叶子节点）。

# 7.2 请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	示例值	备注
nameLikeStr	名称模糊查询关键词	query	必填	string	"朝阳"	支持前缀、中缀模糊匹配（如"朝阳"可匹配"朝阳警务站""XX朝阳所"等）

# 7.3 响应参数

参数结构与通过代码精确查找当前节点叶子对象一致，关键区别：

数据范围：返回名称包含关键词的所有叶子节点，可能包含多个层级的节点（如市级、区级下的叶子节点）。

# 7.4 响应示例

{  
  "code": 200,  
  "alertMsg": "搜索到3条结果",  
  "alertType": 1,  
  "data": [  
    {  
      "name": "朝阳警务站",  
      "code": "650000000001",  
      "childHas": "NO"  
    },  
    {  
      "name": "朝阳街道警务室",  
      "code": "650000000003",  
      "childHas": "NO"  
    }  
  ]  
}

# 八、获取警务辖区边界WKT（通过警务辖区代码）

# 8.1 接口基本信息

接口名称：获取警务辖区边界WKT
接口地址：/one-map-server/om/OmStationPro/getStationBoxWktByCode
请求方式：POST
请求数据类型：x-www-form-urlencoded
响应数据类型：application/json
接口描述：通过警务辖区代码获取其地理边界的WKT（Well-Known Text）格式数据，用于地图渲染或空间分析。

# 8.2 请求参数

参数名称	参数说明	请求类型	是否必须	数据类型	示例值	备注
code	警务辖区代码（）	query	必填	string	"652300340200"	从警综获取

# 8.3 响应参数

参数名称	参数说明	类型	示例值	备注
data	WKT格式地理数据	string	`"POLYGON ((82.122...))"`	遵循OGC WKT标准 (opens new window)，通常为多边形数据
其他参数	同通用响应结构（`code`、`alertMsg`等）	-	-	-

# 8.4 响应示例

# 成功响应（单个辖区）

{  
  "code": 200,  
  "data": "POLYGON ((82.12228206032012 43.57758882289106, ...))", // 完整多边形坐标  
  "alertMsg": "操作成功",  
  "alertType": 1  
}

# 失败响应（无空间面数据）

{  
  "code": 500,  
  "data": null,  
  "alertMsg": "该辖区代码（652300340200）无对应的空间面数据",  
  "alertType": 3  
}

# 九、接口补充说明

叶子节点定义：
- 指childHas="NO"的节点，即无任何子节点的末端节点，通常对应具体的警务站、派出所等实体机构。
参数格式注意事项：
- codes参数需传入纯数字代码，多个代码用英文逗号分隔（如"123,456"），禁止包含空格或特殊符号。
- nameLikeStr参数支持中文、英文关键词，默认执行全模糊匹配（等价于SQL的%关键词%）。
业务场景：
- 模糊查询适用于前端搜索框输入名称关键词的场景（如用户输入"朝阳"快速定位相关警务站）。

上次更新: 2025/07/15, 12:26:39

← 警务辖区附件→

警务辖区相关接口

# 一、获取警务辖区子节点（不包含孙节点）

# 1.1 接口基本信息

# 1.2 请求参数

# 1.3 响应参数说明

# OmTreeNode对象属性说明

# 1.4 响应示例

# 二、通过搜索获取警务辖区树（平铺列表）

# 2.1 接口基本信息

# 2.2 请求参数

# 2.3 响应参数

# 2.4 响应示例

# 三、通过搜索获取警务辖区树并构建层级树

# 3.1 接口基本信息

# 3.2 请求参数

# 3.3 响应参数

# 3.4 响应示例

# 四、获取警务辖区边界WKT

# 4.1 接口基本信息

# 4.2 请求参数

# 4.3 响应参数

# 4.4 响应示例

# 成功响应（单个辖区）

# 失败响应（无空间面数据）

# 五、获取警务辖区边界GEOJSON

# 5.1 接口基本信息

# 5.2 请求参数

# 5.3 响应参数

# 5.4 响应示例

# 成功响应（单个辖区）

# 失败响应（ID无效）

# 六、通过代码精确查找当前节点叶子对象

# 6.1 接口基本信息

# 6.2 请求参数

# 6.3 响应参数

# 6.4 响应示例

# 七、通过名称模糊查找当前节点叶子对象

# 7.1 接口基本信息

# 7.2 请求参数

# 7.3 响应参数

# 7.4 响应示例

# 八、获取警务辖区边界WKT（通过警务辖区代码）

# 8.1 接口基本信息

# 8.2 请求参数

# 8.3 响应参数

# 8.4 响应示例

# 成功响应（单个辖区）

# 失败响应（无空间面数据）

# 九、接口补充说明

# `OmTreeNode`对象属性说明