更新记录

1.0.3（2024-02-04）

使用complieOnly避免与uni内置定位功能冲突

1.0.2（2024-01-30）

简单自测

1.0.1（2024-01-26）

完善readme.md

平台兼容性

uni-app

uni-app x

其他

hr-getLocation-amap

使用高德定位sdk获取当前的地理位置信息，如经纬度，地址，高度和速度等多种信息，具体一定的保活能力，特点：

• 支持单次定位；
• 支持前台连续定位；
• 支持应用进入后台后，通过开启前台服务，忽略电池优化来持续定位获取位置信息，拥有一定的保活能力；
• api和原uni.getLocation等基本保持一致，原使用uni相关API的代码可使用替换方法名的方式快速修改；

使用过程中有什么问题，希望大家及时和我反馈，***:485608318。

使用步骤

一、安装本插件；

二、配置您的应用的minSdkVersion和targetSdkVersion：

• 在项目的根目录中的manifest.json中的App常用其它设置中配置。
• 如果不配置，minSdkVersion默认值是19（即最低支持Android4.4），targetSdkVersion版本是28（即Android9.0）。
• 本插件目前只支持targetSdk和minSdkVersion>=19。

三、在您的应用根目录的AndroidManifest.xml中配置高德定位的key，如果没有这个文件，请创建。详见应用清单文件 AndroidManifest.xml。

• 高德地图Key：需到高德开放平台申请，可参考：获取高德地图key,配置示例

  <?xml version="1.0" encoding="utf-8"?>
  <manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools"
  package="net.lvip.hr_getlocation_amap_demo">
  <application>
      <meta-data android:name="aMapSDKKey" android:value="1577e12eef1ec266c18e748ef7bfe334"> </meta-data>
  </application>
  </manifest>

四、在页面中引入插件，调用导出的方法，并传入相应参数，参数详情见下文代码示例。

五、打包自定义基座并运行，进行真机调试。

完整使用示例

可以直接引入demo项目，运行并查看相应代码。

<template>
    <view class="content">
        <image class="logo" src="/static/logo.png"></image>
        <view class="text-area">
            <button type="primary" size="default" @click="getLocationOnce">前台单次定位</button>
            <button type="primary" @click="getLocationForeground">前台持续定位</button>
            <button type="primary" @click="getLocationForegroundService">持续定位（使用前台服务）</button>
            <button type="primary" @click="stopMapLocationUpdate">停止定位</button>
        </view>
    </view>
</template>

<script>
    import {
        getLocation,
        startLocationUpdate,
        startLocationUpdateBackground,
        stopLocationUpdate,
        onLocationChange,
        onLocationChangeError,
        offLocationChange
    } from '@/uni_modules/hr-getLocation-amap';

    export default {
        methods: {
            getLocationOnce() {
                getLocation({
                    success: function(result) {
                        console.log('单次定位结果：', result.longitude, result.latitude);
                    },
                    fail: (error) => {
                        console.log(error);
                    },
                    complete: () => {
                        console.log('complete');
                    }
                });
            },
            getLocationForeground() {
                startLocationUpdate({
                    success: () => {
                        console.log('success');
                        onLocationChange(function(result) {
                            console.log('change', result.longitude, result.latitude);
                        });
                        onLocationChangeError(function(locationChangeError) {
                            console.log(
                                'onLocationChangeError：',
                                locationChangeError.errorCode,
                                locationChangeError.errorInfo,
                                locationChangeError.locationDetail
                            );
                        });
                    },
                });
            },
            getLocationForegroundService() {
                startLocationUpdateBackground({
                    success: () => {
                        console.log('开始持续定位（使用前台服务）');
                        onLocationChange(function(result) {
                            console.log('change', result.longitude, result.latitude);
                        });
                        onLocationChangeError(function(locationChangeError) {
                            console.log(
                                'onLocationChangeError：',
                                locationChangeError.errorCode,
                                locationChangeError.errorInfo,
                                locationChangeError.locationDetail
                            );
                        });
                    },
                    fail: (error) => {
                        console.log(error);
                    },
                    complete: () => {
                        console.log('complete');
                    }
                });
            },
            stopMapLocationUpdate() {
                stopLocationUpdate({
                    success: () => {
                        console.log('success');
                    },
                    fail: (error) => {
                        console.log(error);
                    },
                    complete: () => {
                        console.log('complete');
                    }
                });
            }
        }
    }
</script>

具体方法

startLocationUpdate(options)

启动持续定位，必须用调用这个方法，然后才能在onLocationChange获取到位置信息。

参数

options，具体见下文

类型：GetLocationOptions 必填：是 默认值：无

使用示例

import { startLocationUpdate } from 'hr-getLocation-amap';

startLocationUpdate({
    success: function() {
        console.log('开始定位');
    },
    fail: function(err) {
        console.error('定位失败: ', err);
    },
    complete: function() {
        console.log('定位完成');
    }
});

startLocationUpdateBackground(options)：

应用进入后台的持续定位（使用前台服务，忽略电池优化）

参数

options

类型：GetLocationOptions 必填：是 默认值：无， 注意：如果要使用忽略电池优化，参数中要传入

• enableBatteryOptimization，值为true，表示开启，默认为false。
• requestIgnoreBatteryOptimizationCode，这是一个整数，随意配置，保持唯一即可，

使用示例

import { startLocationUpdateBackground } from 'hr-getLocation-amap';

startLocationUpdateBackground({
    needFullAccuracy: true,
    enableBatteryOptimization: true,
    requestIgnoreBatteryOptimizationCode: 34343428,
  success: function() {
    console.log('开始后台持续定位');
  },
  fail: function(err) {
    console.error('后台持续定位失败: ', err);
  },
  complete: function() {
    console.log('后台持续定位完成');
  }
});

