• JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • tt.getLocation
  • tt.openLocation
  • tt.chooseLocation
  • tt.startLocationUpdate
  • tt.stopLocationUpdate
  • tt.onLocationChange
  • tt.offLocationChange
  • tt.onLocationChangeError
  • tt.offLocationChangeError
  • 设备
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 行业开放
  • 第三方平台
  • 其它
  • 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); }, });