算两点间球面距离,这个Java地理工具类有6个方法

简介: 这是一个基于Haversine公式的轻量级地理坐标工具类,支持计算球面距离(km/m)、半径内判断、方位角推算终点、坐标校验与封装等功能,适用于LBS场景,要求JDK 17+,代码简洁健壮、边界清晰、开箱即用。(239字)

📋 目录

一、工具类功能

算两个经纬度点之间的球面距离(千米或米)、判断目标点落不落在给定半径的圆内、从起点沿方位角推出新坐标,按 Haversine 与地球平均半径算,不含高程也不做椭球修正。

二、所需环境

JDK 17或以上

三、方法与调用示例(按需调用)

🔢 方法序号:1

🎯 方法用途:

  • 算两个经纬度点之间的球面距离,单位千米
  • 门店与用户的远近、仓配距离展示这类场景用

🧩 方法定义:public static double distanceKm(double lng1, double lat1, double lng2, double lat2)

🗣️ 入参解释:public static double distanceKm(点1经度, 点1纬度, 点2经度, 点2纬度)

📤 返回值解释:double,两点间的球面大圆距离,单位千米

💡 边界口径:

  • Haversine 公式,地球按平均半径 6371.0088 千米的正球体处理,不含高程、不做椭球修正
  • 参数顺序统一经度在前、纬度在后,单位是度
  • 坐标非法抛 IllegalArgumentException,消息里带上是哪一个点和原值
  • 对映点的中间量已夹逼到 0 到 1,不会因浮点误差算出 NaN

🧪 方法示例:

  • 门店到用户 distanceKm(storeLng, storeLat, userLng, userLat) 拿到 1.9 千米
  • 门店到上海仓拿到 1067.3 千米
  • 点1纬度给 91 度抛 点1经纬度非法: lng=0.0, lat=91.0
  • 点2经度给 181 度抛 点2经纬度非法: lng=181.0, lat=1.0

🔢 方法序号:2

🎯 方法用途:

  • 同两点距离但以米为单位,省掉调用方再乘 1000
  • 配送半径、步行范围这类米级判断用它

🧩 方法定义:public static double distanceMeter(double lng1, double lat1, double lng2, double lat2)

🗣️ 入参解释:public static double distanceMeter(点1经度, 点1纬度, 点2经度, 点2纬度)

📤 返回值解释:double,两点间距离,单位米

💡 边界口径:

  • 与 distanceKm 同一套算法与校验,只是单位换算
  • 不做四舍五入,展示位数由调用方控制
  • 坐标非法同样抛 IllegalArgumentException

🧪 方法示例:

  • 同一对点换算成米 distanceMeter(...) 拿到 1871.7 米,与 1.9 千米同源

🔢 方法序号:3

🎯 方法用途:

  • 判断目标点是否落在以中心点为圆心的半径圆内
  • 「附近 3 公里」「是否在配送范围」这类判断直接用它

🧩 方法定义:public static boolean withinRadius(double centerLng, double centerLat, double targetLng, double targetLat, double radiusM)

🗣️ 入参解释:public static boolean withinRadius(中心点经度, 中心点纬度, 目标点经度, 目标点纬度, 半径米)

📤 返回值解释:boolean,目标点在半径内返回 true

💡 边界口径:

  • 边界算在圈内,半径恰好等于两点距离时返回 true
  • 半径必须大于 0,给 0 或负数抛 IllegalArgumentException
  • 半径给 NaN 不抛异常,一律判不在范围内,这是与坐标校验不同的口径
  • 中心点或目标点坐标非法抛异常,消息点名是哪一个点

🧪 方法示例:

  • 半径 3000 米时用户在圈内拿到 true
  • 同样半径下上海用户拿到 false,超出范围
  • 半径恰好等于两点距离时拿到 true,边界算在圈内
  • 半径比距离小 1 米拿到 false
  • 半径给 NaN 时拿到 false,不抛异常
  • 半径给 0 抛 半径必须大于0,当前为0.0

🔢 方法序号:4

🎯 方法用途:

  • 从起点按方位角走一段距离,推出终点坐标
  • 画包围盒、生成航线中间点、按方向偏移查询中心时用

🧩 方法定义:public static LatLng destination(double lng, double lat, double distanceM, double azimuth)