stopLocationUpdate(stopLocationOptions)

停止持续定位。

参数

stopLocationOptions

类型：StopLocationOptions 必填：否 默认值：无

使用示例

import { stopLocationUpdate } from 'hr-getLocation-amap';

stopLocationUpdate({
    success: function() {
        console.log('持续定位已停止');
    },
    fail: function(err) {
        console.error('停止持续定位失败: ', err);
    },
    complete: function() {
        console.log('停止持续定位完成');
    }
});

onLocationChange(callback)

设置位置变化时的回调函数。

参数

callback

类型：(result: any) => void 必填：是

使用示例

import { onLocationChange } from 'hr-getLocation-amap';

onLocationChange(function(result) {
    console.log('位置变化: ', result);
});

定位结果result数据

{
    accuracy: location.getAccuracy(), // 获取定位精度 单位:米
    adCode: location.getAdCode(), // 获取区域编码
    address: location.getAddress(), // 获取地址信息
    altitude: location.getAltitude(), // 获取海拔高度(单位：米)
    aoiName: location.getAoiName(), // 获取兴趣面名称
    bearing: location.getBearing(), // 获取方向角(单位：度)
    buildingId: location.getBuildingId(), // 返回支持室内定位的建筑物ID信息
    city: location.getCity(), // 获取城市名称
    cityCode: location.getCityCode(), // 获取城市编码
    conScenario: location.getConScenario(), // 室内外置信度
    coordType: location.getCoordType(), // 获取坐标系类型
    country: location.getCountry(), // 获取国家名称
    description: location.getDescription(), // 获取位置语义信息
    district: location.getDistrict(), // 获取区的名称
    errorCode: location.getErrorCode(), // 获取错误码
    errorInfo: location.getErrorInfo(), // 获取错误信息
    extras: location.getExtras(), // 获取额外的信息
    floor: location.getFloor(), // 获取室内定位的楼层信息
    gpsAccuracyStatus: location.getGpsAccuracyStatus(), // 获取卫星信号强度
    latitude: location.getLatitude(), // 获取纬度
    locationDetail: location.getLocationDetail(), // 获取定位信息描述
    locationQualityReport: location.getLocationQualityReport(), // 获取定位质量
    locationType: location.getLocationType(), // 获取定位结果来源
    longitude: location.getLongitude(), // 获取经度
    poiName: location.getPoiName(), // 获取兴趣点名称
    provider: location.getProvider(), // 获取定位提供者
    province: location.getProvince(), // 获取省的名称
    road: location.getRoad(), // 获取街道名称
    satellites: location.getSatellites(), // 获取当前可用卫星数量
    speed: location.getSpeed(), // 获取当前速度(单位：米/秒)
    street: location.getStreet(), // 获取街道名称
    streetNum: location.getStreetNum(), // 获取门牌号
    trustedLevel: location.getTrustedLevel(), // 获取定位结果的可信度
    locationTime: Date.now(),// 定位时间
}

onLocationChangeError(callback)

设置定位错误时的回调函数。

参数

callback

类型：(error: any) => void 必填：是

使用示例

import { onLocationChangeError } from 'hr-getLocation-amap';

onLocationChangeError(function(error) {
    console.error('定位错误: ', error);
});

offLocationChange(callback)

移除位置变化的回调函数。

参数

callback

类型：(result: any) => void 必填：是

使用示例

import { offLocationChange } from 'hr-getLocation-amap';

offLocationChange(function(result) {
    console.log('已移除位置变化监听');
});

options

类型：GetLocationOptions 必填：是 默认值：无

GetLocationOptions 的属性值

提高定位精度的建议

定位精度对于许多应用来说至关重要，特别是那些依赖于精确地理位置数据的应用。以下是一些提高定位精度的有效方法：

1. 使用高精度定位模式

• 启用GPS：GPS提供最精确的定位信息。确保应用在需要高精度定位时启用GPS。配置项为isHighAccuracy，默认开启。
• 结合网络定位：同时使用Wi-Fi和蜂窝网络定位可以在室内或GPS信号弱的地区提供更好的定位结果。配置项为isWifiActiveScan（默认开启）。
• 配置isOnceLocationLatest: 设置定位是否等待WIFI列表刷新 定位精度会更高，但是定位速度会变慢1-3秒 从高德sdk3.7.0版本开始，支持连续定位（连续定位时首次会等待刷新） 3.7.0之前的版本，仅适用于单次定位，当设置为true时，连续定位会自动变为单次定位；

2. 利用设备传感器

• 加速度计和陀螺仪：帮助判断设备的移动和方向。
• 磁力计：提供方向信息，增强方向感。
• 气压计：在一些设备上，气压计可以帮助确定海拔高度。
• 配置项为isSensorEnable（默认关闭）。

3. 适当的定位更新策略

• 动态调整定位频率：根据应用的需要和用户的当前活动状态动态调整定位更新的频率。
• 批量定位：如果可能，使用批量定位来减少电池消耗，同时获取足够的数据来提高精度。对返回的定位结果根据类型进行过滤；

4. 软件层面的优化

• 算法优化：使用先进的算法来过滤噪声和不准确的定位数据。
• 数据融合：综合不同来源的数据来提高定位的准确性和可靠性。

5. 用户引导和反馈

• 用户引导：引导用户如何在他们的设备上启用或改善定位服务。
• 反馈机制：提供一种方式让用户报告定位问题，以帮助进一步优化定位服务。

应用这些策略可以在很大程度上提高应用的定位精度，从而提升用户体验和应用性能。