🚀 基于Spring Boot的Java地图组件平台（Java MCP）
本平台提供了丰富的地图相关功能，如地理编码、天气查询、POI搜索等，借助Spring Boot框架，可帮助开发者快速集成地图服务。
🚀 快速开始
环境要求
- 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 即可。
✨ 主要特性
- 地理编码/逆地理编码：实现地址与经纬度的互相转换。
- 天气查询：可根据城市名称或adcode查询天气信息。
- POI搜索：支持关键词搜索、周边搜索、POI详情查询。
- 路径规划：支持步行、骑行、驾车、公共交通等多种出行方式。
- IP定位：根据IP地址获取位置信息。
- 距离测量：能计算两点间直线距离、驾车距离或步行距离。
📚 详细文档
技术栈
| 属性 | 详情 |
|---|---|
| 开发语言 | Java 17 |
| 框架 | Spring Boot 3.4.4 |
| 数据持久化 | Spring Data JPA |
| 数据库 | H2 数据库 |
| JSON处理 | Jackson JSON |
| API风格 | RESTful API |
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/ # 控制器层
├── service/ # 服务逻辑层
├── repository/ # 数据访问层
└── model/ # 模型/实体类
扩展步骤
- 克隆项目：使用上述命令克隆代码仓库。
- 配置API Key：在application.properties文件中设置高德地图API Key。
- 构建项目：运行mvn clean package进行构建。
- 启动服务：使用mvn spring-boot:run启动应用。
📄 许可证
本项目使用MIT License，具体条款请参考LICENSE文件。