Skip to content

U
unidocs-zh

程序yang / unidocs-zh
与 Fork 源项目一致

Fork自 DCloud / unidocs-zh

通知 1
Star 1
Fork 0
U
unidocs-zh
提交 0db8e419 编写于 作者: DCloud-WZF's avatar DCloud-WZF 💬
浏览文件
操作

update(location change): 支持App、H5

上级 78ffda05
隐藏空白更改
内联 并排
Showing with 49 addition and 49 deletion
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.startLocationUpdateBackground(OBJECT)
### uni.stopLocationUpdate(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.stopLocationUpdate(OBJECT)
### uni.startLocationUpdateBackground(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.
先完成此消息的编辑！
想要评论请 注册 或