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

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

更新时间:2018年11月02日

简介

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

创建样式文件

创建地图样式

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


编辑地图样式 

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


发布地图样式并下载 

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

设定样式文件

设定离线样式文件

1、将配置好的样式文件放入任意路径,比如”/sdcard/custom_config”(注意:自V5.2.0起,既支持style.json文件,也支持.data文件

2、设定地图样式文件的路径,通过以下方法设定自定义地图样式文件的绝对路径:

//该方法在AMap类中提供
setCustomMapStylePath("/sdcard/custom_config");

设定在线样式文件(需要在官网购买相关权限)

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

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

//该方法在AMap类中提供
setCustomMapStyleID("自定义平台发布后生成的id");

开启自定义样式

设置自定义地图后,自定义地图默认为关闭状态,可通过如下方法开启:

//该方法在AMap类中提供
setMapCustomEnable(Boolean enable);//true 开启; false 关闭

自定义纹理(需要在官网购买相关权限)

第 1 步,自定义平台配置纹理

在自定义平台选择支持纹理配置的属性(如陆地),选择配置纹理,可以选择平台提供的图片,也可以自行上传(注:图片大小为2^n*2^n效果会更好)(目前移动端支持的纹理为陆地、绿地、水系和建筑物)

第 2 步,下载样式文件

在第一步配置完成之后选择发布样式,回来到样式下载页面,参考之前提到的方式下载离线样式文件,下载名称为 mystyle_sdk_xx.zip 解压后结构如下

style.data
textures.zip

第 3 步,设置样式文件

将上一步中两个文件放入移动设备可以读取的地方,如Android的SD卡 /sdcard/custom_config/

  1. 设置样式配置文件路径
//该方法在AMap类中提供 
setCustomMapStylePath("/sdcard/custom_config/style.data"); setCustomTextureResourcePath("/sdcard/custom_config/textures.zip");
  1. 开启/关闭自定义样式功能
//该方法在AMap类中提供
 setMapCustomEnable(boolean enable);//true 开启; false 关闭

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

示例中心 功能
在线体验
常见问题