• JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • tt.getLocation
  • tt.openLocation
  • tt.chooseLocation
  • tt.startLocationUpdate
  • tt.stopLocationUpdate
  • tt.onLocationChange
  • tt.offLocationChange
  • tt.onLocationChangeError
  • tt.offLocationChangeError
  • 设备
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 行业开放
  • 第三方平台
  • 其它
  • tt.chooseLocation
    收藏
    我的收藏

    基础库 1.83.0 开始支持本方法,这是一个异步方法。

    打开地图选择位置。

    前提条件
    业务背景
    使用限制
    注意事项

    自 2024 年 4 月 23 日起,该 API 仅针对满足服务类目条件的小程序开放申请。满足申请条件后,开发者登录控制台,在小程序应用中筛选“能力-用户数据能力-设备数据”,申请选择地理位置能力权限,详情见一次性地理位置能力开通及使用规范

    支持沙盒
    相关教程

    语法

    tt.chooseLocation(options)

    参数说明

    options 为 object 类型,属性如下:

    属性名类型默认值必填说明最低支持版本
    latitudenumber
    目标地纬度
    1.83.0
    longitudenumber
    目标地经度
    1.83.0
    successfunction
    接口调用成功的回调函数
    1.83.0
    failfunction
    接口调用失败的回调函数
    1.83.0
    completefunction
    接口调用结束的回调函数(调用成功、失败都会执行)
    1.83.0

    回调成功

    object 类型,属性如下:

    属性名类型说明最低支持版本
    latitudenumber
    纬度,范围为 -90 ~ 90,正数表示北,负数表示南。使用 gcj02 国测局坐标系。
    1.83.0
    longitudenumber
    经度,范围为 -180 ~ 180,正数表示东,负数表示西。使用 gcj02 国测局坐标系。
    1.83.0
    namestring
    位置名称,非必传字段
    1.83.0
    addressstring

    带省市区信息的详细地址,

    示例1:北京市海淀区中关村街道

    示例2:浙江省杭州市余杭区五常街道

    1.83.0
    errMsgstring
    "chooseLocation:ok"
    1.83.0

    回调失败

    object 类型,属性如下:

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

    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    104095chooseLocation:fail cancelU
    用户取消

    用户取消,不需要特殊处理

    1.83.0
    104089chooseLocation:fail system auth denyU
    用户拒绝授权系统权限

    用户未授予系统权限,请引导用户按需授权

    1.83.0
    104090chooseLocation:fail auth denyU
    拒绝授权

    用户未授予小程序授权,请引导用户按需授权,详情参考 用户授权

    1.83.0
    104083chooseLocation:fail platform auth denyD
    开发者错误,没有申请appid的权限

    请查看能力对应文档,申请对应的能力白名单

    1.83.0
    104091chooseLocation:fail Internal error: no api callbackF
    小程序框架内部错误,有需要请创建工单咨询
    1.83.0
    104079chooseLocation:fail api scope is not declared in the privacy agreementD
    隐私能力不在申请的 scope 内

    检查隐私协议

    1.83.0
    104080chooseLocation:fail privacy permission is not authorizedU
    隐私协议未授权

    用户未授权隐私协议,请引导用户按需授权

    1.83.0

    扫码体验

    请使用字节宿主APP扫码

    代码示例