101 lines
3.0 KiB
Markdown
101 lines
3.0 KiB
Markdown
|
# xtf-gpslocation
|
|||
|
|
# android ios 原生gps 定位
|
|||
|
|
### 长期维护，有任何问题在插件群联系
|
|||
|
|
### 插件测试使用方法
|
|||
|
|
1. 选择试用，绑定要试用的项目appid，
|
|||
|
|
|
|||
|
|
2. 选择后下载到对应的本地项目，
|
|||
|
|
|
|||
|
|
3. 按照文档 -》把插件引入项目（即 import { KeepLive } from '@/uni_modules/android-keeplive' 需要先引入），
|
|||
|
|
|
|||
|
|
4. 发布-》云打包-》选择制作基座-》打包等基座制作完成
|
|||
|
|
|
|||
|
|
5. 运行 -》 运行到手机或模拟器-》运行到Androidapp基座-》选择使用自定义基座运行-》选择手机-》运行
|
|||
|
|
### 若长期无法获取到定位，请到室外进行定位 室内大概率无gps 信号
|
|||
|
|
### [推荐作者保活插件一起使用](https://ext.dcloud.net.cn/plugin?id=20316)
|
|||
|
|
### uniappx
|
|||
|
|
|
|||
|
|
~~~
|
|||
|
|
import { isProviderEnabled, openLocSetting, onStartLocs,LocData,stop,requestBackgroundLocPer,getLastLocations,LocationData} from "@/uni_modules/xtf-gpslocation"
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
var on=isProviderEnabled();// 是否开启gps
|
|||
|
|
if(!on){
|
|||
|
|
openLocSetting();// 打开gps 设置
|
|||
|
|
}
|
|||
|
|
requestBackgroundLocPer();// 申请后台定位权限 无权限则申请，有权限则直接跳过
|
|||
|
|
|
|||
|
|
|
|||
|
|
// 获取上次定位
|
|||
|
|
getLastLocations(function(loc:LocationData){
|
|||
|
|
console.log(loc)
|
|||
|
|
})
|
|||
|
|
|
|||
|
|
onStartLoc({
|
|||
|
|
backgroud:true,
|
|||
|
|
} as LocData,function(loc:LocationData){
|
|||
|
|
console.log(loc)
|
|||
|
|
})
|
|||
|
|
// stop(true);// 停止定位 参数为是否移除通知
|
|||
|
|
~~~
|
|||
|
|
|
|||
|
|
### uniapp
|
|||
|
|
|
|||
|
|
~~~
|
|||
|
|
import { isProviderEnabled, openLocSetting, onStartLocs,stop,requestBackgroundLocPer,getLastLocations} from "@/uni_modules/xtf-gpslocation"
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
var on=isProviderEnabled();// 是否开启gps
|
|||
|
|
if(!on){
|
|||
|
|
openLocSetting();// 打开gps 设置
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
requestBackgroundLocPer();// 申请后台定位权限 无权限则申请，有权限则直接跳过
|
|||
|
|
// 获取上次定位
|
|||
|
|
getLastLocations(function(loc){
|
|||
|
|
console.log(loc)
|
|||
|
|
})
|
|||
|
|
|
|||
|
|
onStartLoc({
|
|||
|
|
backgroud:true,
|
|||
|
|
},function(loc){
|
|||
|
|
console.log(loc)
|
|||
|
|
})
|
|||
|
|
// stop(true);// 停止定位 参数为是否移除通知
|
|||
|
|
~~~
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
### 请求参数 LocData
|
|||
|
|
~~~
|
|||
|
|
export type LocData={
|
|||
|
|
title?:string,// 通知栏标题
|
|||
|
|
content?:string,// 通知栏内容
|
|||
|
|
notifationIconName?:string, // 通知栏icon名称 插件目录 /app-android/res/drawable/
|
|||
|
|
time?:number, // 定位时间间隔，默认0 为仅定位一次 时间为毫秒
|
|||
|
|
distance?:number,// 定位位置间隔距离 // 默认0
|
|||
|
|
backgroud?:boolean,// 是否是后台定位,
|
|||
|
|
getLastFast?:boolean,// 是否先获取上次定位 之后在返回新的定位 // 默认true
|
|||
|
|
};
|
|||
|
|
~~~
|
|||
|
|
### 返回参数 LocationData
|
|||
|
|
~~~
|
|||
|
|
export type LocationData={
|
|||
|
|
msg:string,// 消息
|
|||
|
|
type:number,// 0 是上一次的 1 是最新的 2 定位失败
|
|||
|
|
lat:number, //经度
|
|||
|
|
lng:number,//纬度
|
|||
|
|
speed:number,//速度
|
|||
|
|
altitude:number,//海拔
|
|||
|
|
bearing:number,// 方向
|
|||
|
|
};
|
|||
|
|
~~~
|
|||
|
|
|
|||
|
|
### 开发文档
|
|||
|
|
[UTS 语法](https://uniapp.dcloud.net.cn/tutorial/syntax-uts.html)
|
|||
|
|
[UTS API插件](https://uniapp.dcloud.net.cn/plugin/uts-plugin.html)
|
|||
|
|
[UTS uni-app兼容模式组件](https://uniapp.dcloud.net.cn/plugin/uts-component.html)
|
|||
|
|
[UTS 标准模式组件](https://doc.dcloud.net.cn/uni-app-x/plugin/uts-vue-component.html)
|
|||
|
|
[Hello UTS](https://gitcode.net/dcloud/hello-uts)
|