寫在前面

單位項目對衛(wèi)星地圖影像要求比較高,然而百度地圖和高德地圖衛(wèi)星影像覆蓋的并不是非常完善,Google了好久,發(fā)現(xiàn)了這款地圖供應(yīng)商MapBox,擁有全球的衛(wèi)星影像,雖然有的區(qū)域影像時間較老,但是總比沒有強,所以用來替代,特此記錄使用用法.

MapBox官網(wǎng):
https://www.mapbox.com/

MapBox中國官網(wǎng) (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

加載地圖前的準(zhǔn)備

首先在build.gradle文件中依賴

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

之后在官網(wǎng)進行注冊,注冊成功之后創(chuàng)建一個token,默認(rèn)提供了一個公共token,可以使用體驗一下,之后在創(chuàng)建

創(chuàng)建token

創(chuàng)建成功之后,在Application中初始化:

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

之后在AndroidManifest文件中加入權(quán)限,加載地圖前的準(zhǔn)備工作就做完了

<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則是規(guī)定MapBox要顯示什么樣的地圖,附地圖樣式,可以每種嘗試效果,這里使用衛(wèi)星地圖樣式

MapBoxStyle

因為Mapbox有自己的生命周期,用來在android上管理OpenGL,所以需要重寫Activity的生命周期方法,并調(diào)用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是我后加的)

運行結(jié)果

由于未指定位置,所以默認(rèn)顯示的就是這個樣子,指定位置有兩種方式,可以在布局文件中設(shè)置,作為顯示初始化位置:

 mapbox:mapbox_cameraTargetLat="lat數(shù)值"
 mapbox:mapbox_cameraTargetLng="lng數(shù)值"

也可以在代碼中進行設(shè)置,傳入一個坐標(biāo),值得一提的是,在代碼中設(shè)置是可以支持動畫的

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

帶動畫的模式:

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

定位到當(dāng)前位置:

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

      //節(jié)省資源,我采取的如果上次定位存在的話,直接使用上次定位信息,可自由選擇
            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() {
                    //定位服務(wù)
                }
            })
        }
    }

基本百度地圖和高德地圖有的功能MapBox都有,像大頭針,地圖上畫點線面等,為了方便使用,封裝了一個MapBoxUtils,功能根據(jù)需求慢慢加,代碼已上傳至Github.....

結(jié)尾

依然推薦一首歌,最近比較喜歡DJ

Time