抖音开放平台Logo
控制台

tt.startLocationUpdate
收藏
我的收藏

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

开始接收位置更新。调用此 API 需要申请高精度权限，具体信息见高精度定位运营规范，该能力需申请权限使用，满足申请条件后，开发者登录控制台，在小程序应用中筛选“能力-用户数据能力-设备数据”，申请获取高精度地理位置能力，能力使用规范详情查看高精度定位能力开通及使用规范；申请条件如下：

  1. 信用分 >= 60分
  2. 服务类目

一级类目

二级类目

三级类目

餐饮

餐饮

外卖平台、餐饮门店

交通出行

交通出行

打车/网约车、顺风车/拼车、出租车、城市共享交通、停车、代驾、租车

前提条件无
业务背景无
使用限制

开发者工具暂不支持此能力，请用真机扫码调试。

注意事项无
支持沙盒
否
相关教程无

语法

tt.startLocationUpdate(options)

参数说明

options 为 object 类型，属性如下：

属性名类型默认值必填说明最低支持版本
typeenumgcj02否
指定坐标系类型，可以是 `wgs84` 或 `gcj02`
2.48.0
successfunction否
接口调用成功的回调函数
2.48.0
failfunction否
接口调用失败的回调函数
2.48.0
completefunction否
接口调用结束的回调函数（调用成功、失败都会执行）
2.48.0

type 的合法值

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

回调成功

object 类型，属性如下：

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

回调失败

object 类型，属性如下：

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

错误码

errNoerrMsg说明最低支持版本
10200auth deny
用户未开启定位权限
2.48.0
10201privacy permission is not authorized

用户拒绝隐私协议授权，详见小程序隐私协议开发指南

3.19.0
10202api scope is not declared in the privacy agreement

隐私协议中未定义相关隐私信息类型，详见配置隐私协议

3.19.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);
  },
});