文旅民宿小程序，地图和定位接口怎么申请？

做文旅民宿小程序，地图和定位这两个接口基本躲不开。游客要知道你在哪、怎么过去、附近有什么，全靠它撑着。先给结论：接口本身不难申请，真正把项目卡到上线前一天的是三件小事——隐私协议里的用途说明、后台的域名白名单，还有授权弹窗的时机。照着下面的顺序做，能少走很多弯路。

一、定位接口到底要在哪几处做声明？

• 小程序后台的隐私协议里要写清收集位置的目的，写到「展示周边景点、算距离」这种颗粒度，别只写改善体验。

• app.json 的 permission 里配好 scope.userLocation，一句话用途说明要具体，审核是逐字看的。

• 位置相关接口对企业主体没有额外收费，但个人主体基本过不了，这一步签合同前就得确认。

• 位置权限不是靠申请批下来的，是看你能不能把用途说明白，功能做得好不如说明写得清。

二、地图组件为什么开发工具能跑、真机是白的？

• 用腾讯位置服务要先在它控制台建应用、拿 key，key 填错或者没填，真机上地图就是一块白板。

• 小程序后台的 request 合法域名要把地图相关域名加进去，开发工具不校验，真机请求直接会被拦掉。

• 换过主体或换过服务器的项目最容易翻车，域名白名单没同步，线上地图某天突然就打不开了。

• 地图打不开九成是域名问题不是代码问题，先去后台核对域名，比翻代码快得多。

三、点「导航」这一步怎么做才不被退回？

• 拉起导航直接用 wx.openLocation，传目的地经纬度，用户点一下跳到手机自带地图 App，不用自己画路线。

• 目的地坐标提前存进后台，别让用户手输文字地址，文字解析出来的位置经常偏出几百米。

• 民宿地址建议经纬度存一份、门牌号文字存一份，文字只做展示，不做定位依据。

• 导航别自己实现，交给系统地图 App，自己画的路线又丑又容易挨投诉，纯属费力不讨好。

四、授权怎么弹，定位不准和加载慢怎么办？

• 授权弹窗放在用户点「周边」或「导航」的时候再弹，别在首页一进来就弹，通过率和接受度都高一截。

• 室内定位误差本来就大，能用目的地坐标算距离就别依赖用户实时定位，误差能压到几十米内。

• 地图慢的话先出静态图和地址文字，地图组件延迟加载，首屏能快一两秒。

• 授权时机比授权文案重要，晚弹不丢用户；定位只用来算距离，别拿它当唯一依据。

五、按这套流程走下来，能省多少事？

• 一个标准文旅小程序，接口从提交到全部可用，正常 3 到 5 个工作日，卡在用途说明的项目要拖到 10 天以上。

• 我们经手的项目里，地图类退回原因中域名白名单占一半，隐私协议用途说明占三成，其余是授权时机。

• 导航延迟加载加静态图兜底后，首页打开时间从 2.4 秒压到 1.1 秒左右，游客跳出明显减少。

• 坐标预先入库的做法，定位相关客服问题比让用户手输地址少了七成左右。

六、给你三条能直接照做的建议

1. 先写隐私协议和用途说明再动代码，说明写不清楚，后面接口怎么调都白搭。

2. 地图 key 和域名白名单上线前用真机过一遍，开发工具能跑不代表真机能跑。

3. 授权弹窗跟着用户动作走，点到导航或周边再弹，通过率和体验都比首页强弹好。

常见问题

问：定位不准到底怎么解决？ 答：室内本来就飘，别硬靠用户定位。以目的地坐标为基准算距离，用户位置只做参考，误差能压到几十米。

问：地图加载慢有办法优化吗？ 答：先渲染静态图和地址文字，地图组件延迟加载，首屏会快很多，信号差的时候也不至于白屏。

问：境外能用国内这套地图接口吗？ 答：支持有限，港澳台和海外部分区域覆盖不全。有跨境业务要在开工前先确认，别等上线了才发现。

问：个人主体能申请吗？ 答：位置相关接口个人主体基本过不了。做民宿这类生意，建议先办好企业或个体工商户主体再开工。

问：换了小程序主体，地图会失效吗？ 答：会。主体一变，key 和域名白名单都要重新配，不少项目就是漏了这一步导致线上地图突然打不开。