以下是最新版(2025)腾讯地图 API Key(开发密钥)的申请全流程指南,适用于 Web、微信小程序、APP(Android/iOS)等开发场景。
一、准备工作
📌 需要的条件:
- 一个 腾讯云账号
- 实名认证(企业或个人均可)
- 拥有项目的基本信息(如 App 名称、小程序 AppID 等)
二、申请入口
👉 腾讯位置服务官网:
🔗 https://lbs.qq.com/
点击右上角「控制台」 → 登录 → 进入开发者中心
三、申请开发密钥(Key)
路径:
控制台首页 → 【密钥管理】 → 【创建密钥】
四、填写创建密钥信息
在「创建密钥」页面,依次填写以下信息:
1. 应用名称
你的项目名称,用于区分多个密钥。
2. 应用类型
根据你的项目选择:
应用类型 | 使用场景 |
---|---|
WebService API | 后台服务接口(如:地理编码、路线规划) |
浏览器定位应用 | 网页嵌入腾讯地图 |
微信小程序 | 地图组件、逆地址解析等 |
移动端 SDK(Android / iOS) | 移动 App 中使用地图服务 |
微信公众号 | JS-SDK 地图定位 |
3. 绑定平台信息(非常重要!)
类型 | 平台绑定信息 |
---|---|
H5 网页 | 输入你的域名(如 yourdomain.com ) |
小程序 | 输入小程序 AppID (如:wx1234567890abcd ) |
Android | 填写包名 + SHA1 签名(用于 SDK 校验) |
iOS | 填写 Bundle ID(包名) |
五、配置 Key 权限(可选)
建议开发初期关闭 Referer 限制;上线后务必开启,避免被盗用。
六、查看与管理 Key
密钥创建后,在「密钥管理」列表中可以查看:
- key值
- 所属应用
- 状态(启用/停用)
- 请求统计(每日调用次数)
七、示例使用(小程序)
以小程序调用腾讯地图逆地址解析 API 为例:
// 安装腾讯位置服务 SDK(建议使用 @qqmap/qqmap-wx-jssdk)
const QQMapWX = require('../../libs/qqmap-wx-jssdk.min.js');
const qqmapsdk = new QQMapWX({
key: '你申请的Key'
});
qqmapsdk.reverseGeocoder({
location: {
latitude: 39.984060,
longitude: 116.307520
},
success: function(res) {
console.log(res.result.address);
}
});