🏆 测试地质
🏪
FindShop China
基于高德地图API的全国店铺搜索系统
📊 系统概览
100+
行业分类
34
省级行政区
300+
每行业店铺
5
界面版本
🏆 系统亮点： 全中国覆盖，实时数据，智能搜索，多格式导出，完整的用户管理系统
🚀 核心功能
🗺️
全国地理覆盖
覆盖中国全部34个省级行政区，支持省市县三级地理位置精确搜索
🏪
100+行业分类
从餐饮、购物到医疗、金融，包含100个详细行业分类，每个行业保证300+店铺结果
🔍
智能搜索策略
多策略搜索算法，自动补充数据，确保每个分类返回充足的搜索结果
📊
多种排序方式
支持按评分、距离、价格等维度排序，满足不同用户需求
💾
数据本地缓存
智能缓存机制，提高查询速度，减少API调用成本
📤
多格式导出
支持Excel表格和vCard电话本导出，便于数据管理和联系人导入
📱
响应式Web界面
现代化UI设计，支持桌面和移动设备，操作简便直观
🖥️
Python GUI版本
独立的桌面应用程序，提供与Web版本相同的完整功能
👥
用户管理系统
完整的注册登录系统，每个用户拥有独立的搜索历史和管理空间
📚
搜索历史管理
自动保存搜索记录，支持历史查询、导出和管理
🔐
JWT安全认证
基于JWT的安全认证机制，确保用户数据安全和API访问控制
🌐
RESTful API
完整的REST API设计，支持第三方系统集成和扩展开发
🛠️ 技术架构
后端技术栈
🐍 Python 3.9+
🚀 FastAPI
🗄️ SQLAlchemy
🗃️ SQLite
🗺️ 高德地图API
🔐 JWT认证
📊 Pandas
📋 OpenPyXL
前端技术栈
🌐 HTML5
🎨 CSS3
💻 JavaScript
🎯 Bootstrap
📱 响应式设计
🎨 Font Awesome
桌面应用
🐍 PyQt6
📦 PyInstaller
🔧 跨平台打包
📋 主要特性
❌ 传统搜索方式
- 依赖单一搜索引擎
- 数据更新不及时
- 行业分类有限
- 地理覆盖不全
- 导出功能弱
- 无用户管理
✅ FindShop China
- 高德地图官方数据
- 实时数据更新
- 100+行业分类
- 全国省市县覆盖
- Excel+vCard导出
- 完整用户系统
数据质量保证
- 📍 地理位置精准：基于高德地图API，经纬度坐标准确
- 📞 联系方式完整：包含电话、地址等详细信息
- ⭐ 评分数据丰富：用户评分、评价数量等
- 🖼️ 多媒体支持：店铺照片、营业时间等
- 🏷️ 分类精确：100个行业分类，层次清晰
🔌 API接口文档
核心接口
| 接口 | 方法 | 描述 | 认证 |
|---|---|---|---|
/api/shops/search |
POST | 搜索店铺 | 需要JWT |
/api/shops/export/excel |
GET | 导出Excel | 需要JWT |
/api/shops/export/vcard |
GET | 导出vCard | 需要JWT |
/api/locations/provinces |
GET | 获取省份列表 | 公开 |
/api/categories/ |
GET | 获取分类列表 | 公开 |
/api/auth/register |
POST | 用户注册 | 公开 |
/api/auth/login |
POST | 用户登录 | 公开 |
/api/search-history/list |
GET | 获取搜索历史 | 需要JWT |
💡 使用指南
Web界面使用
- 注册登录：访问系统首页，注册新用户或登录已有账户
- 选择地区：依次选择省份、城市、县区
- 选择行业：从100+行业分类中选择目标行业
- 设置关键词：输入店铺名称关键词（可选）
- 配置排序：选择评分、距离等排序方式
- 执行搜索：点击搜索按钮获取结果
- 导出数据：选择Excel或vCard格式导出
GUI版本使用
桌面版本提供与Web相同的功能，支持一键打包分发。
🔧 部署与运行
环境要求
- 🐍 Python 3.9+
- 💾 SQLite数据库
- 🔑 高德地图API Key
- 💻 支持Linux/Windows/macOS
快速启动
📈 性能指标
<1s
API响应时间
99%
数据准确率
24/7
系统可用性
∞
扩展性
系统优势
- ⚡ 高性能：异步处理，缓存优化，快速响应
- 🔒 高安全：JWT认证，数据加密，访问控制
- 📈 高可用：容错设计，自动重试，稳定运行
- 🔧 高扩展：模块化设计，API友好，易于集成
Leave a Reply
You must be logged in to post a comment.