Expand All

# Geolocation定位

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

注意

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

Project Type	API
uni-app	uni.getLocation(OBJECT)
5+ App/Wap2App	plus.geolocation.*

# 系统定位

HBuilderX3.2.16 began to separate out the "system location" module

System positioning calls the positioning service provided by the operating system of the device, which only supports the wgs84 coordinate system. Different devices support different positioning functions.

# iOS Platform

The positioning service is provided by Apple's iOS system, which can obtain latitude and longitude information and support the resolution of address information, that is, it can directly return city street information.

# Android Platform

Only latitude and longitude information can be obtained, and address information cannot be resolved, that is, city street information cannot be returned.

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

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

Huawei
Oppo
Vivo
Nubia
one plus
Meizu
Lenovo
Gionee

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

注意

由于设备厂商适配的原因，在部分Android设备上定位服务可能不稳定，如需提升定位功能的稳定性建议使用高德定位或腾讯定位
本地离线打包参考Android平台系统定位模块配置、iOS平台系统定位模块配置

# 高德定位

You need to apply for business authorization from AutoNavi, refer to: Commercial authorization instructions, you need to log in to the AutoNavi Open Platform to create Application Application Key

# 参数说明

高德用户名高德开放平台注册账号的用户名，获取方式参考“高德开放平台用户名”章节
appkey_android 高德开放平台为Android平台申请的Key
appkey_ios Amap Open Platform Key applied for iOS platform

注意

Calling the positioning service provided by the AutoNavi positioning SDK, it only supports the gcj02 coordinate system, and supports parsing address information.
After configuration, the cloud package must be submitted to take effect. Please use the [custom debugging base] when the real machine is running (https://ask.dcloud.net.cn/article/35115)
Local offline packaging reference [Android platform AutoNavi positioning module configuration](https://nativesupport.dcloud.net.cn/AppDocs/usemodule/androidModuleConfig/geolocation?id=%e9%ab%98%e5%be%b7% e5%ae%9a%e4%bd%8d), [iOS Platform Geolocation Module Configuration](https://nativesupport.dcloud.net.cn/AppDocs/usemodule/iOSModuleConfig/geolocation?id=%e9%ab% 98%e5%be%b7%e5%ae%9a%e4%bd%8d)

# 高德开放平台用户名

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

# 腾讯定位

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

# 参数说明

apikey_android 腾讯位置服务官网为Android平台申请的Key
apikey_ios 腾讯位置服务官网为iOS平台申请的Key

注意

调用腾讯定位SDK提供的定位服务，仅支持gcj02坐标系，支持解析地址信息。
配置后需提交云端打包后才能生效，真机运行时请使用自定义调试基座

# 商业授权相关说明

# 国内用户

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

授权费用：5万元/年。

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

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

法律问题：违反产品使用许可，也就是侵权了
功能问题：定位、地图、服务器相关接口随时可能被停用
上架某些应用市场会提示侵权而导致无法上架

商业授权的范围：

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

如何节省费用：

使用定位时，可以优先调用系统定位。

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