# 轨迹绑路

## 场景介绍

根据给定的坐标点捕捉道路，将用户的轨迹纠正到道路上，从而返回用户实际驾车经过的道路坐标。

## 接口说明

以下是路径规划功能相关接口，主要由[navi](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-navi-api)命名空间下的方法提供，更多接口及使用方法请参见[接口文档](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-navi-api)。

|接口名|描述|
|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-------------------|
|[SnapToRoadsParams](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-navi-api#snaptoroadsparams)|轨迹绑路的参数。|
|[snapToRoads](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-navi-api#snaptoroads)(params: [SnapToRoadsParams](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-navi-api#snaptoroadsparams)): Promise<[SnapToRoadsResult](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-navi-api#snaptoroadsresult)>|轨迹绑路。|
|[snapToRoads](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-navi-api#snaptoroads-1)(context: [common.Context](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-inner-application-context), params: [SnapToRoadsParams](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-navi-api#snaptoroadsparams)): Promise<[SnapToRoadsResult](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-navi-api#snaptoroadsresult)>|轨迹绑路。支持传入Context上下文。|
|[SnapToRoadsResult](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/map-navi-api#snaptoroadsresult)|轨迹绑路的结果。|

## 开发步骤

导入相关模块。

```typescript
import { navi } from '@kit.MapKit';
import { BusinessError } from '@kit.BasicServicesKit';
```

### 轨迹绑路

根据给定的坐标点捕捉道路，将用户的轨迹纠正到道路上，从而返回用户实际驾车经过的道路坐标。

```typescript
async testSnapToRoads() {
  let params: navi.SnapToRoadsParams = {
    // 道路贴合点集合，不能超过100个，且相邻两个点距离需小于等于500米
    points: [{
      latitude: 31.984410259206815,
      longitude: 118.76625379397866
    }]
  };
  try {
    const result = await navi.snapToRoads(params);
    console.info(`Succeeded in snapping to roads. result is ${JSON.stringify(result)}`);
  } catch (error) {
    const err: BusinessError = error as BusinessError;
    console.error(`Failed in snapping to roads. Code is ${err.code}, message is ${err.message}`);
  }
}
```