本文介绍在 Android 应用中准确获取目标地理位置（如地面、地形）的海拔高度（即“地形高程”），而非 GPS 返回的设备相对海平面的动态海拔，涵盖调用第三方高程 API 的完整实现方案与关键注意事项。
本文介绍在 android 应用中准确获取目标地理位置（如地面、地形）的海拔高度（即“地形高程”），而非 gps 返回的设备自身相对海平面的动态海拔，涵盖调用第三方高程 api 的完整实现方案与关键注意事项。
在无人机挂载手机等场景中，仅依赖 Location.getAltitude() 获取的海拔值存在本质局限：该值反映的是设备天线中心点相对于 WGS84 椭球面的几何高度，受 GPS 误差、多路径效应及大气延迟影响，通常波动较大（±5–20 米），且无法区分“手机悬停在 100 米高空”与“手机位于海拔 100 米的山顶”——而你的核心需求是判断物体是否“离地飞行”，这必须以下方地形的实际海拔（即大地水准面/EGM96 或 EGM2008 参考下的正高）为基准。
因此，正确解法是：分离“设备定位”与“地形查询”两个步骤——先通过 FusedLocationProviderClient 精确获取经纬度坐标（latitude, longitude），再将该坐标发送至专业的地理高程服务（Elevation API），获取对应位置的地表海拔（Terrain Elevation）。GPS 自带的 altitude 字段在此场景下应被弃用。
✅ 推荐高程数据源与接入方式
| 服务 | 特点 | 接入方式 | 注意事项 |
|---|---|---|---|
| Google Elevation API | 全球覆盖、精度约 1–3 米（SRTM 数据）、商用需配额与计费 | HTTP GET 请求： https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536,-104.9847034&key=YOUR_API_KEY |
需启用 Google Cloud Platform 的 Elevation API；免费额度有限（2500 次/日）；返回 JSON 含 elevation（米）、resolution（数据源网格大小，如 29.8 米） |
| OpenTopoData（开源自托管） | 免费、离线可用、支持 SRTM / NASADEM / COPERNICUS 等多源数据 | 本地部署后调用： https://your-server/v1/srtm30/39.7391536,-104.9847034 |
官网 提供 Docker 一键部署；适合对隐私/稳定性要求高的工业应用；分辨率可选（30m / 90m / 12.5m） |
| NASA Earthdata（高级科研） | 最高 12.5 米分辨率（NASADEM）、全球无偏移 | 需注册 + OAuth 认证，适合批量离线处理 | 不推荐实时移动端调用 |
?️ Android 实战代码示例（集成 OpenTopoData）
以下为在 TimeService 中安全调用高程 API 的精简实现（使用 OkHttp + Gson）：
// 添加依赖（app/build.gradle）
// implementation 'com.squareup.okhttp3:okhttp:4.12.0'
// implementation 'com.google.code.gson:gson:2.10.1'
private void fetchTerrainElevation(double lat, double lon) {
String url = String.format(
"https://api.opentopodata.org/v1/srtm30?locations=%.6f,%.6f",
lat, lon
);
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url(url)
.build();
client.newCall(request).enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
Log.e(TAG, "Elevation API failed", e);
}
@Override
public void onResponse(Call call, Response response) throws IOException {
if (response.isSuccessful()) {
String json = response.body().string();
try {
JsonObject root = JsonParser.parseString(json).getAsJsonObject();
JsonArray results = root.getAsJsonArray("results");
if (results.size() > 0) {
double terrainAlt = results.get(0).getAsJsonObject()
.get("elevation").getAsDouble();
Log.d(TAG, String.format("Terrain elevation: %.2f m", terrainAlt));
// ✅ 此 terrainAlt 即为该经纬度点的地表海拔（单位：米）
// 后续逻辑：if (deviceAltitude - terrainAlt > FLIGHT_THRESHOLD) { ... }
}
} catch (Exception e) {
Log.e(TAG, "Parse elevation error", e);
}
}
}
});
}⚠️ 关键注意事项：
- 切勿在主线程发起网络请求：上述示例使用 OkHttp.enqueue() 异步执行，符合 Android 网络策略；
- 权限与后台限制：Android 8.0+ 对后台服务网络访问有严格限制，建议改用 WorkManager 或前台服务（startForeground()）保障可靠性；
- 缓存与降级：高程数据变化极慢，应对 (lat,lon) 组合做内存/磁盘缓存（如 LRU Cache），避免重复请求；网络不可用时可回退至上次有效值或默认海平面（0m）；
- 精度认知：SRTM 数据在山区/城市峡谷可能存在数米偏差，若需亚米级精度（如精准农业），需结合 RTK-GNSS 或激光雷达（LiDAR）数据。
✅ 总结
获取“地点海拔”本质是地理信息查询任务，而非传感器读取任务。务必摒弃对 Location.getAltitude() 的直接依赖，转而构建“定位 → 坐标提取 → 高程服务查询 → 差值判据”的标准链路。选择服务时，优先评估数据更新频率、空间分辨率、调用成本与合规性——对于大多数消费级无人机应用，OpenTopoData 自托管方案兼具免费性、可控性与实用性；商业项目则推荐 Google Elevation API 作为稳定兜底。
