什么是MapBox?
Mapbox是一个可以免费创建并定制个性化地图的网站。
为什么使用MapBox?
做国际化。不是有google map吗？为什么还要用mapbox？因为mapbox使用国内的网络可以访问，而google map不行，虽然它很强大。那为什么不用其他的地图工具呢？其余的地图工具比如OpenLayers、OpenStreetMap等；因为其余的地图大多没有Android 和 IOS 的sdk支持，仅仅有web端，对开发人员来说不是很友好。
废话不多说，开撸。
安装SDK
首先去官网注册账号申请一个accessToken，至于如何注册就不用我再多逼逼了。建议去www.mapbox.com而非www.mapbox.cn,因为.cn是为国内专供的，不过上面的文档内容N久没有更新了,sdk版本才6.3.0，而官网上已经到了8.4.0了，可见已经落后好几个版本了。官网上通过各种浏览器都可以翻译页面，看起来还是能懂的
这里先放一个MapBox的demo，官网说的是让我们自己在google Play上下载，以我们正常的网络是下载不了的，我就先放一个出来
链接: https://pan.baidu.com/s/1KdRZQaOG6RlQRHk7jm2LPw 提取码: qu6v
在Gradle里添加
repositories {
mavenCentral()
}
dependencies {
implementation'com.mapbox.mapboxsdk:mapbox-android-sdk:8.4.0'
}
注意：添加Mapbox Maps SDK for Android后，您可能会有不匹配的Gradle依赖项。不要忘记您可以使用exclude group如下所示删除某些依赖项：
implementation ('com.mapbox.mapboxsdk:mapbox-android-sdk:8.4.0'){
exclude group: 'group_name', module: 'module_name'
}
同步build完成后即可使用，不过注意加上ndk过滤，减少apk的体积，因为大部分的cup型号都可以兼容armeabi-v7a。
defaultConfig {
ndk {
abiFilters 'armeabi-v7a'
}
}
创建一个地图
首先在application里初始化mapbox并设置你从官网获取到的accessToken。
public class MapApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
//初始化MapBox,设置accessToken
Mapbox.getInstance(this,getResources().getString(R.string.access_token));
}
}
然后新建activity和xml，使用mapview。
xml
activity
public class MapActivity extends AppCompatActivity {
private MapView mapView;
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mapView = findViewById(R.id.map_view);
mapView.getMapAsync(new OnMapReadyCallback() {
@Override
public void onMapReady(@NonNull MapboxMap mapboxMap) {
//必须设置地图样式
mapboxMap.setStyle(Style.MAPBOX_STREETS, new Style.OnStyleLoaded() {
@Override
public void onStyleLoaded(@NonNull Style style) {
}
});
}
});
}
}
此处Style.MAPBOX_STREETS是地图的样式，可以根据自己喜好更改(翻译为机翻,请见谅)：
1.Mapbox Streets： Mapbox Streets是一个全面的通用地图，强调道路和交通网络的清晰风格。
2.Outdoor： Mapbox Outdoors是一款通用地图，带有精选数据集和专为徒步旅行，骑自行车和最具冒险精神的用例量身定制的风格。
3.Light and Dark： Mapbox Light和Mapbox Dark是微妙的全功能地图，旨在提供地理环境，同时突出显示分析仪表板，数据可视化或数据叠加层上的数据。
4.Satellite：是我们的完整全局底图，可用作空白画布或自己数据的叠加层。
5.Satellite Streets：将我们的Mapbox Satellite与Mapbox Streets的矢量数据相结合。全面的道路，标签和POI信息为我们的高分辨率卫星图像中的清晰细节带来了清晰度和背景。
6.Traffic：使用提供的白天或夜间流量样式直观地显示实时流量。
至于每个样式都是如何的，请自行设置体验。
此外，mapbox还提供了一个插件，ChinaMapView，为国内用户定制打造，能更快的加载地图：
dependencies {
// China plugin dependency
implementation 'com.mapbox.mapboxsdk:mapbox-android-plugin-china:2.2.0'
}
ChinaMapView提供了一套特殊的Style，使用它的样式是需要一个特殊的China Mapbox访问令牌，要去联系MapBox的销售团队以提供这个令牌。
创建一个标记Marker
创建并显示一个Marker
在onStyleLoaded回调里添加如下代码：
//添加一个marker
//此处的mapboxMap是getMapAsync回调里的参数，建议设置一个全局变量
// 因为后面大部分功能都与这个相关
mapboxMap.addMarker(new MarkerOptions()
.setPosition(new LatLng( 30.727913,103.755929))
);
不过此处的addMarker和MarkerOptions都会被画上一条横线，也就是这些都是过时的方法了,点击源码一看，是让我们使用Mapbox Annotation Plugin，这是整合了mapbox里的很多方法，用起来更加方便，这里可以去官网(靓仔点这里)看看,包括刚刚说的ChinaMapView都是属于这些插件,至于过时的api，我们就不推荐使用，下面我就开始介绍这些插件的用法。
首先引入这些插件:
implementation 'com.mapbox.mapboxsdk:mapbox-android-plugin-annotation-v7:0.6.0'
这个插件主要是用于地图上的标记物，marker，划线，填充物等，首先介绍如何画标记的marker：
mapboxMap.setStyle(Style.MAPBOX_STREETS, new Style.OnStyleLoaded() {
@Override
public void onStyleLoaded(@NonNull Style mStyle) {
style = mStyle;
//首先实例化
symbolManager = new SymbolManager(mapView,mapboxMap,style);
//向当前的style里添加图标资源
style.addImage("marker-image", BitmapUtils.getBitmapFromDrawable(getResources().getDrawable(R.drawable.mapbox_ic_place)));
//随机一个坐标点
LatLng latLng = new LatLng((random.nextDouble() * -180.0) + 90.0,
(random.nextDouble() * -360.0) + 180.0);
SymbolOptions symbolOptions = new SymbolOptions()
.withLatLng(latLng)//坐标
.withIconImage("marker-image")//此处标签就是上边style里添加的值
.withIconOffset(new Float[]{0f,10f});//偏移量,分别是x轴和y轴
symbolManager.create(symbolOptions);//创建该坐标点
//移动视角到该坐标来
mapboxMap.moveCamera(CameraUpdateFactory.newLatLng(latLng));
}
});
这里添加marker的图标，是向mapbox地图图层里添加资源，key value形式，String和bitmap(此处BitmapUtils为mapbox的jar包里提供的工具类,mapbox_ic_place也是提供的矢量图标文件，若有需要可自行替换)，此外还有添加layer，这个以后会讲到的，现在暂时不急。
SymbolOptions 里有很多设置，诸如添加文字，旋转、大小、透明度等，还请自行实验；不过此处暂无infowindow，也就是弹窗，这个我以后会讲如何设置的。
Marker点击事件
在上文的基础上添加代码:
//设置marker置顶
symbolManager.setIconAllowOverlap(true);
//marker的点击事件
symbolManager.addClickListener(new OnSymbolClickListener() {
@Override
public void onAnnotationClick(Symbol symbol) {
Toast.makeText(MapActivity.this, "symbol:"+symbol.getId(), Toast.LENGTH_SHORT).show();
}
});
这里使用的symbolManager来设置点击回调的，如果添加了多个marker，则需要在点击回调里通过返回的symbol变量来判断当前点击的是哪个marker。
Marker的弹窗
Marker的弹窗，也就是infoWindow，在某度某德地图上直接设置infoWindow
就完事儿了，不过在mapbox里有多种方式可以设置。
根据marker不同，添加的方式也不同，如果是用mapboxMap.addMarker方式添加的marker的话，则需要用mMapboxMap.setInfoWindowAdapter来设置：
mapboxMap.addMarker(new MarkerOptions()
.setPosition(new LatLng( 30.727913,103.755929));
//此处为弹窗的信息框，测试使用sdk的api等级低的marker里有一个InfoWindowAdapter，可以点击marker显示弹窗
//不过无法控制infowindow的显示，并且废弃的marker的无法置顶，无法满足需求
mMapboxMap.setInfoWindowAdapter(new MapboxMap.InfoWindowAdapter() {
@Nullable
@Override
public View getInfoWindow(@NonNull Marker marker) {
View view= LayoutInflater.from(MainActivity.this).inflate(R.layout.item_marker_view,null);
view.setLayoutParams(new FrameLayout.LayoutParams(WRAP_CONTENT, WRAP_CONTENT));
return view;
}
});
此处mMapboxMap.setInfoWindowAdapter同样为过时的api方法，如果对展示的信息要求不高的话，可以适用，不过此处的infoWindow及marker无法置顶，有特殊需求的盆友谨慎使用。
还有一个mapbox提供的MarkerView，此为自定义marker，需要添加依赖：
//标记点的view
implementation 'com.mapbox.mapboxsdk:mapbox-android-plugin-markerview-v7:0.2.0'
//自定义markerView
View view= LayoutInflater.from(MainActivity.this).inflate(R.layout.item_marker_view,null);
view.setLayoutParams(new FrameLayout.LayoutParams(WRAP_CONTENT, WRAP_CONTENT));
//此处是官方提供的自定义markView插件，不过这个markerView的灵敏度不高，拖动地图不会立即适应,无法满足
MarkerView markerView = new MarkerView(new LatLng(40.73581,2.48784),view);
markerViewManager.addMarker(markerView);
此处就是将自定义的布局当做marker来使用，不过经过我的测试，此举用法对用户极度不友好，在拖动地图时，markerview会随着地图移动，且有时会消失，然后在地图上晃动几下才会出来，甚至在官网上也对用户提示希望使用SymbolLayer。
所以不推荐使用markerView。还有一种方式即SymbolOptions 的withIconImage，将布局转换成bitmap，再通过style.addImage()添加进去,这种的好处就是用SymbolOptions 方便管理所有的marker。
//加载布局
View pWindowView= LayoutInflater.from(MapActivity.this).inflate(R.layout.item_marker_view,null);
Bitmap bitmap = SymbolGenerator.generate(pWindowView);//将布局生成为bitmap
//向当前的style里添加图标资源
style.addImage("marker-image", bitmap);
//随机一个坐标点
LatLng latLng = new LatLng((random.nextDouble() * -180.0) + 90.0,
(random.nextDouble() * -360.0) + 180.0);
SymbolOptions symbolOptions = new SymbolOptions()
.withLatLng(latLng)//坐标
.withIconImage("marker-image")//此处标签就是上边style里添加的值
.withIconOffset(new Float[]{0f,10f});//偏移量,分别是x轴和y轴
symbolManager.create(symbolOptions);//创建该坐标点
//移动视角到该坐标来
mapboxMap.moveCamera(CameraUpdateFactory.newLatLng(latLng));
这里就没有那么多的限制了，拖动也不会和markerView一样晃动，可以自由设置布局，也可以置顶、偏移之类的操作，全都取决于SymbolOptions 如何设置，所有强烈推荐使用这种方式，最后补充一个将布局转换为bitmap的方法：
private static class SymbolGenerator {
/**
* 将一个view生成为bitmap
*
* @param view view 视图
* @return bitmap
*/
static Bitmap generate(@NonNull View view) {
int measureSpec = View.MeasureSpec.makeMeasureSpec(0, View.MeasureSpec.UNSPECIFIED);
view.measure(measureSpec, measureSpec);
//由于是生成的，未进行测量，所有需要进行measure操作
int measuredWidth = view.getMeasuredWidth();
int measuredHeight = view.getMeasuredHeight();
view.layout(0, 0, measuredWidth, measuredHeight);
Bitmap bitmap = Bitmap.createBitmap(measuredWidth, measuredHeight, Bitmap.Config.ARGB_8888);
bitmap.eraseColor(Color.TRANSPARENT);
Canvas canvas = new Canvas(bitmap);
view.draw(canvas);
return bitmap;
}
}
画线
画线也是用的mapbox提供的管理类，叫LineManager，用法也和SymbolManager大同小异，不过需要至少两个点才能构成：
//初始化线管理器
lineManager = new LineManager(mapView,mapboxMap,style);
//随机两个个坐标点
LatLng latLng1 = new LatLng((random.nextDouble() * -180.0) + 90.0,
(random.nextDouble() * -360.0) + 180.0);
LatLng latLng2 = new LatLng((random.nextDouble() * -180.0) + 90.0,
(random.nextDouble() * -360.0) + 180.0);
//点的集合，线是由多个点连接构成的，所有画线必须有至少两个点
List latLngList = new ArrayList<>();
latLngList.add(latLng1);
latLngList.add(latLng2);
LineOptions lineOptions = new LineOptions()//画线
.withLatLngs(latLngList)//坐标集合
.withLineColor(ColorUtils.colorToRgbaString(Color.RED))//线的颜色
.withLineWidth(5.0f);//线宽度
lineManager.create(lineOptions);//开始划线
//移动视角到刚好显示两个坐标的位置
mMapboxMap.animateCamera(CameraUpdateFactory.newLatLngBounds(new LatLngBounds.Builder().include(latLng1).include(latLng2).build(), 0));
填充
填充也和画线一样，不过需要至少三个的才能构成一个多边形填充物：
//随机三个坐标点
LatLng latLng1 = new LatLng((random.nextDouble() * -180.0) + 90.0,
(random.nextDouble() * -360.0) + 180.0);
LatLng latLng2 = new LatLng((random.nextDouble() * -180.0) + 90.0,
(random.nextDouble() * -360.0) + 180.0);
LatLng latLng3 = new LatLng((random.nextDouble() * -180.0) + 90.0,
(random.nextDouble() * -360.0) + 180.0);
//点的集合，填充必须是多边形，所有至少三个点连接构成
List latLngList = new ArrayList<>();
latLngList.add(latLng1);
latLngList.add(latLng2);
latLngList.add(latLng3);
//初始化填充管理器
fillManager = new FillManager(mapView,mapboxMap,style);
//填充点集合
List> listArrayList = new ArrayList<>();
listArrayList.add(latLngList);
FillOptions fillOptions=new FillOptions()//填充
.withLatLngs(listArrayList)
.withFillOpacity(0.5f)//填充色的透明度
.withFillColor(ColorUtils.colorToRgbaString(Color.RED));
fillManager.create(fillOptions);//开始填充
当然可以将连线与填充结合，形成类似于围栏的效果:
//初始化线管理器
lineManager = new LineManager(mapView,mapboxMap,style);
//初始化填充管理器
fillManager = new FillManager(mapView,mapboxMap,style);
//随机两个个坐标点
LatLng latLng1 = new LatLng((random.nextDouble() * -180.0) + 90.0,
(random.nextDouble() * -360.0) + 180.0);
LatLng latLng2 = new LatLng((random.nextDouble() * -180.0) + 90.0,
(random.nextDouble() * -360.0) + 180.0);
LatLng latLng3 = new LatLng((random.nextDouble() * -180.0) + 90.0,
(random.nextDouble() * -360.0) + 180.0);
//点的集合，线是由多个点连接构成的，所有画线必须有至少两个点，填充则三个点
List latLngList = new ArrayList<>();
latLngList.add(latLng1);
latLngList.add(latLng2);
latLngList.add(latLng3);
LineOptions lineOptions = new LineOptions()//画线
.withLatLngs(latLngList)//坐标集合
.withLineColor(ColorUtils.colorToRgbaString(Color.YELLOW))//线的颜色
.withLineOffset(1f)//线的偏移量，正值往外，负值往内
.withLineWidth(2.0f);//线宽度
lineManager.create(lineOptions);//开始划线
//移动视角到刚好显示两个坐标的位置
mMapboxMap.animateCamera(CameraUpdateFactory.newLatLngBounds(new LatLngBounds.Builder().include(latLng1).include(latLng2).build(), 0));
//填充点集合
List> listArrayList = new ArrayList<>();
listArrayList.add(latLngList);
FillOptions fillOptions=new FillOptions()//填充
.withLatLngs(listArrayList)
.withFillOpacity(0.5f)//填充色的透明度
.withFillColor(ColorUtils.colorToRgbaString(Color.RED));
fillManager.create(fillOptions);//开始填充
看起来是不是连线没有完整？少了一条线？其实只需将第一个点的复制一个加到最后一个区去即可：
latLngList.add(latLng1);
地图国际化
不知道你们有没有注意到我的图里有些是中文，有些是英文？其实我是设置这个地图的底层文本语言为中文的，不过mapbox汉化没做完全，基本只会修改大部分国家的名称，国家下面的市级省级都无法完全翻译，不过好在官方也提供了本地化翻译插件，可以翻译大部分的省级市级乃至乡镇的名称的名称。下面我来讲讲如何设置语言国际化(切换语言)；首先是通过mapbox自带的layer进行替换语言：
//通过style找到country也就是国家的标签，此外还有市级city之类的标签，不过大多都一样没有翻译完全
Layer mapText = mapboxMap.getStyle().getLayer("country-label");
//设置属性语言为俄语
mapText.setProperties(textField("{name_ru}"));
所以单单使用自带的可能实用性没那么强，下面来讲讲官方整理提供的插件，首先添加依赖：
repositories {
mavenCentral()
}
dependencies {
implementation 'com.mapbox.mapboxsdk:mapbox-android-plugin-localization-v8:0.11.0'
}
然后就可以改变语言：
/修改语言，此处是官方提供的一个本地化插件，如果使用官方demo的改变语言无法达到预期效果
LocalizationPlugin localizationPlugin=new LocalizationPlugin(mapView,mMapboxMap,mStyle);
localizationPlugin.setMapLanguage(MapLocale.SIMPLIFIED_CHINESE);
就先到这吧，以后有机会再继续写定位获取地址等使用。