# 腾讯地图API配置指南

## 1. 申请腾讯地图API密钥

### 步骤1：注册腾讯位置服务账号
1. 访问腾讯位置服务官网：https://lbs.qq.com/
2. 点击右上角"控制台"，使用QQ或微信登录
3. 完成开发者认证（个人或企业认证）

### 步骤2：创建应用
1. 在控制台中点击"应用管理" -> "我的应用"
2. 点击"创建应用"
3. 填写应用信息：
   - 应用名称：您的应用名称
   - 应用类型：选择"Web端"
   - 应用描述：简要描述应用用途

### 步骤3：获取API密钥
1. 创建应用后，在应用列表中找到您的应用
2. 点击"查看密钥"，复制Key值
3. 记录下这个Key，后续配置时需要使用

### 步骤4：配置服务权限
1. 在应用详情页面，点击"设置"
2. 在"WebServiceAPI"中启用以下服务：
   - 地图显示（必需）
   - 地点搜索（可选）
   - 路线规划（可选）
3. 在"WebAPI"中启用：
   - JavaScript API GL（必需）
   - 绘制工具（必需）

## 2. 配置系统

### 方法1：修改配置文件
1. 打开文件：`Application/Retail/Conf/tencent_map_config.php`
2. 将 `YOUR_TENCENT_MAP_KEY_HERE` 替换为您申请的API密钥
3. 保存文件

### 方法2：修改模板文件
1. 打开文件：`Application/Retail/View/StoreSet/baseSet.html`
2. 找到第3行的腾讯地图API引用
3. 将 `YOUR_TENCENT_MAP_KEY` 替换为您申请的API密钥
4. 保存文件

## 3. 域名白名单配置

为了安全起见，建议在腾讯位置服务控制台中配置域名白名单：

1. 在应用设置中找到"域名白名单"
2. 添加您的网站域名，例如：
   - `https://yourdomain.com`
   - `https://www.yourdomain.com`
3. 保存配置

## 4. 测试配置

配置完成后，访问门店设置页面：
1. 登录系统后台
2. 进入"门店设置" -> "基础设置"
3. 找到"服务区域设置"面板
4. 点击"新增服务区域"
5. 如果地图正常显示，说明配置成功

## 5. 常见问题

### Q: 地图无法显示，提示"腾讯地图API未加载"
A: 检查以下几点：
- API密钥是否正确配置
- 网络连接是否正常
- 域名是否在白名单中
- 浏览器是否支持JavaScript

### Q: 绘制功能无法使用
A: 确保在腾讯位置服务控制台中启用了"绘制工具"服务

### Q: API调用超出配额
A: 腾讯地图提供免费配额，超出后需要付费。可以在控制台查看使用情况和购买配额

## 6. 技术支持

如遇到技术问题，可以：
1. 查看腾讯位置服务官方文档：https://lbs.qq.com/webApi/
2. 联系腾讯位置服务技术支持
3. 查看系统日志获取详细错误信息

---

**注意事项：**
- 请妥善保管API密钥，避免泄露
- 建议定期检查API使用情况
- 生产环境建议配置HTTPS以确保安全性