展示全部

# Geolocation定位

定位模块封装了OS自带的系统定位，及市场上主流的三方定位SDK，如高德定位、腾讯定位等。并提供统一的JS API调用定位能力。

注意

三方定位（高德、腾讯、谷歌等）是商业收费服务，需获取授权，注意避免侵权。详见

项目类型	API
uni-app	uni.getLocation(OBJECT)
5+ App/Wap2App	plus.geolocation.*

使用定位功能需在项目manifest.json的“App模块配置”中勾选“Geolocation(定位)”，并根据项目实际需求勾选使用的三方定位SDK：

HBuilderX3.2.16开始独立出“系统定位”模块

使用系统定位需在“App模块配置”项的“Geolocation(定位)”下，勾选“系统定位”：

系统定位调用设备的操作系统提供的定位服务，只支持wgs84坐标系，不同设备对定位功能支持的情况有所差异。

由苹果iOS系统提供定位服务，可以获取经纬度信息，支持解析地址信息，即可以直接返回城市街道信息。

只可以获取经纬度信息，不支持解析地址信息，即无法返回城市街道信息。

标准Android系统的定位服务是Google的GMS服务，需连接Google服务器。中国大陆地区用户无法翻墙，导致无法使用定位，或者很多国产手机阉割掉了GMS，也导致无法使用定位。

国内手机厂商早期均没有内置替代GMS的位置服务，这些设备上只能使用三方定位。但后期大品牌手机和三方定位合作，内置了替代GMS的版本。如下Android手机厂商的新款手机都支持系统定位：

其他小众品牌可能不支持，主流品牌中较老的机型也不支持，暂无机型清单，需自行测试。

注意

需要向高德申请商业授权，参考:商业授权相关说明，使用前需登录高德开放平台创建应用申请Key

使用高德定位需在“App模块配置”项的“Geolocation(定位)”下，勾选“高德定位”：

注意

登录高德开放平台，进入“控制台”，在“账号信息”的“基本信息”中可获取“用户名”：

HBuilderX4.31 新增支持 腾讯定位
需要向腾讯申请商业授权，参考:商业授权相关说明，使用前需登录腾讯位置服务官网创建应用申请Key

使用腾讯定位需在“安卓/iOS模块配置”项的“Geolocation(定位)”下，勾选“腾讯定位”：

注意

2021年起，高德、腾讯、百度等地图服务商开始商业授权。

授权费用：5万元/年。

例外：如果是公益类应用，可以申请豁免商业授权。只要不是公益应用，不管你有多少用户，都需要获取商业授权。

未授权面临的问题和风险：

商业授权的范围：

凡是要请求地图厂商服务器的，均属于授权范围。不管是使用这3家的定位SDK、地图SDK，不管是app、web、小程序、服务器接口。
如果你的应用没有配置在3家厂商注册账户后申请的应用秘钥（AppKey等），则无需付费。比如在小程序里使用自带的定位api和map组件，已经由小程序平台给地图厂商付费了，所以开发者无需再向地图厂商申请appkey和付费。但如果开发者在地图厂商的开放平台注册了开发者账户，且调用了它们的服务器接口，比如逆地址解析，仍然要获取商业授权。

如何节省费用：

iOS可以直接用。
Android如果在国外可直接用。如果国内，因为google服务被墙，情况较复杂。
- 小米、华为的系统定位可以直接用，因为他们已经向地图厂商购买了授权并封装成了系统定位。但其他品牌的手机则需要开发者自行测试，也有的品牌在较新的手机上支持了系统定位。手机webview的定位api背后也是系统定位，如果系统定位支持，就可以直接用，如果不支持，那webview里也用不了。所以无需考虑用webview的定位来绕过。
- 微信浏览器、QQ浏览器的定位之所以可以使用，也是因为这些浏览器厂商向地图厂商购买了授权。如果你的web应用跑在这些浏览器里，调用定位api是没问题的。
系统定位只能拿到坐标，无法获取地址信息，比如城市、街道。如需要根据坐标获取街道信息，需使用地图厂商的逆地址解析，这属于商业授权范围。