Mapbox 地图SDK极速集成指导

Posted 2022-06-23 萧文翰

这次跟各位分享一个地图的SDK。先说说为什么拿Mapbox来用吧。
首先就是——国际化。当需求要显示国外的地理位置信息的时候，通常使用的是Google Map。但是Google Map目前需要手机带有完整的Google Play套件才行，但是基本上所有的国内上市的手机都把Google Play套件阉割了。然后就是偏移量，从目前来看，Mapbox的路网和卫星照片是重合的，而Google Map则是有一定的偏移，尤其是在中国。最后呢，Mapbox的集成方式实在是太简单了。不过呢，说了这么多优点，再说一个缺点。就是Mapbox的卫星照片略慢，尤其是中国，某些地方还停留在几年前的样子，这个以年为单位，一点都不夸张。
如果你需要做海外的地图定位，个人认为，Mapbox可作为首选。
下面说一下具体的集成方法。
首先，需要去官网注册一个账号，这里附上官网地址链接：
https://www.mapbox.com/
注册完成后，进入网页Studio界面，我们会轻松找到Access Token。我们后面会用到。
然后新建一个android项目，这里推荐targetAPI<23，但是必须大于15。
在app目录下的build.gradle文件中添加下面的内容，用来导入依赖库。

repositoriesmavenCentral()
compile('com.mapbox.mapboxsdk:mapbox-android-sdk:4.2.0@aar') 
    transitive = true

这里注意版本，虽然复制粘贴过去没有问题，但是依赖库的版本还在不断更新，也许下一秒就发布4.2.1或者其他什么版本，所以这个还是有必要直接去官网上看一下。网址在此：
https://www.mapbox.com/android-sdk/
下一步我们在布局文件中添加地图控件，很简单，最简易的写法可以像下面这样：

<com.mapbox.mapboxsdk.maps.MapView
    android:id="@+id/mapview"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent" />

当然，我们需要显示一个自己比较熟悉的位置，而且还要能够看得足够清晰，可以写成像下面这样：

<com.mapbox.mapboxsdk.maps.MapView
    android:id="@+id/mapview"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    mapbox:center_latitude="39.069"
    mapbox:center_longitude="117.221"
    mapbox:style_url="@string/style_satellite_streets"
    mapbox:zoom="15" />

这里提醒一下，在xml最上方加上命名空间，否则会报错：

xmlns:mapbox="http://schemas.android.com/apk/res-auto"  

这样做，可以同时显示路网和卫星照片，虽然卫星照片可能比较过时，但是确实很清楚。而且可以稍微移动一下，看看国外的风景，情况就大不一样了。
下一步需要在Activity中完成初始化等操作，在onCreate()方法中添加如下代码：

setContentView(R.layout.activity_main);
    MapboxAccountManager.start(this, getString(R.string.access_token));
    mv = (MapView) findViewById(R.id.mapview);
    mv.onCreate(savedInstanceState);
    mv.getMapAsync(new OnMapReadyCallback() 
        @Override
        public void onMapReady(MapboxMap mapboxMap) 

        
    );

当然，这只是个例子。
这里要注意的就是必须在Activity中的各个生命周期中添加相应的方法，比如onResume()中，需要加上：

mv.onResume();

其他生命周期回调类似。
最后在AndroidManifest.xml中做好相关权限声明：

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.INTERNET" />

还有一个Service：

<service android:name="com.mapbox.mapboxsdk.telemetry.TelemetryService" />

该Service在Application节点内。
好了，运行一下吧，一切顺利的话就可以看到地图的显示了。

下面附上完整的项目源码：
https://github.com/XiaoWenHan/MapboxAndroidDemo