简介

个性化地图，通过改变底图各元素和文字的颜色、可见性，实现地图多样展现效果，适配各个行业不同的地图呈现效果或适配不同App风格。

支持设置13大类、14子类的地图元素设置，包含陆地、水系、绿地、人造区域、建筑物、高速路、城市主路、普通道路、铁路、地铁，POI、行政区划、边界线等。

支持设置的地图元素的颜色、图标及其可见性的变更。

个性化地图功能位于 ”基础地图（Map）“这个功能模块，开发者使用时请注意选择。

效果示例：

个性化地图定制方式

两种方式：

通过个性地图编辑工具，自行编辑地图展示样式，生成地图样式JSON，然后通过【查看JSON】拿到JSON代码。注意：部分功能，JS API优先于地图SDK支持。请设置后，在工程中验证。

根据个性化地图元素说明规则，编辑JSON代码。

个性化地图元素说明

支持修改的地图元素

注意：版本支持是V4.5.0表示V4.5.0及以上版本新增属性，版本支持是V5.1.0表示V5.1.0及以上版本新增属性,V4.5.0以下版本更换版本后，请先验证显示效果。

地图元素	元素代码	形状边框 颜色	形状填充 颜色	文字边框 颜色	文字填充 颜色	icon 可见性	颜色 可见性	颜色 透明度	备注 版本支持
全部	all					√			V4.5.0
陆地	land	√	√				√	√	V4.2.0
水系	water	√	√				√	√
绿地	green	√	√				√	√
人造区域	manmade	√	√				√	√
人造区域之地铁区域	subwaystation	√	√			√	√	√	V4.5.0
人造区域之教育区域	education	√	√	√	√	√	√	√
人造区域之医疗区域	medical	√	√	√	√	√	√	√
人造区域之景点区域	scenicspots	√	√	√	√	√	√	√
人造区域之地产小区区域	estate	√	√	√	√	√	√	√	V5.1.0
人造区域之购物区域	shopping	√	√	√	√	√	√	√
人造区域之交通设施区域	transportation	√	√	√	√	√	√	√
建筑物	building	√	√				√	√	V4.2.0
高速及国道	highway	√	√	√	√	√	√	√
城市主路	arterial	√	√	√	√	√	√	√
普通道路	local	√	√	√	√	√	√	√
铁路	railway	√	√			√	√	√
地铁	subway	√	√			√	√	√
行政区边界	boundary	√	√				√	√
行政区化	districtlabel			√	√	√	√	√
全部POI标注（V4.5.0起不再去除行政区文字）	poilabel			√	√	√	√	√
行政区划之大洲	continent			√	√	√	√	√	V4.5.0
行政区划之国家	country			√	√	√	√	√
行政区划之省	province			√	√	√	√	√
行政区划之城市	city			√	√	√	√	√
行政区划之区县	district			√	√	√	√	√
行政区划之乡镇	town			√	√	√	√	√
机场标注	airportlabel			√	√	√	√	√
旅游景点标注	scenicspotslabel			√	√	√	√	√
教育标注	educationlabel			√	√	√	√	√
医疗标注	medicallabel			√	√	√	√	√
房产小区标注	estatelabel			√	√	√	√	√	V5.1.0
商务大厦标注	businesstowerlabel			√	√	√	√	√
公司企业标注	companylabel			√	√	√	√	√
政府机构标注	governmentlabel			√	√	√	√	√
餐饮类标注	restaurantlabel			√	√	√	√	√
宾馆类标注	hotellabel			√	√	√	√	√
购物类标注	shoppinglabel			√	√	√	√	√
生活服务类标注	lifeservicelabel			√	√	√	√	√
汽车服务类标注	carservicelabel			√	√	√	√	√
交通设施类标注	transportationlabel			√	√	√	√	√
金融类标注	financelabel			√	√	√	√	√
其它类标注	otherlabel			√	√	√	√	√

支持修改的元素类型和包容关系

以 highway 地图元素为例

元素类型elementType
元素代码featureType	形状边框颜色	形状填充颜色	文字边框颜色	文字填充颜色	icon可见性
highway	geometry.stroke	geometry.fill	labels.text.stroke	labels.text.fill	labels.icon
元素代码featureType	形状[边框]和[填充]颜色		文字[边框]和[填充]颜色
highway	geometry		labels.text

设置highway的道路边框和填充 为同一颜色时，既可以分别设置geometry.stroke和geometry.fill，也可以一起设置geometry

V5.1.0起同一元素多个样式同时同级别设置，生效策略做调整

功能说明：

因为涉及到样式缩放级别的控制，所以可见性(visibility)，颜色（color），宽度（weight）等样式的生效策略做了调整，

即：当同一元素的可见性（visibility）分别颜色（color），宽度（weight）一起设置时，以最后设置的样式生效；

使用示例：

[
    {
      "featureType":"green",
      "elementType":"geometry",
      "stylers": {
            "weight": "10"
         }
    },
    {
      "featureType":"green",
      "elementType":"geometry",
      "stylers": {
           "visibility": "off"
         }
   }
]

实际效果则以visibility样式生效。（注意：visibility默认为on）

设置指定级别控制元素生效

接口说明：

自V5.1.0起增加地图缩放级别进行设置个性化地图的自定义样式，即不同的缩放级别可以呈现不同的自定义样式。 A. Json样式的stylers中新增："level"字段，用来控制样式的生效级别，如果stylers中不配置"level"字段，则认为该样式在所有地图缩放级别生效; B. "level"字段的值在Json样式中以字符串表现，取值对标普通地图的缩放级别范围[4-21]。如果该字段值小于地图缩放级别的最小值，，则取地图缩放级别的最小值；如果该字段大于地图缩放级别的最大值，则取地图缩放缩放级别的最大值；

