farhan reza

在构建基于位置的 Web 应用时，开发者通常默认使用 Haversine 公式来计算两个 GPS 坐标之间的距离和方位角。对于大多数应用，假设地球是一个完美的球体就“足够好了”。

但如果你正在构建一个绝对精度不可妥协的应用呢？

在构建 Quranbookk 的 Qibla Finder——一个帮助全球穆斯林找到麦加克尔白确切方向的 Web 应用时，我很快意识到标准的球面数学引入了不可接受的误差。

以下是我抛弃 Haversine 并使用 Next.js 和 Karney 测地线算法实现亚毫米级精确解决方案的原因。

Haversine 公式的问题

Haversine 公式计算地球表面的最短距离，但它假设地球是一个完美的球体。现实中，地球是一个扁球体（赤道更宽，两极更扁平）。

当从全球各地（比如北美或北欧）计算到麦加的方位角时，这种“球面假设”可能导致几度的误差。当构建一个用户依赖绝对精度的宗教工具时，偏差几度在用户体验和信任上都是巨大的失败。

引入 Karney 测地线算法

为此，我转而使用 WGS84 椭球模型和 Charles Karney 的测地线算法。Karney 的算法不是在完美球体上划线，而是在椭球表面计算两点间的最短路径。

数学复杂度显著更高，涉及椭圆积分，但结果是方位角和距离计算精确到毫米以下。

在 Next.js 中实现

由于我构建的是现代 Web 平台，性能至关重要。我使用 Next.js 15 App Router 构建应用。

为了在不增加客户端包体积的情况下处理繁重计算，繁重的测地线计算可以动态处理。在客户端，我结合了 HTML5 Geolocation API 和 DeviceOrientation 事件来读取设备的磁力计。

// A simplified conceptual approach
import { Geodesic } from 'geographiclib-geodesic';

export function calculatePreciseBearing(lat, lng, destinationLat, destinationLng) {
  const geod = Geodesic.WGS84;
  const r = geod.Inverse(lat, lng, destinationLat, destinationLng);

  // r.azi1 gives the precise forward azimuth (bearing)
  return r.azi1; 
}

Enter fullscreen mode Exit fullscreen mode

结果

通过将 Karney 算法与 Next.js 边缘性能相结合，生成的指南针极其轻量，完全在浏览器中运行（无需下载移动应用），并提供超过大多数原生应用的数学精度。

如果你正在构建对位置要求严格的应用，请停止默认使用 Haversine。数学稍难一些，但精度值得。你可以在我的平台上查看实时实现：Qibla Finder - Quranbookk。