MapContext.moveToLocation
收藏
我的收藏

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

将地图中心移动到定位点。地图能力基于 gcj02 坐标系,请注意入参的经纬度信息转换。

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

Tip:使用 moveToLocation 时,不传递 longitudelatitude 参数,则默认移动到用户当前位置(需申请定位权限并设置 show-locationtrue)。

支持沙盒
相关教程

语法

MapContext.moveToLocation(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
longitudenumber
目标经度,若不传则默认为当前定位点信息( Map 组件中 show-location 属性需设置为 true ),否则 API 调用失败
1.63.0
latitudenumber
目标纬度,若不传则默认为当前定位点信息( Map 组件中 show-location 属性需设置为 true ),否则 API 调用失败
1.63.0
successfunction
接口调用成功的回调函数
1.63.0
failfunction
接口调用失败的回调函数
1.63.0
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)
1.63.0

回调成功

object 类型,属性如下:

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

回调失败

object 类型,属性如下:

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

错误码

errorCodeerrMsgerrorType说明最低支持版本
133101map is not show locationD
地图未显示定位点

在定位点显示后再尝试调用

1.63.0
133102obtain location failD
开发者未传入经纬度,且定位失败

更换设备或稍后重试

1.63.0
133179api scope is not declared in the privacy agreementD
没有在隐私协议声明里声明使用地理位置信息

开发者需要在隐私协议声明地理位置信息的使用

1.63.0
133189system auth denyU
抖音没有地理位置权限

需要引导用户打开系统的权限

1.63.0
133190auth denyU
小程序没有地理位置权限

需要引导用户打开抖音内小程序的授权

1.63.0
133191component view errorF
小程序框架内部错误,有需要请创建工单咨询
1.63.0
133191ignore error component destroyF
小程序框架内部错误,有需要请创建工单咨询
1.63.0
133191invalid id %sF
小程序框架内部错误,有需要请创建工单咨询
1.63.0
133192native exception %sF
小程序框架内部错误,有需要请创建工单咨询
1.63.0
133199latitude is invalidD
经纬度不合理
1.63.0
133199longitude is invalidD
经纬度不合理
1.63.0

扫码体验

请使用字节宿主APP扫码

代码示例