petalMaps（拉起地图应用）

导入模块

import { petalMaps } from '@kit.MapKit';

openMapHomePage

openMapHomePage(context: common.Context): Promise<void>

打开地图应用首页。使用Promise异步回调。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

设备行为差异： 对于5.1.1(19)及之前的版本，该接口在phone、tablet中可正常使用，在其他设备中返回801错误码。在6.0.0(20)及之后版本该接口在phone、tablet、PC/2in1均可正常使用，在其他设备中返回801错误码。

起始版本： 5.0.3(15)

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ArkTS API错误码。

示例：

await petalMaps.openMapHomePage(this.getUIContext().getHostContext());

openMapPoiDetail

openMapPoiDetail(context: common.Context, poiDetailParams: PoiDetailParams): Promise<void>

应用的POI详情页面。使用Promise异步回调。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

设备行为差异： 对于5.1.1(19)及之前的版本，该接口在phone、tablet中可正常使用，在其他设备中返回801错误码。在6.0.0(20)及之后版本该接口在phone、tablet、PC/2in1均可正常使用，在其他设备中返回801错误码。

起始版本： 5.0.3(15)

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ArkTS API错误码。

示例：

let params: petalMaps.PoiDetailParams = {
  destinationPosition: {
    latitude: 30.983015468224288,
    longitude: 118.78058590757131
  }
};
await petalMaps.openMapPoiDetail(this.getUIContext().getHostContext(), params);

openMapTextSearch

openMapTextSearch(context: common.Context, textSearchParams: TextSearchParams): Promise<void>

打开地图应用的文本搜索页面。使用Promise异步回调。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

设备行为差异： 对于5.1.1(19)及之前的版本，该接口在phone、tablet中可正常使用，在其他设备中返回801错误码。在6.0.0(20)及之后版本该接口在phone、tablet、PC/2in1均可正常使用，在其他设备中返回801错误码。

起始版本： 5.0.3(15)

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ArkTS API错误码。

示例：

let params: petalMaps.TextSearchParams = {
  destinationName: '云谷'
};
await petalMaps.openMapTextSearch(this.getUIContext().getHostContext(), params);

openMapRoutePlan

openMapRoutePlan(context: common.Context, routePlanParams: RoutePlanParams): Promise<void>

打开地图应用的路线规划页面。使用Promise异步回调。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

设备行为差异： 对于5.1.1(19)及之前的版本，该接口在phone、tablet中可正常使用，在其他设备中返回801错误码。在6.0.0(20)及之后版本该接口在phone、tablet、PC/2in1均可正常使用，在其他设备中返回801错误码。

起始版本： 5.0.3(15)

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ArkTS API错误码。

示例：

let params: petalMaps.RoutePlanParams = {
  destinationPosition: {
    latitude: 31.983015468224288,
    longitude: 118.78058590757131
  }
};
await petalMaps.openMapRoutePlan(this.getUIContext().getHostContext(), params);

openMapNavi

openMapNavi(context: common.Context, naviParams: NaviParams): Promise<void>

打开地图应用的导航页面。使用Promise异步回调。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

设备行为差异： 对于5.1.1(19)及之前的版本，该接口在phone、tablet中可正常使用，在其他设备中返回801错误码。在6.0.0(20)及之后版本该接口在phone、tablet、PC/2in1均可正常使用，在其他设备中返回801错误码。

起始版本： 5.0.3(15)

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ArkTS API错误码。

示例：

let params: petalMaps.NaviParams = {
  destinationPosition: {
    latitude: 31.983015468224288,
    longitude: 118.78058590757131
  }
};
await petalMaps.openMapNavi(this.getUIContext().getHostContext(), params);

openMapTaxi

openMapTaxi(context: common.Context, taxiParams: TaxiParams): Promise<void>

打开地图应用的打车页面。使用Promise异步回调。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

设备行为差异： 在6.0.1(21)及之后版本该接口在phone和tablet均可正常使用，在其他设备中返回801错误码。

起始版本： 6.0.1(21)

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ArkTS API错误码。

示例：

let params: petalMaps.TaxiParams = {
  destinationPosition: {
    latitude: 31.983015468224288,
    longitude: 118.78058590757131
  }
};
await petalMaps.openMapTaxi(this.getUIContext().getHostContext(), params);

