分为地图,定位,搜索(我还没做导航功能)
建议采用gradle方式集成
添加依赖
在project/build.gradle文件下添加jcenter的仓库地址
allprojects {
repositories {
jcenter() // 或者 mavenCentral()
}
}
在app/build.gradle下添加依赖
android {
defaultConfig {
ndk {
//设置支持的SO库架构(开发者可以根据需要,选择一个或多个平台的so)
abiFilters "armeabi", "armeabi-v7a", "arm64-v8a", "x86","x86_64"
}
}
}
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
//3D地图so及jar
compile 'com.amap.api:3dmap:latest.integration'
//定位功能
compile 'com.amap.api:location:latest.integration'
//搜索功能
compile 'com.amap.api:search:latest.integration'
}
navi导航SDK 5.0.0以后版本包含了3D地图SDK,所以请不要同时引入 map3d 和 navi SDK。
添加权限
在AndroidManifest.xml文件下添加权限
添加高德key
同时创建debug和release的密钥文件,在app/build.gradle下做配置:
android {
signingConfigs {
release {
keyAlias 'xxxxxx'
keyPassword 'xxxxxx'
//..表示工程目录路径
storeFile file('../jks/map_release.jks')
storePassword 'xxxxxx'
}
debug {
keyAlias 'xxxxxx'
keyPassword 'xxxxxx'
storeFile file('../jks/map_debug.jks')
storePassword 'xxxxxx'
}
}
}
然后获取debug和release下的sha1值,在高德地图控制台创建key
然后在app/build.gradle下设置两种key,这里的key-value是一样的。因为高德控制台同一个应用下配置了debug和release的sha1值。
android {
buildTypes {
debug {
manifestPlacesholders = [
//左边的键MAP_API_KEY是自定义的名字,右边的key-value是你申请的key值
"MAP_API_KEY" : "key-value"
]
}
release{
manifestPlacesholders = [
//左边的键MAP_API_KEY要和debug下的保持一致,右边的key-value是你申请的key值
"MAP_API_KEY" : "key-value"
]
}
}
}
采用gradle方式集成,不需要在AndroidManifest.xml中添加key,添加定位服务
android:name="com.amap.api.v2.apikey"
//要和app/build.gradle文件中设置的保持一致
android:value="${MAP_API_KEY}"/>
使用地图
在布局中引入地图MapView
// R.layout.activity_your_activity
android:id="@+id/map"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
管理地图的生命周期(非常重要),以Activity为例
public class YourActivity extends AppcompatActivity{
MapView mMapView = null;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_your_activity);
//获取地图控件引用
mMapView = (MapView) findViewById(R.id.map);
//在activity执行onCreate时执行mMapView.onCreate(savedInstanceState),创建地图
mMapView.onCreate(savedInstanceState);
}
@Override
protected void onDestroy() {
super.onDestroy();
//在activity执行onDestroy时执行mMapView.onDestroy(),销毁地图
mMapView.onDestroy();
}
@Override
protected void onResume() {
super.onResume();
//在activity执行onResume时执行mMapView.onResume (),重新绘制加载地图
mMapView.onResume();
}
@Override
protected void onPause() {
super.onPause();
//在activity执行onPause时执行mMapView.onPause (),暂停地图的绘制
mMapView.onPause();
}
@Override
protected void onSaveInstanceState(Bundle outState) {
super.onSaveInstanceState(outState);
//在activity执行onSaveInstanceState时执行mMapView.onSaveInstanceState (outState),保存地图当前的状态
mMapView.onSaveInstanceState(outState);
}
}
构造一个AMap对象
if(mAMap == null){
mAMap = mapView.getMap();
}
初始化地图的相关属性
相关类UiSettings(不做介绍,具体看官方文档),CameraUpdateFactory,CameraUpdate
对于CameraUpdateFactory,文档介绍
创建CameraUpdate 对象,用来改变地图状态。
调用 AMap.animateCamera(CameraUpdate) or AMap.moveCamera(CameraUpdate)。
地图中心点
//设置地图中心点
static CameraUpdate changeLatLng(LatLng latLng)
static CameraUpdate newLatLng(LatLng latLng)
地图缩放级别
static CameraUpdate zoomTo(float zoom);
地图中心点和缩放级别
//设置地图中心点以及缩放级别
static CameraUpdate newLatLngZoom(LatLng latLng, float zoom)
设置显示在规定屏幕范围内的地图经纬度范围
static CameraUpdate newLatLngBounds(LatLngBounds bounds, int padding)
创建LatLngBounds对象,LatLngBounds(LatLng southwest, LatLng northeast)
使用传入的西南角坐标和东北角坐标创建一个矩形区域。
添加marker
1.相关类
MarkerOptions
为marker设置属性
BitmapDescriptorFactory
生成BitmapDescriptor对象,设置给marker的icon.
BitmapDescriptor
给marker设置icon,MarkerOptions.icon(BitmapDescriptor)
2.相关API
第二个方法添加一组marker,地图会移动到该组marker所在区域的中心
//在地图上添一个图片标记(marker)对象。
Marker addMarker(MarkerOptions options)
//在地图上添一组图片标记(marker)对象,并设置是否改变地图状态以至于所有的marker对象都在当前地图可视区域范围内显示。
java.util.ArrayList addMarkers(java.util.ArrayList options, boolean moveToCenter)
3.如何使用:
//MarkerOptions的具体设置看官方文档
MarkerOptions markerOptions = new MarkerOptions();
//设置marker坐标
markerOptions.position(latLng);
//marker是否可拖拽
markerOptions.draggable(false);
//marker图标
markerOptions.icon(BitmapDescriptorFactory.fromBitmap(bitmap));
BitmapDescriptorFactory位于com.amap.api.maps.model包下,包含多个生成BitmapDescriptor的方法,如果一组marker的图标是一致的,建议先通过BitmapFactory生成一个bitmap,再通过BitmapDescriptorFactory.fromBitmap(bitmap)设置给marker.
如果一组marker数据量很大,不建议for循环遍历逐个添加.
MarkerOptions markerOptions = new MarkerOptions();
Bitmap bitmap = BitmapFactory.decodeResources(drawableResId);
List dataBeanList = new ArraryList<>();
int size = dataBeanList .size();
for(int x = 0;x< size; x++){
//设置marker坐标
markerOptions.position(latLng);
//marker是否可拖拽
markerOptions.draggable(false);
//marker图标
markerOptions.icon(BitmapDescriptorFactory.fromBitmap(bitmap));
//添加后返回该marker
Marker marker = mAMap.addMarker(markerOptions);
//为marker添加信息
marker.setObject(dataBeanList.get(x));
}
上面这种方式添加的marker数据量过大的话,marker会逐一显示在屏幕上,视觉效果不太好,建议采用下面的方法,通过addMarkers(List)一次性全部添加.
MarkerOptions markerOptions = new MarkerOptions();
//一组marker的图标一致的话,事先生成这个图标的bitmap实例对象
Bitmap bitmap = BitmapFactory.decodeResources(drawableResId);
List dataBeanList = new ArraryList<>();
ArrayList markerOptionList = new Arrary<>();
for(int x = 0;x< size; x++){
//设置marker坐标
markerOptions.position(latLng);
//marker是否可拖拽
markerOptions.draggable(false);
//marker图标
markerOptions.icon(BitmapDescriptorFactory.fromBitmap(bitmap));
markerOptionList.add(markerOptions);
}
// 添加后返回一组Marker
ArrayList markerList = mAMap.addMarkers(markerOptionList);
int index = 0;
for(Marker marker : markerList ){
//为marker设置信息
marker .setObject(dataBeanList.get(index++));
}
这种方法,可以使一组marker几乎同时出现,视觉效果更好.
4.marker的点击事件不再介绍.
5.更改已添加过的marker的属性
marker.setIcon()似乎无效果.待测
显示定位蓝点
未完待续