offlineMapData（离线地图）

本模块提供获取离线地图功能。

起始版本： 26.0.0

导入模块

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

getRecommendedCityIdsByLatLngs

getRecommendedCityIdsByLatLngs(context: common.Context, latlngs: mapCommon.LatLng[]): Promise<string[]>

根据经纬度数组查询设备上离线地图未下载的区域。使用Promise异步回调。

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

系统能力： SystemCapability.Map.Core.OfflineMapData

起始版本： 26.0.0

参数：

参数名 类型 必填 说明
context common.Context 是 Context上下文。
latlngs mapCommon.LatLng[] 是 经纬度数组，最大长度为20，异常值返回空数组[]。

返回值：

类型 说明
Promise<string[]> Promise对象，返回推荐区域列表数组。

错误码：

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

错误码ID 错误信息
1002600001 System internal error.
1002600004 The Map permission is not enabled.

示例：

// 经纬度数组
let latLngArr: mapCommon.LatLng[] = [
  { latitude: 49.5, longitude: 3.5 },
  { latitude: 49.5, longitude: 4.5 },
  { latitude: 50.5, longitude: 4.5 },
  { latitude: 51.5, longitude: 4.5 }];
let resArray: string[] = await offlineMapData.getRecommendedCityIdsByLatLngs(this.getUIContext().getHostContext(), latLngArr);