openMapOfflineDataManagement

openMapOfflineDataManagement(context: common.Context, offlineDataParams: OfflineDataParams): Promise<void>

打开地图应用的离线地图管理页面。使用Promise异步回调。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

设备行为差异： 在6.1.1(24)及之后版本该接口在phone、tablet、PC/2in1均可正常使用，在其他设备中返回801错误码。

起始版本： 6.1.1(24)

参数：

返回值：

错误码：

以下错误码的详细介绍请参见ArkTS API错误码。

示例：

let params: petalMaps.OfflineDataParams = {
  scenarios: 'PHONE'
};
await petalMaps.openMapOfflineDataManagement(this.getUIContext().getHostContext(), params);

PoiDetailParams

POI详情的参数。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

设备行为差异： 对于5.1.1(19)及之前的版本，该接口在phone、tablet中可正常使用，在其他设备中返回801错误码。在6.0.0(20)及之后版本该接口在phone、tablet、PC/2in1均可正常使用，在其他设备中返回801错误码。

起始版本： 5.0.3(15)

示例：

let params: petalMaps.PoiDetailParams = {
  destinationPosition: {
    latitude: 31.968789,
    longitude: 118.798537
  },
  destinationName: '标记点',
  zoom: 17,
  coordinateType: mapCommon.CoordinateType.GCJ02,
  destinationAddress: '这是我选择的演示名称'
};

TextSearchParams

文本搜索的参数。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

设备行为差异： 对于5.1.1(19)及之前的版本，该接口在phone、tablet中可正常使用，在其他设备中返回801错误码。在6.0.0(20)及之后版本该接口在phone、tablet、PC/2in1均可正常使用，在其他设备中返回801错误码。

起始版本： 5.0.3(15)

示例：

let params: petalMaps.TextSearchParams = {
  destinationName: '云谷'
};

RoutePlanParams

路线规划的参数。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

设备行为差异： 对于5.1.1(19)及之前的版本，该接口在phone、tablet中可正常使用，在其他设备中返回801错误码。在6.0.0(20)及之后版本该接口在phone、tablet、PC/2in1均可正常使用，在其他设备中返回801错误码。

起始版本： 5.0.3(15)

示例：

let params: petalMaps.RoutePlanParams = {
  destinationPosition: {
    latitude: 31.983015468224288,
    longitude: 118.78058590757131
  }
};

NaviParams

导航的参数。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

设备行为差异： 对于5.1.1(19)及之前的版本，该接口在phone、tablet中可正常使用，在其他设备中返回801错误码。在6.0.0(20)及之后版本该接口在phone、tablet、PC/2in1均可正常使用，在其他设备中返回801错误码。

起始版本： 5.0.3(15)

示例：

let params: petalMaps.NaviParams = {
  destinationPosition: {
    latitude: 31.983015468224288,
    longitude: 118.78058590757131
  }
};

OfflineDataParams

离线地图管理参数。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

设备行为差异： 在6.1.1(24)及之后版本该接口在phone、tablet、PC/2in1均可正常使用，在其他设备中返回801错误码。

起始版本： 6.1.1(24)

示例：

let params: petalMaps.OfflineDataParams = {
  scenarios: 'PHONE'
};

VehicleType

出行方式。地图应用侧目前出行方式暂时仅支持驾车、步行、骑行、公交。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

设备行为差异： 对于5.1.1(19)及之前的版本，该接口在phone、tablet中可正常使用，在其他设备中返回801错误码。在6.0.0(20)及之后版本该接口在phone、tablet、PC/2in1均可正常使用，在其他设备中返回801错误码。

起始版本： 5.0.3(15)

TaxiParams

打车的参数。

模型约束： 此接口仅可在Stage模型下使用。

系统能力： SystemCapability.Map.Core

设备行为差异： 在6.0.1(21)及之后版本该接口在phone、tablet均可正常使用，在其他设备中返回801错误码。

起始版本： 6.0.1(21)

示例：

let params: petalMaps.TaxiParams = {
  destinationPosition: {
    latitude: 31.983015468224288,
    longitude: 118.78058590757131
  }
};