C. 如果Json样式，存在未指定缩放级别样式1和指定了生效的缩放级别样式2的同一元素，则在指定的缩放级别展示样式2，在其他缩放级别展示样式1；

使用示例：

 {
   "featureType":"highway",
   "elementType":"geometry",
   "stylers": {
         "color": "#FF1493",
         "level": "12"  //设置指定级别
     }
   }

设置宽度样式

接口说明：

自V5.1.0起增加宽度样式可以控制点元素，线元素的宽度展示，当前生效的元素包括：点元素（poi类元素，字体），线元素（如高速，地铁等）；

A. Json样式的stylers中新增: "weight"字段，用于指定元素要展示的宽度，不设置该字段则以默认样式宽度展示；

B. "weight"字段的值类型在Json样式中以字符串表现，取值范围为[0, 255]，当取值小于0时，实际以0值生效，当大于255时，以255生效；

使用示例：;

 {
   "featureType":"green",
   "elementType":"geometry",
   "stylers": {
        "weight": "10"
        }
   }

设置元素的颜色属性 - 透明度

（1）V4.5.2起增加透明度样式，针对所有可以设置颜色的元素属性，当前版本透明度只能和颜色一起设置，不能单独设置。

颜色格式：#RRGGBBAA ，R:Red、G:Green、B:Blue、 A:Alpha。注意：透明度顺序与路况图颜色的透明度顺序不一致。

如设置为人造区域的形状为黄色，且透明度为0x78 ，其中AA为透明度；透明度AA可以设置为0x00，即完全透明。

{
 "featureType": "manmade",
 "elementType": "geometry",
 "stylers": {
      "color": "#ffff0078" 
      //color的格式为 #RRGGBBAA
    }
}

（2）透明度样式的值使用十六进制，范围为：[0x00, 0xff]，默认值为0xff。为兼容以前的颜色样式，SDK旧版本的样式值将自动补齐透明度值，默认0xff，即不透明。

JSON代码示例：

1、设置形状填充颜色

 {
  "featureType": "highway",
  "elementType": "geometry.fill",
  "stylers": {
            "color": "#e7f7fc"
           }
 }

2、设置文字颜色</span>

{
  "featureType": "highway",
  "elementType": "labels.text.fill",
  "stylers": {
            "color": "#eeeeee"
           }
 }

3、隐藏高速和国道的icon

{
  "featureType": "highway",
  "elementType": "labels.icon",
  "stylers": {
            "visibility": "off"
           }
 }

实现个性化地图

配置样式文件

style_json.json中，配置如下所示的json串来设置不同的背景颜色。您可以根据需求，在设置不同的背景颜色

个性化地图样式文件

{
  "featureType": "grid",
  "elementType": "all",
  "stylers": {
            "color": "#e7f7fc"
           }
 }

另外，我们提供了3个标准模板样式文件和一个空白样式文件点击下载， 供大家使用。

设定文件路径

1、将配置好的样式文件放入任意路径，比如"/sdcard/custom_config"

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

//该方法需在MapView/TextureMapView构造之前设置。
MapView.setCustomMapStylePath("/sdcard/custom_config");

切换自定义地图

自V4.0起，支持个性化地图和普通地图切换。设置个性化地图后，个性化地图默认为关闭状态，需要设置生效。

MapView/TextureMapView/WearMapView新增接口, 切换个性化地图方法如下：

setMapCustomEnable(boolean customMapStyleEnable); //设置个性化地图样式是否生效

显示自定义颜色背景

新增加载地图瓦片时，设置显示自定义颜色背景的方法。在个性化地图的配置文件custom_configdir.txt中，添加如下json串，可设置不同的背景那个颜色。

{
    "featureType": "grid",
    "elementType": "all",
    "stylers": {
        "color": "#e7f7fc"
       }
}

适用于您的个性化地图为深色地图，加载地图瓦片时，将背景色设置为深色背景。

路况图路况颜色设置

Android SDK V4.5.0版本起支持路况颜色的自定义。支持对路况图的颜色做修改和取消显示，适用于在小屏幕上突出显示拥堵路况的场景。

路况颜色设置方法：

setCustomTrafficColor(String severeCongestion,String congestion,String slow,String smooth)

参数含义：String severeCongestion,String congestion,String slow,String smooth分别代表严重拥堵，拥堵，缓行，畅通。

颜色格式：#AARRGGBB A:Alpha、R:Red、G:Green、B:Blue；其中AA为透明度；4个参数必须全部设置，不需要的颜色，透明度AA可以设置为00，即透明不显示。

注意：透明度顺序与个性化地图中的透明度顺序不一致。

具体使用方法如下：

Step1. 打开路况开关，如下。否则样式定义不显示。

 mBaiduMap.setTrafficEnabled(true);

Step2. 调用路况设置API，自定义颜色，其中颜色值如有一项为null或者""，则自定义无效，显示默认颜色样式：

 mBaiduMap.setCustomTrafficColor("#ffba0101", "#fff33131", "#ffff9e19", "#00000000");

Step3. 对地图状态做更新，否则可能不会触发渲染，造成样式定义无法立即生效。

 MapStatusUpdate u = MapStatusUpdateFactory.zoomTo(13);
 mBaiduMap.animateMapStatus(u);