用MapBox替换百度和高德地图

写在前面

单位项目对卫星地图影像要求比较高,然而百度地图和高德地图卫星影像覆盖的并不是非常完善,Google了好久,发现了这款地图供应商MapBox,拥有全球的卫星影像,虽然有的区域影像时间较老,但是总比没有强,所以用来替代,特此记录使用用法.

MapBox官网:
https://www.mapbox.com/

MapBox中国官网 (PS:搞不懂为毛还是英文)
https://www.mapbox.cn/

MapBox For Android GitHub地址:
https://github.com/mapbox/mapbox-gl-native/tree/master/platform/android

官方文档地址:
https://www.mapbox.com/android-docs/map-sdk/overview/

本文代码Github地址:
https://github.com/Xxxxxxyk/MapBox_Kotlin

加载地图前的准备

首先在build.gradle文件中依赖

implementation 'com.mapbox.mapboxsdk:mapbox-android-sdk:5.2.1'

之后在官网进行注册,注册成功之后创建一个token,默认提供了一个公共token,可以使用体验一下,之后在创建

创建token

创建成功之后,在Application中初始化:

class MyApp : Application(){
    override fun onCreate() {
        super.onCreate()
        Mapbox.getInstance(applicationContext, Config.KEY)
    }
}

之后在AndroidManifest文件中加入权限,加载地图前的准备工作就做完了

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

显示地图

由于项目用Kotlin + Anko编写,首先需要让Anko支持Mapbox,代码如下:

internal object ViewToKotin {
    //让Anko支持mapbox
    public final inline fun ViewManager.mapView(theme: Int = 0) = mapView(theme) {}

    public final inline fun ViewManager.mapView(theme: Int = 0, init: MapView.() -> Unit) = ankoView({ MapView(it) }, theme, init)    
}

之后首先在Activity中使用Anko编写布局

 relativeLayout {
            mapView = mapView {
                id = ViewID.MAP_ID
                setStyleUrl(getResources().getString(R.string.mapbox_style_satellite_streets))
            }.lparams(width = matchParent, height = matchParent)
}

其中的setStyleUrl则是规定MapBox要显示什么样的地图,附地图样式,可以每种尝试效果,这里使用卫星地图样式

MapBoxStyle

因为Mapbox有自己的生命周期,用来在android上管理OpenGL,所以需要重写Activity的生命周期方法,并调用MapBox的方法.

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        mapView.onCreate(savedInstanceState);
    }

    override fun onStart() {
        super.onStart()
        mapView.onStart();
    }

    override fun onResume() {
        super.onResume()
        mapView.onResume()
    }

    override fun onPause() {
        super.onPause()
        mapView.onPause()
    }

    override fun onStop() {
        super.onStop()
        mapView.onStop()
    }

    override fun onSaveInstanceState(outState: Bundle?) {
        super.onSaveInstanceState(outState)
        mapView.onSaveInstanceState(outState!!)
    }

    override fun onLowMemory() {
        super.onLowMemory()
        mapView.onLowMemory()
    }

    override fun onDestroy() {
        super.onDestroy()
        mapView.onDestroy()
    }

之后即可运行到手机上用于显示地图(PS:那个FloatingActionButton是我后加的)

运行结果

由于未指定位置,所以默认显示的就是这个样子,指定位置有两种方式,可以在布局文件中设置,作为显示初始化位置:

 mapbox:mapbox_cameraTargetLat="lat数值"
 mapbox:mapbox_cameraTargetLng="lng数值"

也可以在代码中进行设置,传入一个坐标,值得一提的是,在代码中设置是可以支持动画的

mapbox.getMapAsync { it.moveCamera(CameraUpdateFactory.newLatLng(latLng)) };

带动画的模式:

 mapbox.getMapAsync { it.animateCamera(CameraUpdateFactory.newLatLngZoom(LatLng(latLng), zoom), 1000)}

定位到当前位置:

fun moveToCurrentLocation() {
        mapbox.getMapAsync {
            val locationEngine = Mapbox.getLocationEngine()
            locationEngine.activate()

      //节省资源,我采取的如果上次定位存在的话,直接使用上次定位信息,可自由选择
            val lastLocation = locationEngine.lastLocation

            lastLocation?.let {
                moveToLocationZoom(LatLng(lastLocation), 15.0)
            }

            locationEngine.addLocationEngineListener(object : LocationEngineListener{
                override fun onLocationChanged(location: Location?) {
                    location?.let{
                        moveToLocationZoom(LatLng(location),15.0)
                        drawPoint(LatLng(location))
                    }
                }

                override fun onConnected() {
                    //定位服务
                }
            })
        }
    }

基本百度地图和高德地图有的功能MapBox都有,像大头针,地图上画点线面等,为了方便使用,封装了一个MapBoxUtils,功能根据需求慢慢加,代码已上传至Github.....

结尾

依然推荐一首歌,最近比较喜欢DJ

Time