什么是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
android:id="@+id/map_view" android:layout_width="match_parent" android:layout_height="match_parent" android:layout_margin="10dp" mapbox:mapbox_cameraTargetLat="40.73581" mapbox:mapbox_cameraTargetLng="-73.99155" mapbox:mapbox_cameraZoom="1" > 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)) ); 创建一个marker 不过此处的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 这里添加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(); } }); marker点击 这里使用的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; } }); 过时的infoWindow 此处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); markerView 此处就是将自定义的布局当做marker来使用，不过经过我的测试，此举用法对用户极度不友好，在拖动地图时，markerview会随着地图移动，且有时会消失，然后在地图上晃动几下才会出来，甚至在官网上也对用户提示希望使用SymbolLayer。 官方不推荐使用MarkerView 所以不推荐使用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)); 通过视图生成自定义marker带infoWindow 这里就没有那么多的限制了，拖动也不会和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.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.add(latLng1); latLngList.add(latLng2); latLngList.add(latLng3); //初始化填充管理器 fillManager = new FillManager(mapView,mapboxMap,style); //填充点集合 List 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.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.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); 本地化插件切换语言 就先到这吧，以后有机会再继续写定位获取地址等使用。