写在前面
单位项目对卫星地图影像要求比较高,然而百度地图和高德地图卫星影像覆盖的并不是非常完善,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,可以使用体验一下,之后在创建
创建成功之后,在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要显示什么样的地图,附地图样式,可以每种尝试效果,这里使用卫星地图样式
因为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
