Geodesy 地理计算库终极使用指南：从安装到实战应用-平芜编程栈

Geodesy 地理计算库终极使用指南：从安装到实战应用

【免费下载链接】geodesyLibraries of geodesy functions implemented in JavaScript项目地址: https://gitcode.com/gh_mirrors/ge/geodesy

Geodesy 是一个功能强大的 JavaScript 地理计算库，专门用于处理地球表面的坐标计算、距离测量、方位计算等地理信息系统功能。无论你是开发地图应用、导航系统，还是需要进行地理位置分析，这个库都能提供精确而高效的计算支持。

🌍 项目核心功能概览

Geodesy 库提供了丰富的地理计算功能，主要分为三大类：

基础计算功能：

球面地球模型下的简单三角函数计算
椭球体地球模型下的精确地理计算
基于向量的地理坐标处理

坐标转换功能：

UTM 坐标与 MGRS 网格参考系统转换
英国军械测量局 (OSGB) 国家网格参考系统
地理坐标与笛卡尔坐标相互转换

数据转换支持：

历史基准面转换（如 NAD83、OSGB36、Irl1975 等）
现代参考框架转换（如 ITRF2014、ETRF2000、GDA94 等）

📦 快速安装部署指南

浏览器环境使用

在 HTML 页面中直接引入 Geodesy 库：

<script type="module"> import LatLon from './latlon-spherical.js'; const p1 = new LatLon(50.06632, -5.71475); const p2 = new LatLon(58.64402, -3.07009); const distance = p1.distanceTo(p2); console.log('两点距离：', distance + '米'); </script>

Node.js 环境安装

通过 npm 安装 Geodesy 库：

npm install geodesy

然后在你的 Node.js 项目中使用：

import { default as LatLon } from 'geodesy/latlon-spherical.js'; const point1 = new LatLon(51.5074, -0.1278); // 伦敦 const point2 = new LatLon(48.8566, 2.3522); // 巴黎 const distance = point1.distanceTo(point2);

🚀 实战应用场景演示

场景一：计算两地直线距离

import LatLon from './latlon-spherical.js'; // 定义两个地理位置 const london = new LatLon(51.5074, -0.1278); const paris = new LatLon(48.8566, 2.3522); // 计算距离 const distance = london.distanceTo(paris); console.log(`伦敦到巴黎的距离：${(distance/1000).toFixed(2)}公里`);

场景二：坐标格式转换

import LatLon from './latlon-spherical.js'; import Dms from './dms.js'; const location = new LatLon(51.5074, -0.1278); // 转换为度分秒格式 const dmsFormat = location.toString('dms'); console.log('坐标度分秒格式：', dmsFormat);

场景三：UTM 坐标转换

import Utm from './utm.js'; // 解析 UTM 坐标 const utmCoord = Utm.parse('48 N 377298.745 1483034.794'); const latLonCoord = utmCoord.toLatLon(); console.log('UTM 转经纬度：', latLonCoord.toString());

🔧 高级功能应用

椭球体模型精确计算

对于需要更高精度的应用场景，可以使用椭球体地球模型：

import LatLon from './latlon-ellipsoidal-vincenty.js'; const startPoint = new LatLon(-37.95103, 144.42487); const distance = 54972.271; const bearing = 306.86816; const endPoint = startPoint.destinationPoint(distance, bearing); console.log('目的地坐标：', endPoint.toString());

多边形区域判断

判断一个点是否位于多边形区域内：

import LatLon from './latlon-nvector-spherical.js'; // 定义多边形边界点 const polygon = [ new LatLon(48, 2), new LatLon(49, 2), new LatLon(49, 3), new LatLon(48, 3) ]; const testPoint = new LatLon(48.9, 2.4); const isInside = testPoint.isEnclosedBy(polygon); console.log('点是否在多边形内：', isInside);

📊 项目文件结构解析

geodesy/ ├── dms.js # 度分秒转换工具 ├── latlon-spherical.js # 球面坐标计算 ├── latlon-ellipsoidal.js # 椭球体坐标计算 ├── latlon-ellipsoidal-vincenty.js # Vincenty 算法实现 ├── utm.js # UTM 坐标系统 ├── mgrs.js # MGRS 网格参考系统 ├── osgridref.js # OS 网格参考系统 └── vector3d.js # 3D 向量操作