Mapbox 地图SDK极速集成指导

这次跟各位分享一个地图的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文件中添加下面的内容,用来导入依赖库。

repositories{mavenCentral()}
compile('com.mapbox.mapboxsdk:mapbox-android-sdk:4.2.0@aar') {
    transitive = true
}

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


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


这里提醒一下,在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中做好相关权限声明:





还有一个Service:


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

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

你可能感兴趣的:(Mapbox 地图SDK极速集成指导)