写在前面
单位项目对卫星地图影像要求比较高, 然而百度地图和高德地图卫星影像覆盖的并不是非常完善, 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 中初始化:
之后在 AndroidManifest 文件中加入权限, 加载地图前的准备工作就做完了
class MyApp : Application(){
override fun onCreate() {
super.onCreate()
Mapbox.getInstance(applicationContext, Config.KEY)
}
}
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
显示地图
由于项目用 Kotlin + Anko 编写, 首先需要让 Anko 支持 Mapbox, 代码如下:
之后首先在 Activity 中使用 Anko 编写布局
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)
}
其中的 setStyleUrl 则是规定 MapBox 要显示什么样的地图, 附地图样式, 可以每种尝试效果, 这里使用卫星地图样式
relativeLayout {
mapView = mapView {
id = ViewID.MAP_ID
setStyleUrl(getResources().getString(R.string.mapbox_style_satellite_streets))
}.lparams(width = matchParent, height = matchParent)
}
MapBoxStyle
因为 Mapbox 有自己的生命周期, 用来在 android 上管理 OpenGL, 所以需要重写 Activity 的生命周期方法, 并调用 MapBox 的方法.
之后即可运行到手机上用于显示地图 (PS: 那个 FloatingActionButton 是我后加的)
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()
}
运行结果
由于未指定位置, 所以默认显示的就是这个样子, 指定位置有两种方式, 可以在布局文件中设置, 作为显示初始化位置:
也可以在代码中进行设置, 传入一个坐标, 值得一提的是, 在代码中设置是可以支持动画的
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)}
定位到当前位置:
基本百度地图和高德地图有的功能 MapBox 都有, 像大头针, 地图上画点线面等, 为了方便使用, 封装了一个 MapBoxUtils, 功能根据需求慢慢加, 代码已上传至 Github.....
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() {
// 定位服务
}
})
}
}
结尾
依然推荐一首歌, 最近比较喜欢 DJ
Time
来源: http://www.jianshu.com/p/623fc49f34ec