更新记录

1.0.0（2025-03-21）

新版发布

平台兼容性

高德定位UTS插件接口文档

1. 高德定位UTS插件

<script>

    //高德定位UTS插件
    import * as AMapLoc from "@/uni_modules/Lizii-AMapLoc";

    export default {
    }

</script>

2. 设置高德key(必须)

<script>

    //高德定位UTS插件
    import * as AMapLoc from "@/uni_modules/Lizii-AMapLoc";

    export default {

        onLoad() {

            //设置高德key
            let apiKey = "xxx";
            AMapLoc.setApiKey(apiKey);
        }
    }

</script>

3. 隐私合规检查接口(必须)

<script>

    //高德定位UTS插件
    import * as AMapLoc from "@/uni_modules/Lizii-AMapLoc";

    export default {

        onLoad() {

            //设置高德key
            let apiKey = "xxx";
            AMapLoc.setApiKey(apiKey);

            //隐私合格检查接口
            let showStatus = true;
            let infoStatus = true;
            AMapLoc.updatePrivacyShow(showStatus, infoStatus);
            let agree = true;
            AMapLoc.updatePrivacyAgree(agree);
        }
    }

</script>

4. 检查定位服务是否打开

//检查定位服务是否打开
var enable = AMapLoc.locationServicesEnabled();//true:定位服务打开 false:定位服务关闭

5. 进入打开定位服务界面

//进入打开定位服务界面
AMapLoc.openLocationSetting();

6. 检查定位权限

//检查定位权限是否授权，并申请定位权限
AMapLoc.checkLocationPermission(function(res){
    console.log(res);
    if (res.result == true) {

    } else {
        //打开app信息界面 设置始终定位权限
        AMapLoc.openAppInfoSetting();
    }
});

7. 检查始终允许后台定位权限

//检查始终允许后台定位权限
AMapLoc.checkAlwaysLocationPermission(function(res){
    console.log(res);
    if (res.result == true) {

    } else {
        //打开app信息界面 设置始终允许后台定位
        AMapLoc.openAppInfoSetting();
    }
});

8. 打开app信息设置界面

打开app信息设置界面
AMapLoc.openAppInfoSetting();

9. 单次定位

//单次定位
AMapLoc.getLocation({
    needAddress:true,//是否需要解析地址
    singleLocationTimeout:3000//单次定位超时时间
}, function(res){
    console.log(res);
    if (res.type == "onLocationData") {
        let latitude = res.data.latitude;//纬度
        let longitude = res.data.longitude;//经度
        let altitude = res.data.altitude;//海拔
        let speed = res.data.speed;//速度
        let bearing = res.data.bearing;//方向
        let time = res.data.time;//方向
        let reGeo = res.data.reGeo;//逆地理信息
    } else if (res.type == "onLocationError") {
        let errorCode = res.data.errorCode;//错误码
        let errorMsg = res.data.errorMsg;//错误消息
    }
});

10. 开启持续定位

//开启持续定位
AMapLoc.startLocation({
    needAddress:true,//是否需要解析地址
    allowsBackgroundLocationUpdates:true,//是否允许后台定位
    interval:2000,//定位时间间隔 单位是毫秒 默认2000
    distanceFilter:0,//位置报告距离间隔 单位是米 默认0
    maxAccuracy:20//定位精度 表示精度信息，单位是米 默认0
}, function(res){
    console.log(res);
    if (res.type == "onLocationData") {
        let latitude = res.data.latitude;//纬度
        let longitude = res.data.longitude;//经度
        let altitude = res.data.altitude;//海拔
        let speed = res.data.speed;//速度
        let bearing = res.data.bearing;//方向
        let time = res.data.time;//方向
        let reGeo = res.data.reGeo;//逆地理信息
    } else if (res.type == "onLocationError") {
        let errorCode = res.data.errorCode;//错误码
        let errorMsg = res.data.errorMsg;//错误消息
    }
});

11. 开启后台定位任务，该仅鸿蒙支持

//开启后台定位任务
//如需在后台定位（后台定位需后台定位、后台运行权限），则要在应用切入后台前调用开启后台定位任务，
AMapLoc.startContinuousTask();

12. 停止后台定位任务，该仅鸿蒙支持

//停止后台定位任务
//回到前台可以停止后台任务
AMapLoc.stopContinuousTask();

13. 停止持续定位

//停止持续定位
AMapLoc.stopLocation();