Java 地图组件平台 (Java MCP)

基于 Spring Boot 的 Java 地图组件平台，提供包括地理编码、逆地理编码、天气查询、POI 搜索、路径规划等地图服务功能。

功能特性

• 地理编码/逆地理编码：地址与经纬度的互相转换
• 天气查询：根据城市名称或 adcode 查询天气信息
• POI 搜索：关键词搜索、周边搜索、POI 详情查询
• 路径规划：支持步行、骑行、驾车、公共交通等多种出行方式
• IP 定位：根据 IP 地址获取位置信息
• 距离测量：计算两点间直线距离、驾车距离或步行距离

技术栈

• Java 17
• Spring Boot 3.4.4
• Spring Data JPA
• H2 数据库
• Jackson JSON
• RESTful API

快速开始

环境要求

• JDK 17+
• Maven 3.6+

获取项目

git clone [repository-url]
cd java-mcp-server

配置

在 src/main/resources/application.properties 中配置高德地图 API Key：

amap.key=your_amap_key_here

构建与运行

mvn clean package
java -jar target/demo-0.0.1-SNAPSHOT.jar

或直接使用 Maven 运行：

mvn spring-boot:run

服务启动后，访问 http://localhost:8080 即可。

API 接口说明

集成接口（/api/mcp/）

接口路径	方法	描述	参数
/status	GET	获取系统状态信息	-
/geo	GET	地理编码（地址转坐标）	address, city(可选)
/regeo	GET	逆地理编码（坐标转地址）	location(格式：经度,纬度)
/ip	GET	IP 定位	ip(可选)
/weather	GET	天气查询	city
/search	GET	POI 搜索	keywords, city(可选), types(可选)
/around	GET	周边搜索	location, radius(可选), keywords(可选)
/detail	GET	POI 详情	id
/walking	GET	步行路径规划	origin, destination
/bicycling	GET	骑行路径规划	origin, destination
/driving	GET	驾车路径规划	origin, destination
/transit	GET	公共交通路径规划	origin, destination, city, cityd(可选)
/distance	GET	测量距离	origins, destination, type(可选)

独立接口

各功能模块也提供了独立的 API 接口，详见：

• 位置服务：/api/location/
• 天气服务：/api/weather/
• POI 服务：/api/poi/
• 路径规划：/api/route/
• IP 定位：/api/ip/

开发指南

项目结构

src/main/java/com/example/demo/
├── controller/  # 控制器层
├── model/       # 数据模型层
├── service/     # 服务层
└── DemoApplication.java  # 程序入口

扩展指南

要添加新的地图服务功能，请按照以下步骤操作：

1. 在 model 包中创建相应的实体类
2. 在 service 包中实现服务逻辑
3. 在 controller 包中创建控制器并提供 API 接口
4. 在 McpController 中集成新功能

许可证

MIT License