android地图sdk | 百度地图api sdk-凯发k8官方旗舰厅

自android地图sdk v6.3.0（包含）版本之后，个性化地图仅支持.sty格式的样式文件。如仍需使用json格式，请根据本文编辑json代码。

v6.0.0之前的版本：

protectedvoidonpause(){
super.onpause();
//在activity执行onpause时必须调用mmapview.onpause()
    mmapview.onpause();
}
@override
protectedvoidondestroy(){
super.ondestroy();
// 3、地图对象释放之前，需要调用静态方法，设置关闭个性化地图样式
mapview.setmapcustomenable(false);
// 在activity执行ondestroy时必须调用mmapview.ondestroy()
    mmapview.ondestroy();
}

v6.0.0及之后的版本：
a、本地离线样式加载方式，关键代码如下1、2两步：

// 地图view实例
privatemapview mmapview;
// 用于设置个性化地图的样式文件
privatestatic final stringcustom_file_name_gray="custom_map_config_gray.json";
@override
publicvoidoncreate(bundle savedinstancestate){
super.oncreate(savedinstancestate);
    mmapview =newmapview(this,newbaidumapoptions());
framelayout framelayout =newframelayout(this);
    framelayout.addview(mmapview);
setcontentview(framelayout);
// 获取.json文件路径
string customstylefilepath =getcustomstylefilepath(custommapdemo.this,custom_file_name_gray);
// 1、设置个性化地图样式文件的路径和加载方式
    mmapview.setmapcustomstylepath(customstylefilepath);
// 2、设置个性化地图样式是否生效
    mmapview.setmapcustomstyleenable(true);
}
@override
protectedvoidonresume(){
super.onresume();
// 在activity执行onresume时必须调用mmapview.onresume()
    mmapview.onresume();
}
@override
protectedvoidonpause(){
super.onpause();
//在activity执行onpause时必须调用mmapview.onpause()
    mmapview.onpause();
}
@override
protectedvoidondestroy(){
super.ondestroy();
// 在activity执行ondestroy时必须调用mmapview.ondestroy()
    mmapview.ondestroy();
}

b、通过样式id在线方式加载，关键代码如下1、2两步：

privatemapview mmapview;
// 用于设置个性化地图的样式文件
privatestatic final stringcustom_file_name_gray="custom_map_config_gray.json";
@override
publicvoidoncreate(bundle savedinstancestate){
super.oncreate(savedinstancestate);
    mmapview =newmapview(this,newbaidumapoptions());
framelayout framelayout =newframelayout(this);
    framelayout.addview(mmapview);
setcontentview(framelayout);
// 获取.json文件路径
string customstylefilepath =getcustomstylefilepath(custommapdemo.this,custom_file_name_gray);
// 1、在线个性化样式加载配置项
mapcustomstyleoptions mapcustomstyleoptions =newmapcustomstyleoptions();
    mapcustomstyleoptions.localcustomstylepath(customstylefilepath);//本地离线样式文件路径，如果在线方式加载失败，会默认加载本地样式文件。
    mapcustomstyleoptions.customstyleid("d868bebd0fe24fa59381acbcd4db24e3");//在线样式文件对应的id。
// 2、设置在线个性化样式配置
    mmapview.setmapcustomstyle(mapcustomstyleoptions,newcustommapstylecallback(){
        @override
public boolean onpreloadlastcustommapstyle(string customstylepath){
returnfalse;//默认返回false，由sdk内部处理加载逻辑；返回true则sdk内部不会做任何处理，由开发者自行完成样式加载。
}
        @override
public boolean oncustommapstyleloadsuccess(boolean hasupdate,string customstylepath){
returnfalse;//默认返回false，由sdk内部处理加载逻辑；返回true则sdk内部不会做任何处理，由开发者自行完成样式加载。
}
        @override
public boolean oncustommapstyleloadfailed(int status,stringmessage,string customstylepath){
returnfalse;//默认返回false，由sdk内部处理加载逻辑；返回true则sdk内部不会做任何处理，由开发者自行完成样式加载。
}
});
}
@override
protectedvoidonresume(){
super.onresume();
// 在activity执行onresume时必须调用mmapview.onresume()
    mmapview.onresume();
}
@override
protectedvoidonpause(){
super.onpause();
//在activity执行onpause时必须调用mmapview.onpause()
    mmapview.onpause();
}
@override
protectedvoidondestroy(){
super.ondestroy();
// 在activity执行ondestroy时必须调用mmapview.ondestroy()
    mmapview.ondestroy();
}

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