🗣️ 入参解释:public static LatLng destination(起点经度, 起点纬度, 移动距离米, 方位角)

📤 返回值解释:LatLng,终点坐标的具名记录

💡 边界口径:

  • 方位角以度计,正北为 0,超出 0 到 360 时按三角函数周期性自动等效
  • 结果经度统一归一化到 -180 到 180,跨过 180 度经线不会给出越界值
  • 距离为负、方位角为无穷大都抛 IllegalArgumentException
  • 起点坐标非法抛异常,消息里点明是起点

🧪 方法示例:

  • 从门店向正北走 100 公里拿到 经度 116.4074 纬度 40.8035,再反算距离正好是 100000.0 米
  • 从东经 179 度向正东走 1000 公里,跨过 180 度经线后拿到 -172.0068 纬度 0.0,经度已归一化
  • 配送圈 5 公里的北方向包围点拿到 经度 116.4074 纬度 39.94917
  • 同一个圈的东、南、西三个包围点分别是 经度 116.46602 纬度 39.90419、经度 116.4074 纬度 39.85923、经度 116.34878 纬度 39.90419
  • 距离给负数抛 移动距离不能为负,方位角给无穷大抛 方位角必须为有限值,当前为Infinity
  • 起点经度给 NaN 抛 起点经纬度非法: lng=NaN, lat=0.0

🔢 方法序号:5

🎯 方法用途:

  • 判断一组经纬度是否在合法区间内
  • 入库前校验、接口入参体检用,避免把非法坐标喂进距离计算

🧩 方法定义:public static boolean isValid(double longitude, double latitude)

🗣️ 入参解释:public static boolean isValid(经度, 纬度)

📤 返回值解释:boolean,经度在 -180 到 180 且纬度在 -90 到 90 返回 true

💡 边界口径:

  • 明确拒绝 NaN,无穷大因区间比较恒不成立同样被拒
  • 只判区间,不判这个坐标是否真的存在地面上的某处
  • 参数是基本类型,本方法不抛异常

🧪 方法示例:

  • 正常坐标 isValid(116.4074, 39.9042) 拿到 true
  • 纬度 91 度拿到 false
  • 经度给 NaN 拿到 false

🔢 方法序号:6

🎯 方法用途:

  • 手工装配一个经纬度点,作为具名记录在方法间传递
  • 存包围盒、把 destination 的结果与自造点混用时用它

🧩 方法定义:public record LatLng(double longitude, double latitude)

🗣️ 入参解释:public record LatLng(经度, 纬度)

📤 返回值解释:LatLng,不可变的坐标记录

💡 边界口径:

  • 用字段名取代 double[] 的下标,避免经度纬度顺序写反
  • 是 record,同坐标的两份对象判等成立
  • 构造时不做区间校验,要判合法请显式调 isValid
  • 距离与方位角方法返回的就是它

🧪 方法示例:

  • new LatLng(116.4, 39.9) 拿到 LatLng[longitude=116.4, latitude=39.9]
  • 取分量分别是 经度 116.4、纬度 39.9

四、工具类源码(可直接复制)

📦 源码文件

相关文章
|
17天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
7079 53
|
4天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
5天前
|
云安全 人工智能 安全
|
17天前
|
JavaScript API iOS开发
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(DSH)是DeepSeek于2026年开源的MIT协议AI Agent框架,支持插件化组装模型、工具、沙箱与UI,兼容主流大模型。本文提供免Node.js的桌面端安装包(Win/macOS),含详细图文教程及热门插件推荐。
5486 65
|
12天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
2764 9
|
4天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
9天前
|
人工智能 安全 API
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(dsh)是DeepSeek AI于2026年开源的轻量级Agent运行框架,基于Cordis内核,践行“一切皆插件”理念。支持Web/桌面双端,开箱即用;内置多模型接入、丰富插件生态(超3.5万),适配编程、办公、创作等场景。(239字)
1792 1
|
2天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
1209 0
|
8天前
|
人工智能 iOS开发 开发者
2026年 Codex 下载地址更新:codexdown.cn 已更换为 codexdown.cc(附 Codex 客户端下载)
2026年Codex官方下载站已由codexdown.cn正式迁移至codexdown.cc,提供Windows/macOS最新客户端、历史版本、安装教程及配置指南,开发者可一站式获取稳定、安全、签名验证的AI编程工具资源。(239字)
1640 0