mashangyoujiu/Application/Retail/Conf/tencent_map_setup_guide.md

腾讯地图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以确保安全性