边框和填充为同一颜色时，既可以分别设置geometry.stroke和geometry.fill，也可以一起设置geometry
某一元素的多样式同级别配置策略（待确定）
自v5.1.0起，由于涉及到样式在不同缩放级别的控制生效，针对可见性(visibility)，颜色（color），宽度（weight）等样式的生效策略做了调整。当同一元素的可见性（visibility）、颜色（color）、宽度（weight）一起设置时，以最后设置的样式生效；
示例如下：首先将地图元素（水系）的颜色属性配置为绿色，然后又配置了visibility属性为off。则此时water元素将以后面一个配置生效，不会显示绿色。

{
"featuretype":"water",
"elementtype":"all",
"stylers":{
"color":"#00ff00ff"
}
},
{
"featuretype":"water",
"elementtype":"all",
"stylers":{
"visibility":"off"
}
},

设置颜色样式
在个性化地图的配置文件custom_configdir.json中，添加如下json串，可设置不同的背景颜色。
示例如下：配置后，地图上所有的水系元素都会展示为绿色。

{
"featuretype":"water",
"elementtype":"all",
"stylers":{
"color":"#00ff00ff"
}
}

设置分级别控制元素生效
自v5.1.0起不同的地图缩放级别支持呈现不同的自定义样式，json样式stylers中的"level"字段，用来控制样式的生效级别。
指定级别生效原则：
1.该字段的值在json样式中以字符串表现，取值对标普通地图的缩放级别范围[4-21]。baidumap sdk 定义缩放级别和比例尺的关系参考显示地图。
2.如果stylers中不配置"level"字段，则该样式在所有地图缩放级别生效;
3.如果json样式，存在未指定缩放级别样式1和已指定生效的缩放级别样式2的同一元素，则在指定的缩放级别展示样式2，在其他缩放级别展示样式1；
示例如下：高速公路的样式会在11级别显示为蓝色，其他级别显示默认的颜色。

{
"featuretype":"highway",
"elementtype":"geometry.fill",
"stylers":{
"color":"#0000ffff",
"level":"11",
}
}

设置宽度样式
自v5.1.0起，json样式的stylers新增weight字段支持点、线元素的宽度配置，比如点元素（poi类元素，字体），线元素（如高速，地铁等）。
宽度配置生效原则：
1.该字段的值在json样式中以字符串表现，取值范围为[0, 255]。
2.如果不设置该字段，则以默认样式宽度展示。
示例如下：告诉公路显示的宽度为20。

{
"featuretype":"highway",
"elementtype":"geometry.fill",
"stylers":{
"weight":"20"
}
}

设置透明度样式
自v4.5.2起，增加透明度样式，适用所有可以设置颜色的元素属性，通过“color”字段赋值，格式如下：

#rrggbbaa
r：red
g：green
b：blue
a：alpha，透明度aa可以设置为0x00，即完全透明。

注意：当前版本透明度不支持单独设置。 透明度生效原则
1.当前版本透明度不支持单独设置，与颜色样式一起设置。
2.该字段的值使用十六进制，范围为：[0x00, 0xff]，默认值为0xff，即不透明。
3.为兼容以前的颜色样式，sdk旧版本的样式值将自动补齐透明度值，默认0xff，即不透明。
示例如下：配置后，所有的高速公路显示的颜色为是，透明度为0x0f的蓝色样式。

{
"featuretype":"highway",
"elementtype":"geometry.fill",
"stylers":{
"color":"#0000ff0f"
}
}

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