更新记录

1.1(2024-06-20) 下载此版本

支持iOS平台

1.0.1(2023-10-23) 下载此版本

更新android自定义基座操作步骤

1.0.0(2023-09-11) 下载此版本

基于腾讯定位服务,实现uni.getLocation 获取定位功能

查看更多

平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 4.0,Android:5.0,iOS:12 × × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × × × × × ×

uts-tencentgeolocation腾讯定位插件使用文档

API使用

参考uni.getLocation

注意,腾讯定位已经内置,只需要进行配置即可使用,配置方式

Android 平台

  1. 申请腾讯地图key

申请网址

  1. 配置key到项目

在项目根目录下添加 AndroidManifest.xml 文件,详情参考:Android原生应用清单文件。将申请的 key 配置到项目 AndroidManifest.xml 的 application 节点中,如下:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools"
>
  <application>

    <!-- 将申请到的 key 配置在 android:value 属性中 -->
    <meta-data android:name="TencentMapSDK" android:value="您申请的Key" />

  </application>

</manifest>
  1. 制作自定义基座运行后生效 提交云端打包制作自定义基座后,再在HBuilderX中真机运行。

iOS 平台

  1. 申请腾讯地图key

申请网址

  1. 配置key到插件中

在项目根目录下添加 Info.plist 文件,详情参考:iOS原生应用配置文件。将申请的 key 配置到项目 Info.plist 的 TencentLBSAPIKey 键值中,如下:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>TencentLBSAPIKey</key>
    <string>您申请的Key</string>
  </dict>
</plist>
  1. 配置访问位置权限描述信息 在项目根目录下 Info.plist 文件中添加以下权限描述信息:
    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
    <plist version="1.0">
    <dict>
    <key>NSLocationAlwaysUsageDescription</key>
    <string>后台运行期访问位置信息的许可描述</string>
    <key>NSLocationWhenInUseUsageDescription</key>
    <string>运行期访问位置信息的许可描述</string>
    <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
    <string>访问位置信息的许可描述</string>
    </dict>
    </plist>

许可描述信息需根据应用实际业务情况准确描述,否则可能无法通过 AppStore 上架审核 uni-app 项目也可以在 manifest.json 的 "App权限配置" 可视化界面的 "iOS隐私信息访问的许可描述" 下配置

  1. 制作自定义基座运行后生效 提交云端打包制作自定义基座后,再在HBuilderX中真机运行。

注意事项

隐私合规问题

此插件使用了腾讯位置服务SDK,调用定位API会采集个人隐私信息,在业务中请确保最终用户已经同意了App的隐私协议后再调用定位API,否则会因为隐私合规问题无法上架应用市场。

App的隐私政策中需披露使用的三方SDK相关情况:

相关开发文档

隐私、权限声明

1. 本插件需要申请的系统权限列表:

<!-- 通过GPS得到精确位置 --> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> <!-- 通过网络得到粗略位置 --> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> <!-- 访问网络,某些位置信息需要从网络服务器获取 --> <uses-permission android:name="android.permission.INTERNET"/> <!-- 访问WiFi状态,需要WiFi信息用于网络定位 --> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> <!-- 修改WiFi状态,发起WiFi扫描, 需要WiFi信息用于网络定位 --> <uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/> <!-- 访问网络状态, 检测网络的可用性,需要网络运营商相关信息用于网络定位 --> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> <!-- 访问网络的变化, 需要某些信息用于网络定位 --> <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE"/> <!-- 蓝牙扫描权限 --> <uses-permission android:name="android.permission.BLUETOOTH"/> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/> <!-- 前台service权限 --> <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/> <!-- 后台定位权限 --> <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION"/> <!-- A-GPS辅助定位权限,方便GPS快速准确定位 --> <uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS"/>

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件使用的 腾讯定位SDK会采集数据,详情可参考:https://lbs.qq.com/

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问