【小程序】媒体API能力集成指南——地图API
ty.createMapContext(string mapId)
基础库 2.0.12 开始支持, 低版本需做兼容处理。
创建 map 上下文 MapContext 对象。
参数
string mapId
map 组件的 id
返回值
MapContext
MapContext 实例,可通过 ty.createMapContext 获取。
MapContext 通过 id 跟一个 map 组件绑定,操作对应的 map 组件。
方法
MapContext.addMarkers
添加 marker
MapContext.removeMarkers
移除 marker
MapContext.getScale
获取当前地图的缩放级别
MapContext.getCenterLocation
获取当前地图中心的经纬度
MapContext.moveToLocation
将地图中心移置当前定位点
MapContext.moveAlong
沿指定路径移动 marker,用于轨迹回放等场景。动画完成时触发回调事件,若动画进行中,对同一 marker 再次调用 moveAlong 方法,前一次的动画将被打断。
MapContext.addMarkers(Object object)
基础库 2.0.12 开始支持, 低版本需做兼容处理。
添加 marker。
参数
Object Object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
markers | Array | 是 | 同传入 map 组件的 marker 属性 | |
clear | boolean | false | 否 | 是否先清空地图上所有 marker |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
MapContext.removeMarkers(Object object)
基础库 2.0.12 开始支持, 低版本需做兼容处理。
移除 marker。
参数
Object Object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
markerIds | Array | 是 | marker 的 id 集合。 | |
clear | boolean | false | 否 | 是否先清空地图上所有 marker |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
MapContext.getScale(Object object)
基础库 2.0.12 开始支持, 低版本需做兼容处理。
获取当前地图的缩放级别。
参数
Object Object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
object.success 回调函数
参数
Object res
属性 | 类型 | 说明 |
---|---|---|
scale | number | 缩放值 |
MapContext.getCenterLocation(Object object)
基础库 2.0.12 开始支持, 低版本需做兼容处理。
获取当前地图中心的经纬度。
参数
Object Object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
iconPath | string | 否 | 图标路径,支持网络路径、代码包路径 | |
clear | boolean | false | 否 | 是否先清空地图上所有 marker |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
object.success 回调函数
参数
Object res
属性 | 类型 | 说明 |
---|---|---|
longitude | number | 经度 |
latitude | number | 纬度 |
MapContext.moveToLocation(Object object)
基础库 2.0.12 开始支持, 低版本需做兼容处理。
将地图中心移置当前定位点。
参数
Object Object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
longitude | number | 是 | 经度 | |
latitude | number | 是 | 纬度 | |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
MapContext.moveAlong(Object object)
基础库 2.0.12 开始支持, 低版本需做兼容处理。
功能描述
沿指定路径移动 marker,用于轨迹回放等场景。动画完成时触发回调事件,若动画进行中,对同一 marker 再次调用 moveAlong 方法,前一次的动画将被打断。
参数
Object Object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
markerId | number | 是 | 指定 marker | |
path | Array | 是 | 移动路径的坐标串,坐标点格式 {longitude, latitude} | |
duration | number | 是 | 平滑移动的时间(单位: 毫秒) | |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
👉 立即开发。
原文地址:https://blog.csdn.net/Ms_Smart/article/details/136301177
免责声明:本站文章内容转载自网络资源,如本站内容侵犯了原著者的合法权益,可联系本站删除。更多内容请关注自学内容网(zxcms.com)!