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 | |
success | function | 否 | 接口调用成功的回调函数 | 2.42.0 | |
fail | function | 否 | 接口调用失败的回调函数 | 2.42.0 | |
complete | function | 否 | 接口调用结束的回调函数 | 2.42.0 |
回调成功
object 类型,属性如下:
属性名 | 类型 | 说明 | 最低支持版本 |
---|---|---|---|
errMsg | string | "MapContext.setCenterOffset:ok" | 2.42.0 |
回调失败
object 类型,属性如下:
属性名 | 类型 | 说明 | 最低支持版本 |
---|---|---|---|
errMsg | string | "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 不影响用户手势操作地图的具体效果,只在动态设置地图属性或者使用地图 getCenterLocation 和 moveToLocation 时起作用;
- Tip: iOS 不支持该 API;
- Tip: 开发者工具暂不支持调试该 api,请在真机上调试。
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助