Flutter for OpenHarmony：maps_toolkit 地理空间计算工具箱，无需地图 SDK 也能玩转 GIS（距离、面积、点线关系） 深度解析与鸿蒙适配指南
欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.ZEEKLOG.net
前言
在地图应用开发中，我们经常需要计算两个坐标点之间的距离（如打车预估）、判断一个点是否在围栏内（电子围栏）、或者计算多边形的面积（地块测量）。虽然 Google Maps 或百度地图 SDK 提供了这些功能，但它们体积庞大且依赖原生/网络。
maps_toolkit 是 Google Maps Android Utility Library 的纯 Dart 移植版。它包含了一系列轻量级、高性能的几何与球面计算算法，完全不依赖任何地图 SDK，即可进行复杂的 GIS 运算。
一、概念介绍/原理解析
1.1 基础概念
- LatLng: 经纬度坐标 (latitude, longitude)。
- SphericalUtil (球面工具): 计算大圆距离 (Haversine)、方位角、插值点。
- PolygonUtil (多边形工具): 判断点在多边形内/外、是否在线段附近、面积计算。
计算距离 (球面曲率)
计算方位角
包含性判定
计算面积
坐标点 A
坐标点 B
多边形区域
坐标点 P
输出结果 (平方米)
1.2 进阶概念
地球不是完美的球体，maps_toolkit 默认采用 WGS84 椭球模型进行近似计算，精度足以满足绝大多数民用场景。
二、核心 API/组件详解
2.1 基础用法
计算两点距离。
import'package:maps_toolkit/maps_toolkit.dart';voidmain(){final p1 =LatLng(39.9042,116.4074);// 北京final p2 =LatLng(31.2304,121.4737);// 上海// 计算直线（大圆）距离，单位：米final distance =SphericalUtil.computeDistanceBetween(p1, p2);print('距离: ${(distance /1000).toStringAsFixed(2)} km');// ~1067 km}
2.2 电子围栏判定
判断用户位置是否在指定区域内。
bool checkGeofence(LatLng user,List<LatLng> polygon){// geodesic: true 表示考虑地球曲率（更精确），false 视为平面returnPolygonUtil.containsLocation(user, polygon,true);}
2.3 面积计算
double area =SphericalUtil.computeArea(polygonPoints);print('面积: $area 平方米');
三、常见应用场景
3.1 场景 1：打卡签到
判断员工 GPS 坐标是否在公司大楼圆心 100 米范围内。
bool canCheckIn(LatLng userPos,LatLng officePos){// 计算两点间距离（单位：米）final distance =SphericalUtil.computeDistanceBetween(userPos, officePos);return distance <=100;// 100米内允许打卡}3.2 场景 2：共享单车禁停区
判断停车点是否位于红色的多边形禁停区内。
bool isForbiddenParking(LatLng bikePos){// 定义禁停区域（多边形顶点）final forbiddenZone =[LatLng(39.90,116.30),LatLng(39.91,116.30),LatLng(39.91,116.31),LatLng(39.90,116.31),];// true 表示测地线模式（考虑地球曲率）returnPolygonUtil.containsLocation(bikePos, forbiddenZone,true);}3.3 场景 3：运动轨迹平滑
收到一系列稀疏的 GPS 点，利用插值算法（Interpolate）补充中间点，使路线更平滑。
List<LatLng>smoothPath(LatLng start,LatLng end){List<LatLng> path =[];// 在起点和终点之间插值 10 个点for(double f =0; f <=1.0; f +=0.1){ path.add(SphericalUtil.computeOffset(start,0,0));// 注意：maps_toolkit 的插值通常用 interpolate// 修正：使用 interpolate 方法 path.add(SphericalUtil.interpolate(start, end, f));}return path;}四、OpenHarmony 平台适配
4.1 纯 Dart 实现
完全无原生依赖。
4.2 坐标系转换
国内地图常通过 GCJ-02 (火星坐标) 或 BD-09 (百度坐标) 加密。maps_toolkit 基于标准 WGS-84。如果输入源是高德/百度，务必先转换为 WGS-84，否则计算偏差可能达数百米。虽然库本身未内置转换，但社区有很多 Dart 实现。
五、完整示例代码
本示例构建一个简单的地理工具箱，包含距离计算器和围栏检测器。
import'package:flutter/material.dart';import'package:maps_toolkit/maps_toolkit.dart';voidmain(){runApp(constMaterialApp(home:GeometryPage()));}classGeometryPageextendsStatefulWidget{constGeometryPage({super.key});@overrideState<GeometryPage>createState()=>_GeometryPageState();}class _GeometryPageState extendsState<GeometryPage>{// 模拟故宫多边形围栏 (简化版)finalList<LatLng> _forbiddenZone =[LatLng(39.9221,116.3908),// 西北LatLng(39.9221,116.4025),// 东北LatLng(39.9130,116.4025),// 东南LatLng(39.9130,116.3908),// 西南];final _userPos =LatLng(39.9160,116.3970);// 在故宫内final _testDistPos =LatLng(39.9087,116.3975);// 天安门广场 (南侧)String _status ='';String _distanceInfo ='';@overridevoidinitState(){super.initState();_check();}void_check(){// 1. 围栏检测 bool inside =PolygonUtil.containsLocation(_userPos, _forbiddenZone,true);// 2. 距离计算 num dist =SphericalUtil.computeDistanceBetween(_userPos, _testDistPos);setState((){ _status = inside ?'⚠️ 在禁飞区内 (故宫)':'✅ 安全区域'; _distanceInfo ='距天安门广场: ${dist.toStringAsFixed(1)} 米';});}@overrideWidgetbuild(BuildContext context){returnScaffold( appBar:AppBar(title:constText('GIS 工具箱')), body:Center( child:Column( mainAxisAlignment:MainAxisAlignment.center, children:[constIcon(Icons.map, size:80, color:Colors.blue),constSizedBox(height:20),Text('当前位置: ${_userPos.latitude}, ${_userPos.longitude}'),constSizedBox(height:10),Container( padding:constEdgeInsets.all(16), color: _status.contains('⚠️')?Colors.red[100]:Colors.green[100], child:Text(_status, style:constTextStyle(fontSize:20, fontWeight:FontWeight.bold)),),constSizedBox(height:20),Text(_distanceInfo),constSizedBox(height:40),Text('围栏面积: ${SphericalUtil.computeArea(_forbiddenZone).toStringAsFixed(0)} m²', style:constTextStyle(color:Colors.grey),),],),),);}}
六、总结
maps_toolkit 剥离了地图 SDK 中最通用的数学部分。如果你的应用只需后台判断位置关系而不需要展示地图（如地理围栏服务），它是最佳选择。
最佳实践：
- 坐标系：始终明确你使用的坐标系（WGS84 vs GCJ02）。
- 精度：对于小范围（如室内），平面几何计算可能比球面计算更快且误差可忽略；但跨城市必须用球面计算。
- 多边形简化：围栏点数过多会影响性能，可用道格拉斯-普克算法（Douglas-Peucker）简化轨迹。
