From fc372dd09b30720eb88d3622e24c6f194d2fd052 Mon Sep 17 00:00:00 2001 From: yanyilin Date: Thu, 10 Feb 2022 20:26:35 +0800 Subject: [PATCH] update app-geolocation.md --- docs/app-geolocation.md | 83 ++++++++++++++++++++++++++++++++++------- 1 file changed, 70 insertions(+), 13 deletions(-) diff --git a/docs/app-geolocation.md b/docs/app-geolocation.md index 52140ae00..52003489a 100644 --- a/docs/app-geolocation.md +++ b/docs/app-geolocation.md @@ -1,26 +1,32 @@ +App端定位模块封装系统自带的`系统定位`，及市场上主流的三方定位SDK，如`高德定位`、`百度定位`等，提供JS API统一调用定位功能。 -> HBuilderX3.2.16开始独立出“系统定位”模块 +|项目类型|API| +|:-|:-| +|uni-app|[uni.getLocation(OBJECT)](api/location/location?id=getlocation)| +|5+ App/Wap2App|[plus.geolocation.*](https://www.html5plus.org/doc/zh_cn/geolocation.html) -### 背景 +使用定位功能需在项目manifest.json的“App模块配置”中勾选“Geolocation(定位)”，并根据项目实际需求勾选使用的三方定位SDK： +![](https://partner-dcloud-native.oss-cn-hangzhou.aliyuncs.com/images/uniapp/geolocation/modules.png) -从2021年初开始，高德、百度、腾讯等地图服务商更新了服务协议、开始实施商业授权机制，要求除公益App外所有使用地图相关功能（包括定位SDK、地图SDK、H5地图等）都需要获取地图服务商的商业授权。重点强调一下，免费应用同样需要商业授权，除非你的应用是公益类App，其它类型App都需要商业授权。 -- 高德地图参考：[https://lbs.amap.com/upgrade](https://lbs.amap.com/upgrade) -- 百度地图参考：[https://lbsyun.baidu.com/cashier/auth](https://lbsyun.baidu.com/cashier/auth) -没有取得地图服务商授权的App可能会遇到定位或地图功能被停用、上架应用市场可能提示存在侵权的问题，因此需要向高德、百度等地图开放平台申请商业授权。 -为了避免商业授权引起的问题，如仅需获取wgs84坐标的情况下也可以只使用“系统定位”模块，“系统定位”在功能和机型适配上没有高德、百度等商业定位服务完善，需开发者根据实际情况选择。 +### 系统定位 + +> HBuilderX3.2.16开始独立出“系统定位”模块 + +使用`系统定位`需在“App模块配置”项的“Geolocation(定位)”下，勾选“系统定位”： +![](https://partner-dcloud-native.oss-cn-hangzhou.aliyuncs.com/images/uniapp/geolocation/system.png) -### 系统定位 -系统定位调用的系统提供的定位服务，不同设备对定位功能支持的情况有所差异 +`系统定位`调用设备的操作系统提供的定位服务，只支持wgs84坐标系，不同设备对定位功能支持的情况有所差异。 #### iOS平台 -由苹果公司提供定位服务，可以获取经纬度信息，也支持解析地址信息。即可以直接返回城市街道信息。 +由苹果iOS系统提供定位服务，可以获取经纬度信息，支持解析地址信息，即可以直接返回城市街道信息。 #### Android平台 -标准Android平台的定位服务是Google提供的，但需要手机内置GMS服务，连接Google服务器。国产手机大多不支持。 +只可以获取经纬度信息，不支持解析地址信息，即无法返回城市街道信息。 -主流国内手机厂商均自行提供了定位服务，但小众品牌可能不支持，主流品牌中较老的机型也不支持。如下Android手机厂商都支持系统定位： +标准Android系统的定位服务是Google提供的，但需要手机内置GMS服务，连接Google服务器。 +国内主流手机厂商均自行提供了定位服务，但小众品牌可能不支持，主流品牌中较老的机型也不支持。如下Android手机厂商都支持`系统定位`： - 华为 - 小米 - Oppo @@ -33,7 +39,58 @@ 在国外通常都是使用Google的GMS提供定位服务。 -**注意：Android系统定位模块不支持位置解析服务，只可以获取经纬度信息，不支持解析地址信息。如需要根据经纬度获取城市街道信息，仍然需要请求高德、百度等商业服务** +> 注意：由于设备厂商适配的原因，在部分Android设备上定位服务可能不稳定，如需提升定位功能的稳定性建议使用`高德定位`或`百度定位`。 + + + +### 高德定位 + +> 需要向高德申请商业授权，参考:[商业授权相关说明](id=business)，使用前需登录 [高德开放平台](https://lbs.amap.com/) 创建应用申请Key + +使用`高德定位`需在“App模块配置”项的“Geolocation(定位)”下，勾选“高德定位”： +![](https://partner-dcloud-native.oss-cn-hangzhou.aliyuncs.com/images/uniapp/geolocation/amap.png) + +#### 参数说明 +- appkey_android +[高德开放平台](https://lbs.amap.com/)为Android平台申请的Key +- appkey_ios +[高德开放平台](https://lbs.amap.com/)为iOS平台申请的Key + +**注意** +调用高德定位SDK提供的定位服务，仅支持gcj02坐标系，支持解析地址信息。 + + + +### 百度定位 + +> 需要向百度申请商业授权，参考:[商业授权相关说明](id=business)，使用前需登录 [百度地图开放平台](https://lbsyun.baidu.com/) 创建应用申请访问应用（AK） + +使用`高德定位`需在“App模块配置”项的“Geolocation(定位)”下，勾选“百度定位”： +![](https://partner-dcloud-native.oss-cn-hangzhou.aliyuncs.com/images/uniapp/geolocation/baidu.png) + +#### 参数说明 +- appkey_android +[百度地图开放平台](https://lbsyun.baidu.com/)为Android平台申请的访问应用(AK) +- appkey_ios +[百度地图开放平台](https://lbsyun.baidu.com/)为iOS平台申请的访问应用(AK) + +**注意** +调用百度定位SDK提供的定位服务，仅支持gcj02/bd09/bd09ll坐标系，支持解析地址信息。 + + + + + +### 商业授权相关说明 + +从2021年初开始，高德、百度、腾讯等地图服务商更新了服务协议、开始实施商业授权机制，要求除公益App外所有使用地图相关功能（包括定位SDK、地图SDK、H5地图等）都需要获取地图服务商的商业授权。重点强调一下，免费应用同样需要商业授权，除非你的应用是公益类App，其它类型App都需要商业授权。 +- 高德地图参考：[https://lbs.amap.com/upgrade](https://lbs.amap.com/upgrade) +- 百度地图参考：[https://lbsyun.baidu.com/cashier/auth](https://lbsyun.baidu.com/cashier/auth) +没有取得地图服务商授权的App可能会遇到定位或地图功能被停用、上架应用市场可能提示存在侵权的问题，因此需要向高德、百度等地图开放平台申请商业授权。 + +为了避免商业授权引起的问题，如仅需获取wgs84坐标的情况下也可以只使用“系统定位”模块，“系统定位”在功能和机型适配上没有高德、百度等商业定位服务完善，需开发者根据实际情况选择。 + + -- GitLab