开发
API

tt.openLocation

基础库 1.0.0 开始支持本方法。

使用内置地图查看位置。

语法

tt.openLocation(options)

参数说明

options

options 为 object 类型,属性描述如下:

属性名类型默认值必填说明最低支持版本
latitudenumber纬度,范围为 -90 ~ 90,正数表示北,负数表示南1.0.0
longitudenumber经度,范围为 -180 ~ 180,正数表示东,负数表示西1.0.0
scalenumber18缩放比例,范围 5 ~ 181.0.0
namestring位置名1.0.0
addressstring地址的详细说明1.0.0
successFunction接口调用成功的回调函数1.0.0
failFunction接口调用失败的回调函数1.0.0
completeFunction接口调用结束的回调函数(调用成功、失败都会执行)1.0.0

回调成功

属性名类型说明最低支持版本
errMsgstring1.0.0

回调失败

属性名类型说明最低支持版本
errMsgstring"openLocation:fail " + 错误信息1.0.0

效果示例

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

Page({
  onShow() {
    tt.getLocation({
      success(res) {
        const { latitude, longitude } = res;
        // 通过 tt.getLocation 获取 当前位置经纬度, 然后打开地图
        this.openLocation(latitude, longitude);
      },
    });
  },

  // 使用 openLocation 打开地图
  openLocation(latitude, longitude) {
    tt.openLocation({
      latitude,
      longitude,
      scale: 18,
      success() {
        console.log("打开地图成功");
      },
      fail(res) {
        console.log("打开地图失败:", res.errMsg);
      },
    });
  },
});

Bug & Tip

  • Tip:该 API 需要用户授权方可调用,详细信息可参考用户授权
  • Tip:该 API 有一定性能消耗,请注意不要频繁调用以防设备过热和耗电过快。小程序框架也会做相应的节流处理。
  • Tip:输入的坐标坐标系应当为 gcj02
点击纠错
评价此篇文档