🚀 地图服务项目文档

本项目提供了一系列地图服务功能接口，涵盖地理编码、地标查询、IP定位等多种服务。同时，详细介绍了项目开发的前期准备、初始化步骤、功能测试等内容，帮助开发者快速上手使用。

🚀 快速开始

前期准备

使用Anaconda提供Python虚拟环境，PyCharm提供集成开发环境。 具体参考视频： 【大模型应用开发-入门系列】03 集成开发环境搭建-开发前准备工作 YouTube链接 Bilibili链接

项目初始化

安装依赖

运行以下命令安装所需依赖：

pip install -r requirements.txt

配置文件

创建并配置以下文件：

• config.json
• secrets.py

启动服务

启动地图服务和MCP服务。

✨ 主要特性

地图服务功能接口

地理编码服务

示例：
输入：118.79815,32.01112
输出：江苏省苏州市姑苏区

地标查询服务

输入：夫子庙
输出：{
    "name": "夫子庙",
    "location": {
        "lng": "xxx",
        "lat": "xxx"
    }
}

IP定位服务

输入：112.10.22.229
输出：{
    "province": "江苏省",
    "city": "南京市"
}

天气查询服务

输入：上海天气
输出：当前上海天气情况

路径规划服务

• 骑行路径规划

输入：从苏州的虎丘区到相城区，选择骑行方式
输出：详细骑行路线

• 步行路径规划

输入：从苏州的虎丘区到相城区，选择步行方式
输出：详细步行路线

• 驾车路径规划

输入：从苏州的虎丘区到相城区，选择驾车方式
输出：详细驾车路线

• 公共交通路径规划

输入：从苏州的虎丘区到相城区，选择公共交通方式
输出：详细公交/地铁路线

距离测量服务

输入：从苏州的虎丘区到相城区，选择驾车方式
输出：距离数据

地标搜索服务

• 加油站搜索

输入：苏州市虎丘区中石化加油站
输出：相关加油站信息列表

• POI详情查询

输入：POI ID（如B020016GPH）
输出：详细POI信息

周边搜索服务

输入：苏州乐园，半径10公里，中石化加油站
输出：周边符合条件的加油站列表

MCP服务功能接口测试脚本

具体参考如下视频： 【大模型应用开发-入门系列】03 集成开发环境搭建-开发前准备工作 YouTube链接 Bilibili链接

MCP Client测试脚本

具体参考如下视频： 【大模型应用开发-入门系列】04 大模型LLM服务接口调用方案 YouTube链接 Bilibili链接

📦 安装指南

集成开发环境搭建

使用Anaconda提供Python虚拟环境，PyCharm提供集成开发环境。

安装依赖

运行以下命令安装所需依赖：

pip install -r requirements.txt

💻 使用示例

基础用法

以地理编码服务为例：

输入：118.79815,32.01112
输出：江苏省苏州市姑苏区

📚 详细文档

前期准备工作

集成开发环境搭建

使用Anaconda提供Python虚拟环境，PyCharm提供集成开发环境。具体参考视频： 【大模型应用开发-入门系列】03 集成开发环境搭建-开发前准备工作 YouTube链接 Bilibili链接

大模型LLM服务接口调用方案

具体参考视频： 【大模型应用开发-入门系列】04 大模型LLM服务接口调用方案 YouTube链接 Bilibili链接

项目初始化

安装依赖

运行以下命令安装所需依赖：

pip install -r requirements.txt

配置文件

创建并配置以下文件：

• config.json
• secrets.py

启动服务

启动地图服务和MCP服务。

功能测试

测试用例

基础功能测试

• 地理编码测试
• 地标查询测试
• IP定位测试
• 天气查询测试

路径规划测试

• 骑行路径测试
• 步行路径测试
• 驾车路径测试
• 公共交通路径测试

距离测量测试

• 驾车距离测量测试

地标搜索测试

• 加油站搜索测试
• POI详情查询测试

周边搜索测试

• 周边加油站搜索测试

🔧 技术细节

工具链

• Python版本要求：3.8+
• 依赖管理工具：pip
• 代码编辑器：PyCharm
• 虚拟环境管理：Anaconda

配置示例

{
    "api_key": "your_api_key",
    "endpoint": "https://example.com"
}