Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
0db8e419
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3172
Star
105
Fork
804
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
93
列表
看板
标记
里程碑
合并请求
67
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
93
Issue
93
列表
看板
标记
里程碑
合并请求
67
合并请求
67
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
0db8e419
编写于
10月 27, 2022
作者:
DCloud-WZF
💬
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update(location change): 支持App、H5
上级
78ffda05
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
49 addition
and
49 deletion
+49
-49
docs/api/location/location-change.md
docs/api/location/location-change.md
+49
-49
未找到文件。
docs/api/location/location-change.md
浏览文件 @
0db8e419
...
...
@@ -6,7 +6,7 @@
|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序、飞书小程序|QQ小程序|快手小程序|京东小程序|
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|
x|x
|√|x|√|√|x|√|x|
|
√|√
|√|x|√|√|x|√|x|
**FUNCTION CALLBACK 参数**
...
...
@@ -14,9 +14,9 @@
|:-|:-|:-|:-|
|latitude|Number|纬度,范围为 -90~90,负数表示南纬。||
|longitude|Number|经度,范围为 -180~180,负数表示西经。||
|speed|Number|速度 (m/s)||
|speed|Number|速度 (m/s)|
H5不支持
|
|accuracy|number|位置的精确度||
|altitude|number|高度 (m)||
|altitude|number|高度 (m)|
H5不支持
|
|verticalAccuracy|number|垂直精度 (m)|字节小程序、快手小程序 Android 无法获取,返回 0|
|horizontalAccuracy|number|水平精度 (m)|字节小程序不支持|
|city|string|定位到的城市信息|百度小程序、字节小程序(iOS 不支持)|
...
...
@@ -28,6 +28,7 @@ province|String|省份|百度小程序|
streetNumber|String|街道号码|百度小程序|
district|String|区|百度小程序|
isFullAccuracy|Boolean|是不是精确定位信息|百度小程序|
altitudeAccuracy|Number|海拔的精确度信息|App|
**注意**
-
该方法会持续监听地理位置信息的变化,建议在不需要监听地理位置信息变化后,直接调用
`uni.stopLocationUpdate`
方法取消监听。
...
...
@@ -42,6 +43,27 @@ uni.onLocationChange(function (res) {
console
.
log
(
'
经度:
'
+
res
.
longitude
);
});
```
### uni.offLocationChange(FUNCTION CALLBACK)
关闭监听实时位置变化,前后台都停止消息接收。
**平台差异说明**
|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序、飞书小程序|QQ小程序|快手小程序|京东小程序|
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|√|√|√|x|√|√|x|√|x|
**FUNCTION CALLBACK 参数**
|参数名|类型|说明|平台差异说明|
|:-|:-|:-|:-|
|latitude|number|纬度,范围 [-90, 90],负数表示南纬|快手小程序|
|longitude|number|经度,范围 [-180, 180],负数表示西经|快手小程序|
|speed|number|速度 (m/s)|快手小程序|
|accuracy|number|位置的精确度|快手小程序|
|altitude|number|高度 (m)|快手小程序|
|verticalAccuracy|number|垂直精度 (m)(Android 无法获取,返回 0)|快手小程序|
|horizontalAccuracy|number|水平精度 (m)|快手小程序|
### uni.onLocationChangeError(FUNCTION CALLBACK)
...
...
@@ -51,7 +73,7 @@ uni.onLocationChange(function (res) {
|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序、飞书小程序|QQ小程序|快手小程序|京东小程序|
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|
x|x
|√|x|x|√|x|x|x|
|
√|√
|√|x|x|√|x|x|x|
**FUNCTION CALLBACK 参数**
...
...
@@ -60,6 +82,20 @@ uni.onLocationChange(function (res) {
|errCode|Number|错误|微信小程序|
|errMsg|String|错误信息|字节小程序|
### uni.offLocationChangeError(FUNCTION CALLBACK)
取消注册位置更新错误回调。
**平台差异说明**
|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序、飞书小程序|QQ小程序|快手小程序|京东小程序|
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|√|√|√|x|x|√|x|x|x|
**FUNCTION CALLBACK 参数**
无返回值。
### uni.startLocationUpdate(OBJECT)
开启小程序进入前台时接收位置消息。
...
...
@@ -68,7 +104,7 @@ uni.onLocationChange(function (res) {
|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序、飞书小程序|QQ小程序|快手小程序|京东小程序|
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|
x|x
|√|x|√|√|x|√|x|
|
√|√
|√|x|√|√|x|√|x|
**OBJECT 参数**
...
...
@@ -91,75 +127,39 @@ uni.startLocationUpdate({
});
```
### uni.st
artLocationUpdateBackground
(OBJECT)
### uni.st
opLocationUpdate
(OBJECT)
开始监听实时地理位置信息变化事件,小程序进入前后台时均接收实时地理位置信息
。
关闭监听实时位置变化,前后台都停止消息接收
。
**平台差异说明**
|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序、飞书小程序|QQ小程序|快手小程序|京东小程序|
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|
x|x|√|x|x|x
|x|√|x|
|
√|√|√|x|√|√
|x|√|x|
**OBJECT 参数**
|参数名|类型|必填|说明|平台差异说明|
|:-|:-|:-|:-|:-:|
|type|String|否|指定坐标系类型,可以是 wgs84 或 gcj02|微信小程序、字节小程序|
|success|Function|否|接口调用成功的回调函数||
|fail|Function|否|接口调用失败的回调函数||
|complete|function|否|接口调用结束的回调函数(调用成功、失败都会执行)||
### uni.st
opLocationUpdate
(OBJECT)
### uni.st
artLocationUpdateBackground
(OBJECT)
关闭监听实时位置变化,前后台都停止消息接收
。
开始监听实时地理位置信息变化事件,小程序进入前后台时均接收实时地理位置信息
。
**平台差异说明**
|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序、飞书小程序|QQ小程序|快手小程序|京东小程序|
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|x|x|√|x|
√|√
|x|√|x|
|x|x|√|x|
x|x
|x|√|x|
**OBJECT 参数**
|参数名|类型|必填|说明|平台差异说明|
|:-|:-|:-|:-|:-:|
|type|String|否|指定坐标系类型,可以是 wgs84 或 gcj02|微信小程序、字节小程序|
|success|Function|否|接口调用成功的回调函数||
|fail|Function|否|接口调用失败的回调函数||
|complete|function|否|接口调用结束的回调函数(调用成功、失败都会执行)||
### uni.offLocationChange(FUNCTION CALLBACK)
关闭监听实时位置变化,前后台都停止消息接收。
**平台差异说明**
|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序、飞书小程序|QQ小程序|快手小程序|京东小程序|
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|x|x|√|x|√|√|x|√|x|
**FUNCTION CALLBACK 参数**
|参数名|类型|说明|平台差异说明|
|:-|:-|:-|:-|
|latitude|number|纬度,范围 [-90, 90],负数表示南纬|快手小程序|
|longitude|number|经度,范围 [-180, 180],负数表示西经|快手小程序|
|speed|number|速度 (m/s)|快手小程序|
|accuracy|number|位置的精确度|快手小程序|
|altitude|number|高度 (m)|快手小程序|
|verticalAccuracy|number|垂直精度 (m)(Android 无法获取,返回 0)|快手小程序|
|horizontalAccuracy|number|水平精度 (m)|快手小程序|
### uni.offLocationChangeError(FUNCTION CALLBACK)
取消注册位置更新错误回调。
**平台差异说明**
|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序、飞书小程序|QQ小程序|快手小程序|京东小程序|
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|x|x|√|x|x|√|x|x|x|
**FUNCTION CALLBACK 参数**
无返回值。
\ No newline at end of file
|complete|function|否|接口调用结束的回调函数(调用成功、失败都会执行)||
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录