开发
API

tt.startLocationUpdate

基础库 2.48.0 开始支持本方法,低版本需做兼容处理,这是一个异步方法。

开始接收位置更新。调用此 API 需要申请高精度权限,具体信息见高精度定位运营规范

语法

tt.startLocationUpdate(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
typestring"gcj02"指定坐标系类型,可以是 "wgs84""gcj02"2.48.0
successfunction接口调用成功的回调函数2.48.0
failfunction接口调用失败的回调函数2.48.0
completefunction接口调用结束的回调函数2.48.0

type 的合法值

说明最低支持版本
gcj02指定坐标系类型为加密坐标系(适用于国内地图软件)2.48.0
wgs84指定坐标系类型为真实坐标系2.48.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring"startLocationUpdate:ok"2.48.0

回调失败

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring"startLocationUpdate:fail" + 详细错误信息2.48.0
errNonumber错误码2.48.0

错误说明

errNoerrMsg说明最低支持版本
10200auth deny用户未开启定位权限2.48.0
21100the app does not apply for high-precision location permission小程序没有申请高精度定位权限2.48.0
21101locationUpdate has started接收位置更新已经开启2.48.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

tt.onLocationChange(function (res) {
  // startLocationUpdate成功后会回调此方法
  console.log("location change", res);
});

tt.startLocationUpdate({
  success(res) {
    console.log("开启接收位置更新", res);
  },
  fail(res) {
    console.log("开启接收位置更新失败", res);
  },
});

Bug & Tip

  • Tip:开发者工具暂不支持此能力,请用真机扫码调试。
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助