示例中心
功能在线体验
menu Created with Sketch. closed Created with Sketch.

高德 开发 Android 地图SDK 开发指南 创建地图 自定义地图

更新时间:2019年11月18日

简介

自 Android 3D 地图 SDK v5.2.0起,高德地图支持使用可视化自定义地图模版改变底图颜色和样式,实现可视化的编辑和控制显示地图元素。

创建样式文件

创建地图样式

高德地图开放平台的开发者在取得开发者账号后,可以进入开发者控制台,在地图自定义平台选择“创建地图样式”,可以选择一个模板进行创建。


编辑地图样式 

在创建的页面的左侧列表选择任一要素编辑样式属性;也可以单击地图,在弹出的列表中选择要素进行编辑。


发布地图样式并下载 

编辑完成后点击右上角“保存”->“发布”,发布完成后,选择“使用方法”,然后选择“android”平台,点击“下载离线文件”。

设定样式文件

注意:自地图SDK v6.6.0 起,自定义地图使用方法进行了较大更新,具体请参见以下具体文档说明。

一、设定离线样式文件

1、在官网控制台-我的地图样式中选择与当前使用的地图SDK版本号所对应的版本进行样式文件下载:

2.下载得到的Zip文件,内部目录结构如下,每个文件都会对应 CustomMapStyleOptions 中一个接口:

文件名称

文件内容说明

对应接口

style_extra.data

扩展内容,如网格背景色等

CustomMapStyleOptions.setStyleExtraData/setStyleExtraPath

style.data

具体样式配置

CustomMapStyleOptions.setStyleData/setStyleDataPath

textures.zip

纹理图片(zip文件)

CustomMapStyleOptions.setStyleTextureData/setStyleTexturePath

注意:可将配置好的样式文件放入任意路径,比如“/mnt/sdcard/amap”

//该方法在AMap类中提供
aMap.setCustomMapStyle(
    new com.amap.api.maps.model.CustomMapStyleOptions()
    .setEnable(true)
    .setStyleDataPath("/mnt/sdcard/amap/style.data")
    .setStyleExtraPath("/mnt/sdcard/amap/style_extra.data")
    .setStyleTexturePath("/mnt/sdcard/amap/textures.zip") 
    );

注意:纹理功能需要开通相关权限才可使用。

二、设定在线样式文件(需要开通权限

1、如果觉得下载样式文件过程比较繁琐,也可以使用在线的方式调用:在自定义平台发布新样式后获得样式ID,并通过SDK的 setCustomMapStyleID 设置使用。如果需要变动样式,只需要在发布之后重新加载一次地图即可看到效果;

2、如果同时设置了在线样式和离线样式,会优先进行在线拉取,如果拉取失败了会再次读取离线样式;

3、示例代码:

//该方法在AMap类中提供
aMap.setCustomMapStyle(
    new com.amap.api.maps.model.CustomMapStyleOptions()
    .setEnable(true)
    .setStyleId("您的styleid")//官网控制台-自定义样式 获取
    );

注意:纹理暂不支持在线拉取,如果调用了styleid也需要将纹理通过setStyleTexturePath设置了才会生效。

新用户
福利
功能
在线体验
常见
问题