参考资料

Jmix Map 是一个能显示多数据源的地理地图组件。支持多图层，可以有效地将数据结构化，且支持为每一图层实现不同的业务逻辑。

使用地图时，需要了解两个关键概念：图层 和 数据源。

图层（Layer） - 是一种在地图上组织数据的方法。

图层可以是栅格图层，或矢量图层。栅格层由栅格图像组成，栅格图像是像素矩阵，而矢量层由矢量几何图形组成。

栅格层用于表示底图，矢量层是地图上由一个或多个要素组成的对象，但作为单一对象进行操作。例如，矢量层可能包含描述区域的多边形或表示客户或商店位置的地理点。

地图扩展组件支持下列类型的图层：

图层作为一种包装器，因为显示的数据取决于所使用的 数据源。

数据源是指提供图像来源的服务。此图像通常用作地图的基础背景图层，并提供空间上下文。可以从开源或商业服务（XYZ 瓦片服务或 WMS 服务）提供商获取图像。

投影是指用于在地图上表示和转换地理位置的坐标参考系（CRS）。投影对于准确显示空间数据至关重要，可确保地球表面的位置在地图上正确定位和定向。

地图插件支持各种标准投影，如 EPSG:4326（WGS 84 - 通常用于 GPS 坐标）和 EPSG:3857（Web Mercator（墨卡托） - 由于其保形特性而在在线地图中很受欢迎）。

默认投影为： EPSG:4326。

数据矢量源是包含 地理对象 的源。此数据源可以连接是数据和 地图 UI 组件。它携带数据以及有关地理对象应如何在地图上显示的一些附加信息。

基本上，地理对象（geo-object）是具有几何类型特定属性的实体。此属性存储特定数据，表示点、折线和多边形。Jmix 提供了数据感知组件，可以连接地理对象和地图。

坐标参考系（CRS） 通过一组称为坐标的数字来指定地球上的每个位置。有两组特定的坐标系，第一组是投影坐标系（也称为笛卡尔坐标系或矩形坐标系）和地理坐标系。

地理坐标系使用纬度和经度，有时还使用高度值来描述地球表面上的位置。最流行的是世界大地测量系统 - WGS 84（EPSG:4326）。GPS 设备使用该坐标系来定义地球上的位置。

这是 Jmix 地图组件使用或输出的所有坐标的默认坐标系。

将地图数据投影到平面上后，基于在球体上测量的角度的地理系统（经纬度）将不再有效。此时，平面使用笛卡尔坐标系。当用户在 Jmix 地图组件中输入经度和纬度坐标时，会将地理坐标转换为投影坐标（以米为单位），用于在 GIS 和 WM(T)S 服务中生成栅格瓦片。

标记 可以显示在地图最上层，用于展示兴趣点，例如地址、建筑物、车辆或任何其他实体。标记由坐标和图标定义。

标记可以配置为显示文本，默认情况下，文本显示在标记图标下方。可以通过为标记 自定义 文本的位置和样式。