使用离线地图 最后更新时间: 2021年01月22日
高德3D 地图 SDK支持离线地图功能。（2D 地图 SDK 不支持离线地图功能）
离线地图可满足在无网络环境下查看地图信息的需求，在设备本地有离线地图数据的情况下，SDK 会优先加载离线地图。
离线数据项 MAOfflineItem 包含城市编码、城市名称、数据状态等离线地图数据包的基本信息，是离线数据省信息（MAOfflineProvince）和离线数据城市信息（MAOfflineCity）的基类。离线数据城市信息（MAOfflineCity）又派生出三个子类，分别是全国概要图（MAOfflineItemNationWide）、直辖市（MAOfflineItemMunicipality）和普通城市（MAOfflineItemCommonCity）。
上述各类的关系如下图所示，也可以参见参考手册中的描述。
离线地图UI组件（推荐）
自3D地图SDK v 5.7.0起，新增离线地图UI组件，组件涵盖城市下载、暂停、更新、删除以及关键字城市查询等功能，是高德地图客户端离线地图功能的一个子集，UI交互风格上靠拢高德地图app，也考虑到与开发者应用UI的融合问题，尽可能的保持了简约极致。以下方法实现一键完成离线地图开发：
UIViewController *detailViewController = [MAOfflineMapViewController sharedInstance]; [self.navigationController pushViewController:detailViewController animated:YES];UI示意
自定义离线地图
开始下载
获取离线数据项的示例代码如下：
[[MAOfflineMap sharedOfflineMap] downloadItem:item shouldContinueWhenAppEntersBackground:YES downloadBlock:^(MAOfflineMapDownloadStatus downloadStatus, id info) { /* Manipulations to your application’s user interface must occur on the main thread. */ } MAOfflineMap.shared().downloadItem(item, shouldContinueWhenAppEntersBackground: true) { (downloadItem, downloadStatus, info) in //通过获取info和status对UI进行操作 }解析离线地图数据
解析离线数据项的示例代码如下：
self.cities = [MAOfflineMap sharedOfflineMap].cities;//普通城市和直辖市 self.provinces = [MAOfflineMap sharedOfflineMap].provinces;//省 self.municipalities = [MAOfflineMap sharedOfflineMap].municipalities;//直辖市 self.cities = MAOfflineMap.shared().cities self.provinces = MAOfflineMap.shared().provinces self.municipalitiesMAOfflineMap.shared().municipalities暂停离线地图下载
示例代码如下：
[[MAOfflineMap sharedOfflineMap] pauseItem:item]; MAOfflineMap.shared().pause(item)停止所有下载
停止所有离线地图下载的方法为：
[[MAOfflineMap sharedOfflineMap] cancelAll]; MAOfflineMap.shared().cancelAll()检查更新
通过如下代码检查离线地图数据是否存在更新，检查更新操作会同时将本地离线地图配置文件更新成最新的，App 用户可依据最新的配置文件下载新版离线地图数据。
[[MAOfflineMap sharedOfflineMap] checkNewestVersion:^(BOOL hasNewestVersion) { if (!hasNewestVersion) { return; } //更新处理 }]; MAOfflineMap.shared().checkNewestVersion { (hasNewVersion) in if !hasNewVersion { return } // 更新处理 }删除离线地图
单条删除
[[MAOfflineMap sharedOfflineMap] deleteItem:item]; MAOfflineMap.shared().delete(item)全部删除
/** * 清除所有在磁盘上的离线地图数据, 之后调用[mapView reloadMap]会使其立即生效 */ - (void)clearDisk; MAOfflineMap.shared().clearDisk()