docs/docs/cn/interface-builder/blocks/data-blocks/map.md
地图区块用于把数据表里的地理信息展示在地图上，适用于门店位置、客户地址、设备分布、路线轨迹、区域管理等场景。
地图区块支持高德地图和 Google Maps。它可以展示点、线、多边形、圆等地图字段，也可以通过地图覆盖物打开记录视图，或配合区块操作处理数据。
地图区块由内置插件 @nocobase/plugin-map 提供。添加区块前，需要先启用该插件。
启用插件后，进入「插件配置 / 地图管理」配置地图服务：
Access key，以及 securityJsCode 或 serviceHostApi key如果地图无法加载，可以先检查 key 是否正确、域名白名单是否包含当前访问域名，以及浏览器是否能访问对应地图服务。
添加地图区块前，需要先在目标数据表中创建至少一个地图字段。你可以在「基于地图的几何图形」分组下选择字段类型。
| 字段类型 | 用途 |
|---|---|
| 点 | 标记单个位置，比如门店、设备、客户地址 |
| 线 | 表示路线或轨迹 |
| 多边形 | 表示区域范围 |
| 圆 | 表示以某个点为中心的半径范围 |
创建字段时需要选择「地图类型」。这个配置决定字段编辑和区块展示时使用高德地图还是 Google Maps。
进入页面配置模式后，点击「添加区块」，在「数据区块」里选择「地图」。
创建区块时需要配置：
如果数据表中没有可用的地图字段，「地图字段」选择器会为空。需要先回到数据表配置里添加点、线、多边形或圆字段。
用于切换区块展示的地图字段，以及点位标签字段。
标记字段只对点字段生效，通常选择名称、地址、编号等文本字段。
用于限制地图区块中展示的记录。
地图区块会加载符合数据范围的所有记录，不走分页。数据量较大时，建议先配置「数据范围」，或者通过筛选操作缩小展示范围。
更多说明请参考：设置数据范围
用于对点位记录排序，并按顺序连接成线路。
该配置只在地图字段为「点」时生效。
用于设置地图初始化时的缩放级别。
地图区块支持在区块顶部添加操作，比如：
点击地图覆盖物时，会触发记录打开流程，通常用于打开弹窗、抽屉或其他记录视图。
地图区块左上角提供选择工具：
选中的记录会同步到区块资源，后续可以配合区块操作处理这些记录。