用途:在 ArcGIS Maps SDK for JavaScript 中处理坐标系、投影变换、空间参考与坐标格式转换,并在地图上显示多种格式的位置。
主要能力:使用 projectOperator 做客户端投影,支持地理变换步骤与保形投影 shapePreservingProjectOperator;用 SpatialReference 按 WKID 或 WKT 定义空间参考;用 coordinateFormatter 在经纬度(dd/dm/dms)、MGRS、UTM、USNG 之间互转;用 webMercatorUtils 做 Web Mercator 与地理坐标互转;用 CoordinateConversion 组件或微件展示坐标,并支持自定义格式;复杂投影可调用 geometryService.project() 服务端处理;大地测量距离、面积、长度由 geodeticDistanceOperator、geodeticAreaOperator、geodeticLengthOperator 计算。
使用方式:按 ESM 直接导入或通过 $arcgis.import 动态导入模块。使用前需 await projectOperator.load()、await coordinateFormatter.load()。示例:await projectOperator.load(); const projected = projectOperator.execute(geometry, { wkid: 4326 }); 坐标转换示例:coordinateFormatter.toUtm(point, "north-south-indicators", true)。
适用场景:坐标格式展示、鼠标位置多格式显示、CSV 图层投影、客户端几何投影、跨基准投影等。
限制与注意:projection 模块(4.32 起弃用)与 geodesicUtils(4.33 起弃用)已在 v5.0 移除,需改用 projectOperator 与大地测量算子;SDK 中地理坐标为(经度, 纬度),Point 的 x 为经度、y 为纬度;有 WKID 时优先用 WKID,仅自定义坐标系用 WKT;跨基准投影应提供地理变换,否则可能有米级偏差;客户端投影更快,服务端仅用于客户端无法处理的复杂变换。其余收费、平台与效果信息暂未提供。