---
name: "MapContext.moveToLocation"
mode: "api"
versionRequirements:
  - { name: "基础库", version: "2.21.8" }
title: "MapContext.moveToLocation - 将地图中心移置当前定位点"
---

## MapContext.moveToLocation

> [VERSION] 基础库 >= 2.21.8

### 描述

将地图中心移置当前定位点，此时需设置地图组件 show-location 为 true

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `option` | `MoveToLocationOption` | 是 | 定位配置 |

### 返回值

无


### 引用对象

##### `interface` MoveToLocationOption

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `longitude` | `number` | 经度 |
| `latitude` | `number` | 纬度 |
| `success` | `() => void` | 接口调用成功的回调函数 |
| `fail` | `(result: MapFailResult) => void` | 接口调用失败的回调函数 |
| `complete` | `() => void` | 接口调用结束的回调函数（调用成功、失败都会执行） |

##### `interface` MapFailResult

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `errorCode` | `string` | 错误码 |
| `errorMsg` | `string` | 错误信息 |


### 示例代码

#### 移动到当前定位

```ts
const mapCtx = ty.createMapContext('myMap');
mapCtx.moveToLocation({
  success() {
    console.log('已移动到当前定位');
  },
});
```

#### 移动到指定经纬度

```ts
const mapCtx = ty.createMapContext('myMap');
mapCtx.moveToLocation({
  longitude: 120.0,
  latitude: 30.0,
  success() {
    console.log('已移动到指定位置');
  },
});
```