更新记录

1.0.2（2025-03-25）

• 【更新】修复版本兼容问题，修复老版本bug

1.0.1（2024-08-21）

• 【更新】更新使用文档
• 【新增】新增参数配置
• 【优化】优化底层逻辑

1.0.0（2024-08-17）

• 初始化第一版本

平台兼容性

x-gaode-s【高德定位】

使用教程

在你的项目根目录创建AndroidManifest.xml文件，引入一下代码

<?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="你的包名">

    <application>
        <meta-data android:name="com.amap.api.v2.apikey" android:value="你的KEY"></meta-data>
    </application>
</manifest>

• 注意插件在引入项目的时候，隐私合规政策就已经自动为true

引入

import { 
    gaodeLocation,
    X_RESULT_TYPE,
    X_LOCATION_OPTIONS
} from "@/uni_modules/x-gaode-s"

template模版

<template>
    <view>
        <view class="item">
            <button class="item-btn" style="margin-top: 10;" @click="requestPermission">申请权限</button>
            <button class="item-btn" style="margin-top: 10;" @click="getLocation">开启持续定位</button>
            <button class="item-btn" style="margin-top: 10;" @click="stopLocation">关闭持续定位</button>
            <button class="item-btn" style="margin-top: 10;" @click="getOnceLocation">单次定位</button>
        </view>
        <view class="content">
            <text>longitude：{{longitude}}</text>
            <text>latitude：{{latitude}}</text>
        </view>
    </view>
</template>

Vue2使用示例

<script>
import { 
    gaodeLocation,
    X_RESULT_TYPE,
    X_LOCATION_OPTIONS
} from "@/uni_modules/x-gaode-s"
    export default {
        data() {
            return {
                longitude: 0,
                latitude: 0
            }
        },
        methods: {
            requestPermission() {
                gaodeLocation.xApplyPermissions({
                    success: (result: X_RESULT_TYPE) => {
                        console.log(result)
                    },
                })
            },
            getOnceLocation() {
                uni.showLoading({title:"获取中"})
                gaodeLocation.xGetOnceLocation({
                    needAddress: true,
                    success: (result: X_RESULT_TYPE) => {
                        console.log(result)
                        this.latitude = (result.data as UTSJSONObject).getNumber("latitude") as number
                        this.longitude = (result.data as UTSJSONObject).getNumber("longitude") as number
                        uni.hideLoading()
                    },
                    fail: (result: X_RESULT_TYPE) => {
                        console.log(result)
                    }
                } as X_LOCATION_OPTIONS)
            },
            getLocation() {
                gaodeLocation.xGetLocation({
                     mode: "Hight_Accuracy",
                     needAddress: true,
                     success: (result: X_RESULT_TYPE) => {
                         console.log(result)
                        this.latitude = (result.data as UTSJSONObject).getNumber("latitude") as number
                        this.longitude = (result.data as UTSJSONObject).getNumber("longitude") as number
                     },
                     fail: (result: X_RESULT_TYPE) => {
                        console.log(result)
                     }
                } as X_LOCATION_OPTIONS)
            },
            stopLocation() {
                uni.showLoading({title:"获取中"})
                gaodeLocation.xStopLocation({
                    success: () => {
                        uni.hideLoading()
                    },
                    fail: () => {
                        uni.hideLoading()
                    }
                })
            }
        }
    }
</script>

Vue3使用示例

<script lang="uts" setup>
import { 
    gaodeLocation,
    X_RESULT_TYPE,
    X_LOCATION_OPTIONS
} from "@/uni_modules/x-gaode-s"

let longitude = ref(0)
let latitude = ref(0)

const requestPermission = ()=> {
    gaodeLocation.xApplyPermissions({
        success: (result: X_RESULT_TYPE) => {
            console.log(result)
        },
    })
}
const getOnceLocation = ()=> {
    uni.showLoading({title:"获取中"})
    gaodeLocation.xGetOnceLocation({
        needAddress: true,
        success: (result: X_RESULT_TYPE) => {
            console.log(result)
            this.latitude = (result.data as UTSJSONObject).getNumber("latitude") as number
            this.longitude = (result.data as UTSJSONObject).getNumber("longitude") as number
            uni.hideLoading()
        },
        fail: (result: X_RESULT_TYPE) => {
            console.log(result)
        }
    } as X_LOCATION_OPTIONS)
}
const getLocation = () => {
    gaodeLocation.xGetLocation({
         mode: "Hight_Accuracy",
         needAddress: true,
         success: (result: X_RESULT_TYPE) => {
             console.log(result)
            this.latitude = (result.data as UTSJSONObject).getNumber("latitude") as number
            this.longitude = (result.data as UTSJSONObject).getNumber("longitude") as number
         },
         fail: (result: X_RESULT_TYPE) => {
            console.log(result)
         }
    } as X_LOCATION_OPTIONS)
}
const stopLocation = () => {
    stopLocation() {
        uni.showLoading({title:"获取中"})
        gaodeLocation.xStopLocation({
            success: () => {
                uni.hideLoading()
            },
            fail: () => {
                uni.hideLoading()
            }
        })
    }
}
</script>

方法

X_LOCATION_OPTIONS 传入参数

X_RESULT_TYPE 返回参数

X_RESULT_TYPE 的 code和msg

• 详细请查看：https://lbs.amap.com/api/android-location-sdk/guide/utilities/errorcode

X插件系列

x-base-s【基础插件】安卓好用的基础工具

x-sms【短信插件】为X系列插件打造完美轮子

x-tencent-u【腾讯地图】

x-tencent-s【腾讯定位】保活和持久，保姆和小白式的完美解决方案

x-gaode-s【高德定位】保姆和小白式完美解决方案

x-icon-u【图标组件】

x-short-video-u是一个高性能，高度配置的短视频组件

x-im-sdk 为即时通讯量身打造, 适配Android，iOS，Web