
本文介绍在 spring boot 项目中,不依赖 google maps api 即可实现经纬度逆地理编码的方法,推荐使用免密、开源的 free geocoding api(geocode.maps.co),并提供完整 java 示例代码及关键注意事项。
本文介绍在 spring boot 项目中,不依赖 google maps api 即可实现经纬度逆地理编码的方法,推荐使用免密、开源的 free geocoding api(geocode.maps.co),并提供完整 java 示例代码及关键注意事项。
在开发 Telegram Bot 等轻量级应用时,常需根据用户上报的经纬度(latitude/longitude)快速解析出所在城市与国家。虽然 Google Maps Geocoding API 功能强大,但其严格的密钥校验、配额限制和启用流程对原型验证或个人项目并不友好。幸运的是,存在稳定、免费且无需注册的替代方案——Geocode Maps(基于 OpenStreetMap 的开源地理编码服务),支持反向地理编码(reverse geocoding),且完全免 API Key。
以下是一个适用于 Spring Boot 环境的简洁 Java 实现(JDK 11+),使用标准 java.net.http 客户端与 Jackson 解析 JSON 响应:
Google Workspace MCP 服务器通过任何支持 MCP 的 AI 助手,提供对 Gmail、Google Calendar、Drive、Docs、Sheets、Slides、Forms、Tasks、Contacts 和 Chat 的全面自然语言控制。它支持 OAuth 2.1 多用户认证,并包含用于编码代理的 CLI。
import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.time.Duration;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
public class ReverseGeocoder {
private static final String GEOCODING_URL = "https://www.php.cn/link/8dcf968c43d65050f537016585c1aa15reverse";
private static final ObjectMapper mapper = new ObjectMapper();
/**
* 根据经纬度获取城市与国家名称
* @param lat 纬度(字符串格式,如 "40.7558017")
* @param lon 经度(字符串格式,如 "-73.9787414")
* @return 包含 city 和 country 的格式化字符串,失败时返回空字符串
*/
public static String getLocationByCoordinates(String lat, String lon) {
try {
String response = reverseGeocode(lat, lon);
JsonNode root = mapper.readTree(response);
JsonNode address = root.path("address");
String city = address.has("city") ? address.get("city").asText().trim() :
(address.has("town") ? address.get("town").asText().trim() :
(address.has("village") ? address.get("village").asText().trim() : ""));
String country = address.has("country") ? address.get("country").asText().trim() : "";
return String.format("%s, %s",
city.isEmpty() ? "Unknown city" : city,
country.isEmpty() ? "Unknown country" : country
);
} catch (Exception e) {
System.err.println("Reverse geocoding failed: " + e.getMessage());
return "Location unavailable";
}
}
private static String reverseGeocode(String lat, String lon) throws IOException, InterruptedException {
HttpClient client = HttpClient.newBuilder()
.connectTimeout(Duration.ofSeconds(3))
.build();
String uri = GEOCODING_URL + "?lat=" + lat + "&lon=" + lon;
HttpRequest request = HttpRequest.newBuilder()
.GET()
.uri(URI.create(uri))
.timeout(Duration.ofSeconds(5))
.header("User-Agent", "SpringBoot-TelegramBot/1.0")
.build();
HttpResponse<String> response = client.send(request, BodyHandlers.ofString());
if (response.statusCode() != 200) {
throw new RuntimeException("HTTP " + response.statusCode() + ": " + response.body());
}
return response.body();
}
// 示例调用
public static void main(String[] args) throws IOException, InterruptedException {
System.out.println(getLocationByCoordinates("40.7558017", "-73.9787414")); // New York, United States of America
System.out.println(getLocationByCoordinates("35.6895", "139.6917")); // Tokyo, Japan
}
}✅ 关键优势与注意事项:
- 零配置启动:无需申请密钥、无需 OAuth,开箱即用;
-
响应结构清晰:
address.city是首选字段,若缺失可降级尝试town或village(尤其适用于乡村地区); - 健壮性建议:务必添加超时控制(示例中设为 3–5 秒)、异常捕获及空值防护,避免因网络或数据缺失导致 Bot 崩溃;
- 生产环境提醒:虽该服务目前稳定且提供 合理配额,但长期商用仍建议自行部署 Nominatim 或申请合规 API 密钥以保障 SLA;
- 隐私合规:Geocode Maps 不存储原始请求坐标,符合 GDPR 基本要求,适合 Telegram Bot 等用户数据敏感场景。
通过以上方式,你可在 Spring Boot 项目中快速集成轻量、可靠、合规的逆地理编码能力,让 Telegram Bot 真正“读懂”用户所处的世界。

















