开发
API

MapContext.setCenterOffset

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

设置地图中心点偏移,未设置时默认偏移为 [0.5, 0.5]。

语法

MapContext.setCenterOffset(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
offset[number, number]中心点偏移量,两位数组,以地图左上角为原点,offset[0] 表示 x 轴偏移量相对于地图容器宽度的比例,offset[1] 表示 y 轴偏移量相对于地图容器高度的比例,数值范围都是 [0.25, 0.75]2.42.0
successfunction接口调用成功的回调函数2.42.0
failfunction接口调用失败的回调函数2.42.0
completefunction接口调用结束的回调函数2.42.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring"MapContext.setCenterOffset:ok"2.42.0

回调失败

object 类型,属性如下:

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

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

<map id="myMap" style="width: 100%; height: 400px;"></map>
<view>
  <button bindtap="setCenterOffset" type="primary">设置地图中心点偏移</button>
</view>
Page({
  onReady(e) {
    this.mapCtx = tt.createMapContext("myMap");
  },

  setCenterOffset() {
    this.mapCtx.setCenterOffset({
      offset: [0.3, 0.7], // 此处设置中心点位于地图的左下方
      success(res) {
        console.log("设置中心点成功", res.errMsg);
      },
    });
  },
});

Bug & Tip

  • Tip: 该 API 不影响用户手势操作地图的具体效果,只在动态设置地图属性或者使用地图 getCenterLocationmoveToLocation 时起作用;
  • Tip: iOS 不支持该 API;
  • Tip: 开发者工具暂不支持调试该 api,请在真机上调试。
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助