示例中心
功能在线体验
控制台

高德 开发 Android 地图SDK 开发指南 创建地图 使用离线地图

更新时间:2018年01月03日

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

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

离线地图UI组件(推荐)

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

增加权限

权限包涵网络和SD卡读写权限 
<uses-permission android:name="android.permission.INTERNET" /> 
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> 
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

注册Activity

Activity在SDK内部实现,仅需要在工程 AndroidManifest.xml 中配置 com.amap.api.maps.offlinemap.OfflineMapActivity 即可

<activity android:name="com.amap.api.maps.offlinemap.OfflineMapActivity"
              android:screenOrientation="portrait"  />

启动离线地图组件

//在Activity页面调用startActvity启动离线地图组件
startActivity(new Intent(this.getApplicationContext(),
                    com.amap.api.maps.offlinemap.OfflineMapActivity.class));

UI示意


自定义离线地图UI

开始下载

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

//构造OfflineMapManager对象 
OfflineMapManager amapManager = new OfflineMapManager(this, this);
//按照citycode下载
amapManager.downloadByCityCode(String citycode);
//按照cityname下载
amapManager.downloadByCityName(String cityname);


暂停下载

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

示例代码如下:

amapManager.pause();


停止下载

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

示例代码如下:

amapManager.stop();


更改离线地图存储目录

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

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

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


获取离线地图列表

其属性参数见下表:

名称

说明

获取城市列表

OfflineMapManager.getOfflineMapCityList()

获取省列表

OfflineMapManager.getOfflineMapProvinceList()

获取已下载城市列表

OfflineMapManager.getDownloadOfflineMapCityList()

获取正在或等待下载城市列表

OfflineMapManager.getDownloadingCityList()

检查更新

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

示例代码如下:

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

删除离线地图

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

示例代码如下:

//删除某一城市的离线地图包
amapManager.remove(city);
移动端
示例中心
功能
在线体验
常见问题