Android MapBox 使用详解

作者: gc都无法回收的垃圾 | 来源:发表于2020-03-05 15:28 被阅读0次

什么是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

<com.mapbox.mapboxsdk.maps.MapView
        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"
        >
    </com.mapbox.mapboxsdk.maps.MapView>

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<LatLng> 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<LatLng> latLngList = new ArrayList<>();
                        latLngList.add(latLng1);
                        latLngList.add(latLng2);
                        latLngList.add(latLng3);
                        //初始化填充管理器
                        fillManager = new FillManager(mapView,mapboxMap,style);
                        //填充点集合
                        List<List<LatLng>> 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<LatLng> 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<List<LatLng>> 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);

本地化插件切换语言

就先到这吧，以后有机会再继续写定位获取地址等使用。

Android MapBox 使用详解

什么是MapBox?

为什么使用MapBox?

安装SDK

创建一个地图

创建一个标记Marker

创建并显示一个Marker

Marker点击事件

Marker的弹窗

画线

填充

地图国际化

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读

Android 技术文章