【小程序】媒体API能力集成指南——地图API

 ty.createMapContext(string mapId)

基础库 2.0.12 开始支持, 低版本需做兼容处理。

创建 map 上下文 MapContext 对象。

参数

string mapId

map 组件的 id

返回值

MapContext

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		否	接口调用结束的回调函数（调用成功、失败都会执行）

 👉 立即开发。