AssetsMap/assetsMap/boundary-doc.md

资产边界数据配置说明

数据格式

边界数据存储在表单字段 "资产边界数据" 中，格式为 JSON 字符串。

整体结构

{
  "regions": [ 区域1, 区域2, ... ],
  "color": "#ff0000"
}

字段	类型	说明
regions	数组	区域列表，每个区域是一个独立的外圈（可带孔洞）
color	字符串	边界颜色，十六进制色值，如 #ff0000（红色）、#3498db（蓝色）

单个区域结构

{
  "id": 1780905134732976,
  "outer": [ 坐标点1, 坐标点2, ... ],
  "holes": [ 孔洞1, 孔洞2, ... ]
}

字段	类型	说明
id	数字	区域唯一标识（系统自动生成的随机整数），手动配置时可随意填一个不重复的数字
outer	数组	外圈边界坐标，至少 3 个点
holes	数组	孔洞列表，每个孔洞也是一个坐标数组（至少 3 个点），可为空数组 []

坐标格式

每个坐标点为 [纬度, 经度]，注意顺序是 纬度在前，经度在后。

示例：[30.68239, 111.31176]

配置示例

1. 单个简单区域（无孔洞）

{
  "regions": [
    {
      "id": 100001,
      "outer": [
        [30.68, 111.31],
        [30.69, 111.38],
        [30.74, 111.38],
        [30.74, 111.34],
        [30.74, 111.30],
        [30.71, 111.28]
      ],
      "holes": []
    }
  ],
  "color": "#ff0000"
}

2. 单个区域带一个孔洞

{
  "regions": [
    {
      "id": 100002,
      "outer": [
        [30.68, 111.31],
        [30.69, 111.38],
        [30.74, 111.38],
        [30.74, 111.30],
        [30.71, 111.28]
      ],
      "holes": [
        [
          [30.70, 111.33],
          [30.72, 111.37],
          [30.73, 111.35],
          [30.72, 111.32]
        ]
      ]
    }
  ],
  "color": "#ff0000"
}

3. 多个独立区域

{
  "regions": [
    {
      "id": 100003,
      "outer": [
        [30.68, 111.31],
        [30.69, 111.38],
        [30.74, 111.38],
        [30.71, 111.28]
      ],
      "holes": []
    },
    {
      "id": 100004,
      "outer": [
        [30.68, 111.43],
        [30.67, 111.50],
        [30.74, 111.52],
        [30.75, 111.44],
        [30.71, 111.39]
      ],
      "holes": [
        [
          [30.69, 111.45],
          [30.72, 111.50],
          [30.74, 111.48],
          [30.72, 111.41]
        ]
      ]
    }
  ],
  "color": "#ff0000"
}

注意事项

1. 坐标顺序：必须是 [纬度, 经度]，即 [lat, lng]
2. 最少点数：每个外圈和孔洞至少需要 3 个坐标点
3. 孔洞范围：孔洞必须完全位于其所属外圈内部
4. 区域 ID：id 为任意不重复的数字，建议使用时间戳+随机数
5. 颜色值：支持标准十六进制格式，如 #ff0000、#3498db、#27ae60
6. 多区域共用一个颜色：所有区域使用同一个 color 值
7. 字段名称：存储在表单字段 "资产边界数据" 中

坐标获取方式

推荐使用坐标拾取工具获取经纬度：

• 高德坐标拾取器：https://lbs.amap.com/tools/picker
• 百度坐标拾取器：https://api.map.baidu.com/lbsapi/getpoint/index.html

在地图上依次点击区域顶点，复制坐标填入即可。