92 行
2.7 KiB
Markdown
可执行文件
92 行
2.7 KiB
Markdown
可执行文件
# 腾讯地图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以确保安全性 |