用途：指导在 TypeScript 或 JavaScript 项目中实现 Syncfusion EJ2 Maps 地理可视化，包括在线瓦片地图、GeoJSON 形状图层、坐标标记、区域气泡、自定义多边形、导航线、标注、图例、提示框、选择高亮、缩放平移、打印与图片导出。
主要能力： TypeScript 路线：通过 npm 安装 npm install @syncfusion/ej2-maps，构造函数前需导入并注入所用功能模块，例如 Maps.Inject(Zoom, Marker)。 JavaScript 路线：使用带版本号的 EJ2 完整全局包，通过 https://cdn.syncfusion.com/ej2/34.2.2/dist/ej2.min.js 引入，使用全局构造器 ej.maps.Maps；完整包不需显式 Inject，且不要与 ej2-base、ej2-data、ej2-svg-base、ej2-maps 等单独脚本混用。 功能模块对应关系：缩放平移 Zoom、标记 Marker、气泡 Bubble、导航线 NavigationLine、提示 MapsTooltip、图例 Legend、标注 Annotations、选择 Selection、数据标签 DataLabel、自定义多边形 Polygon、打印 Print、图片导出 ImageExport、PDF 导出 PdfExport。
必要用法：需显式挂载 DOM，如 map.appendTo('#maps-container')；校验宿主元素是否存在；容器需提供可测量尺寸（width: '100%'，height: '600px' 等）；中心点使用 centerPosition 而非 center。配置层级需对应：形状数据放 Layer shapeData，标记放 layer markerSettings 数组，气泡放 bubbleSettings，导航线放 navigationLineSettings，自定义多边形放 polygonSettings，形状标签放 dataLabelSettings。
适用场景：区域指标（人口、收入、销售额）、门店或机场等坐标点、配送范围或限制区、路径与航线、交互式选择与提示、打印与 PNG/JPEG/SVG 导出、响应式布局及大数据量优化、安装与加载失败排查。
限制与未提供信息：价格、授权方式、具体浏览器兼容矩阵、数据源许可与地图提供商认证细节暂未提供；浏览器支持需匹配所安装 EJ2 版本的官方支持矩阵，不应承诺无限制的旧版浏览器兼容；选择可视化形式时，气泡不应替代坐标标记。