---
name: "MapContext"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.21.8" }
title: "MapContext"
---

## MapContext

> [VERSION] 基础库 >= 2.21.8

> 💡 MapContext 通过 id 跟一个 map 组件绑定，操作对应的 map 组件。

### 描述

MapContext 实例，可通过 ty.createMapContext 获取

### 参数

无


### 返回值

类型: `MapContext`

MapContext 实例

#### 方法

| 方法名 | 说明 |
| --- | --- |
| `addMarkers` | 添加 marker |
| `getCenterLocation` | 获取当前地图中心的经纬度 |
| `getScale` | 获取当前地图的缩放级别 |
| `moveToLocation` | 将地图中心移置当前定位点，此时需设置地图组件 show-location 为 true |
| `removeMarkers` | 移除 marker |
| `moveAlong` | 沿指定路径移动 marker，用于轨迹回放等场景 |

### 示例代码

#### 基本使用

```ts
Page({
  onReady() {
    const mapCtx = ty.createMapContext('myMap');
    mapCtx.getScale({
      success(res) {
        console.log('当前缩放级别', res.scale);
      },
    });
  },
});
```