互联网教程
地图 API 怎么申请(高德 / 腾讯)
网站或小程序里要显示地图、算距离、选地址,都得先申请 Key。Key 与「安全密钥」是两样东西,只填 Key 会在前端报错。
核心结论
- 先注册开发者并实名,再创建应用拿 Key
- 新版要求同时配安全密钥(jscode)
- Key 要按平台绑定域名或包名
一句话:申请流程统一:注册开发者 → 实名认证 → 创建应用 → 添加 Key → 绑定平台(Web/小程序释/App)→ 配安全密钥。少一步就会出现「Key 无效」或「INVALID_USER_KEY」。
申请步骤(以高德为例)
- 注册并实名用手机号注册开发者账号,个人或企业实名。
- 创建应用填应用名称与类型,一个应用可添加多个平台的 Key。
- 添加 Key选服务平台(Web 端、微信小程序、Android、iOS),填域名白名单或包名与签名。
- 获取安全密钥新版 Web API 需要配套的「安全密钥」,与 Key 一起使用。
- 配额与告警看免费额度与并发限制,设置用量提醒。
注意:只在前端释放 Key 等于把额度送给别人。必须配域名释白名单或包名签名限制,Web 端还要用安全密钥做代理校验,否则被人扒走 Key 刷爆额度,账单算你的。
三家怎么选
- 高德:POI 数据与路径规划成熟,文档完整,国内项目用得最多。
- 腾讯:与微信生态释结合好,小程序里调用体验顺畅。
- 百度:地图与搜索结合,适合需要地址解析与周边检索的场景。
常见报错
- INVALID_USER_KEY:Key 填错、平台类型选错(Web 的 Key 用在小程序里)。
- USERKEY_PLAT_NOMATCH:Key 与调用平台不匹配,按平台重新申请。
- DAILY_QUERY_OVER_LIMIT:超出日配额,需要提额或加缓存释。
- 域名不匹配:白名单没加当前域名,或用了 www 与非 www 两个域名只加了一个。
资料来源
常见问题
Key 和 secret 有什么区别?
Key 是公开标识,可放前端;secret / 安全密钥用于服务端签名,不能暴露。前端直连时用安全密钥做代理校验,服务端调用才用 secret。
免费额度够用吗?
中小企业官网或小程序的常规用量一般够,但 POI 检索与路径规划消耗快。上线后看用量曲线,接近上限前提额或加本地缓存。
地图服务需要资质吗?
自用展示一般不需要,但对外提供地图服务、采集地理信息涉及测绘资质。用官方 SDK 展示不涉及自采,注意不要把地图数据另存再分发。
相关阅读
域名实名认证怎么做
实名不是给域名单独上传证件,而是给「信息模板」做实名,再用模板去买域名。审核通常 3~5 个工作日,未通过时域名会被注册局锁定,已配的解析也会暂停。
如何购买阿里云域名
买域名的关键不在挑名字,而在「信息模板」有没有通过实名。模板没实名,钱付了域名也用不了;.cn 和 .xin 还有注册后 5 天内必须实名通过的硬期限。
备案要多久,能不能加急
服务商初审 1~2 个工作日,工信部短信 24 小时内回填,管局审核 1~20 个工作日——所以整体是 3 到 22 个工作日,差距全在管局这一段,且官方不支持加急。
网站被投诉侵权怎么处理
侵权投诉分四类:著作权(图片、字体、文章)、商标、专利、名誉权。处理顺序是「先下架止损,再核实权利,最后决定和解或抗辩」。
公安联网备案怎么做
拿到 ICP 备案号只是第一步。网站正式能访问那天起 30 日内,还要到全国互联网安全管理服务平台办一次公安备案,通过后把编号和图标挂到页面底部。
换服务器怎么做到不中断
换服务器的中断时间取决于三件事:TTL 有没有提前降、数据有没有同步、切换有没有回退方案。做好这三点,用户几乎感知不到。