抖音开放平台Logo
控制台

tt.onLocationChange
收藏
我的收藏

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

注册地理位置变化回调。

前提条件无
业务背景无
使用限制无
注意事项
Tip：开发者工具暂不支持此能力，请用真机扫码调试。
支持沙盒
否
相关教程无

语法

tt.onLocationChange(callback)

参数说明

callback

类型默认值必填说明最低支持版本
function是
回调函数
2.48.0

callback 是一个回调函数，接收 object 类型的参数，属性如下：

属性名类型说明最低支持版本
latitudenumber
纬度，范围为 -90~90，负数表示南纬。
2.48.0
longitudenumber
经度，范围为 -180~180，负数表示西经。
2.48.0
speednumber
速度，单位 m/s
2.48.0
accuracynumber
位置的精确度
2.48.0
altitudenumber
高度，单位 m
2.48.0
verticalAccuracynumber
垂直精度，单位 m（Android 无法获取，返回 0）
2.48.0
citystring
定位到的城市信息（iOS 不支持）
2.48.0

返回值

无

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

tt.onLocationChange(function (res) {
  console.log("onLocationChange", res);
}); // 获取位置更新

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