使用离线地图 最后更新时间: 2026年05月26日

离线地图与基本地图联动

高德3D 地图 SDK支持离线地图功能。（2D 地图 SDK 不支持离线地图功能）

离线地图可满足在无网络环境下查看地图信息的需求，在设备本地有离线地图数据的情况下，SDK 会优先加载离线地图。

离线地图UI组件（推荐）

自3D地图SDK V2.2.5起，新增离线地图UI组件，组件涵盖城市下载、暂停、更新、删除以及关键字城市查询等功能，是高德地图客户端离线地图功能的一个子集，UI交互风格上靠拢高德地图app，也考虑到与开发者应用UI的融合问题，尽可能的保持了简约极致。以下方法实现一键完成离线地图开发。

增加权限

"requestPermissions": [
  {
    "name": 'ohos.permission.INTERNET',
  },
  {
    "name": 'ohos.permission.GET_NETWORK_INFO'
  }
]

导入OfflineMapPage

离线地图使用的是OfflineMapPage组件，本组件在SDK内部实现，仅需要在当前Page中import { OfflineMapPage } from "@amap/amap_lbs_map3d" 即可使用OfflineMapPage组件。

使用离线地图组件

import { OfflineMapPage } from "@amap/amap_lbs_map3d"

@Entry
@Component
export struct MapOfflineMapController {
  build() {
      OfflineMapPage()
  }
}

UI示意

自定义离线地图UI

开始下载

可以根据城市编码和城市名称两种方式下载当前城市的离线地图。示例代码如下：

//构造OfflineMapManager对象 
this.amapManager = new OfflineMapManager(this.context, this)
//按照citycode下载
this.amapManager?.downloadByCityCode(citycode:string)；
//按照cityname下载
this.amapManager?.downloadByCityName(cityname:string)；

暂停下载

通过代码暂停地图的下载:

示例代码如下：

this.amapManager?.pause();

停止下载

停止所有当前正在执行的下载，包括下载队列中等待的部分。

示例代码如下：

this.amapManager.stop();

更改离线地图存储目录

离线地图默认会下载到手机存储卡的“amap”目录下，也可以自定义路径：

通过 MapInitializer.sdcardDir 设置路径时，需要在 AMap 对象初始化之前进行，否则操作会无效。

// 设置应用单独的地图存储目录
MapsInitializer.sdcardDir = "自定义的目录";

获取离线地图列表

其属性参数见下表：

检查更新

通过如下代码检查离线地图数据是否存在更新，检查更新操作会同时将本地离线地图配置文件更新成最新的，App 用户可依据最新的配置文件下载新版离线地图数据。

示例代码如下：

//通过updateOfflineCityByName方法判断离线地图数据是否存在更新
this.amapManager?.updateOfflineCityByName(city);

删除离线地图

执行 remove 操作时，需要等待 OfflineLoadedListener 回调之后才可以，否则（即使OfflineMapDownloadListener回调成功）操作将会无效。 

示例代码如下：

//删除某一城市的离线地图包
this.amapManager?.remove(city);