互联网教程

地图 API 怎么申请(高德 / 腾讯)

网站或小程序里要显示地图、算距离、选地址,都得先申请 Key。Key 与「安全密钥」是两样东西,只填 Key 会在前端报错。

发布者:黔序科技依据官方文档核验:2026 年 10 月

核心结论

  • 先注册开发者并实名,再创建应用拿 Key
  • 新版要求同时配安全密钥(jscode)
  • Key 要按平台绑定域名或包名

一句话:申请流程统一:注册开发者 → 实名认证 → 创建应用 → 添加 Key → 绑定平台(Web/小程序释/App)→ 配安全密钥。少一步就会出现「Key 无效」或「INVALID_USER_KEY」。

申请步骤(以高德为例)

  1. 注册并实名用手机号注册开发者账号,个人或企业实名。
  2. 创建应用填应用名称与类型,一个应用可添加多个平台的 Key。
  3. 添加 Key选服务平台(Web 端、微信小程序、Android、iOS),填域名白名单或包名与签名。
  4. 获取安全密钥新版 Web API 需要配套的「安全密钥」,与 Key 一起使用。
  5. 配额与告警看免费额度与并发限制,设置用量提醒。

注意:只在前端释放 Key 等于把额度送给别人。必须配域名释白名单或包名签名限制,Web 端还要用安全密钥做代理校验,否则被人扒走 Key 刷爆额度,账单算你的。

三家怎么选

  • 高德:POI 数据与路径规划成熟,文档完整,国内项目用得最多。
  • 腾讯:与微信生态释结合好,小程序里调用体验顺畅。
  • 百度:地图与搜索结合,适合需要地址解析与周边检索的场景。

常见报错

  • INVALID_USER_KEY:Key 填错、平台类型选错(Web 的 Key 用在小程序里)。
  • USERKEY_PLAT_NOMATCH:Key 与调用平台不匹配,按平台重新申请。
  • DAILY_QUERY_OVER_LIMIT:超出日配额,需要提额或加缓存释。
  • 域名不匹配:白名单没加当前域名,或用了 www 与非 www 两个域名只加了一个。

资料来源

  • 高德开放平台释《Web 服务 API释》《JS API》Key 与安全密钥说明。
  • 腾讯位置服务《开发指南》Key 申请与配额说明。
  • 《地图管理条例》:互联网地图服务的资质与数据合规释要求。

常见问题

Key 和 secret 有什么区别?

Key 是公开标识,可放前端;secret / 安全密钥用于服务端签名,不能暴露。前端直连时用安全密钥做代理校验,服务端调用才用 secret。

免费额度够用吗?

中小企业官网或小程序的常规用量一般够,但 POI 检索与路径规划消耗快。上线后看用量曲线,接近上限前提额或加本地缓存。

地图服务需要资质吗?

自用展示一般不需要,但对外提供地图服务、采集地理信息涉及测绘资质。用官方 SDK 展示不涉及自采,注意不要把地图数据另存再分发。

相关阅读