高德地图api有几大功能模块:Amap,Location,Search,OfflineMap
首先我们查看文档,并导入Demo项目来学习一下basic map功能:
首先有几个重要的类:
打开jar package(Android_Map_V2.jar)中的package(com.amap.api.maps)有Amap,MapFragment,SupportMapFragment,MapView,Projection等重要的类。
首先我们要清楚Amap是高德地图的核心,其提供了map服务,为MapView和Frament(SupportFragment)是加载map的组件:
我们通过一个基本案例来学习如何加载map:
step1:
编写AndroidManiFest配置文档:
<meta-data
android:name="com.amap.api.v2.apikey"
android:value="d460709e9d9db7763284e31fc95cdc36" />
这一步就是将你为你的apps申请的api key应用到这个配置文档中;
step 2:
- <?xml version="1.0" encoding="utf-8"?>
- <fragment
- android:id="@+id/map"
- android:name="com.amap.api.maps.SupportMapFragment"
- android:layout_width="match_parent"
- android:layout_height="match_parent" />
这是自定义布局xml中的关键加载map的UI组件,用来显示map;
step 3:
aMap = ((SupportMapFragment) getSupportFragmentManager()
.findFragmentById(R.id.map)).getMap();
这一步是在代码中调用getSupportFragmentManager.findFragmentById().getMap()方法让Fragment来显示map服务提供的地图。
这样简单地三步就可以在应用中加载最简单的basic map了
Basic Map截图如下:
由于有的到时候我们查看兴趣点需要一些清晰的基本信息,所以接下来我们来查看如何给指定地点添加一些标记(Marker):
关键代码如下:
- aMap = ((SupportMapFragment) getSupportFragmentManager().findFragmentById
- (R.id.map)).getMap();
- LatLng marker1 = new LatLng(39.24426, 100.18322);
- aMap.addMarker(new MarkerOptions().position(marker1).title("Marker1 ")
- .icon(BitmapDescriptorFactory
- .defaultMarker(BitmapDescriptorFactory.HUE_AZURE)).draggable(true));
标记累MarKerOptions的几个参数解释如下:
position:设置要设置标记的兴趣点的位置;
title:点击兴趣点是提示的标题
snippet:点击兴趣点是提示框的具体内容
draggable:设置兴趣点是否可以拖拽
icon:设置兴趣点的图标
关于icon这个参数,须通过过BitmapDescriptorfactory类来设置,汽油机中方法:
1 .defaultMarker()方法,Amap默认为我们提供了十个常量图标;
2 .FromResource()方法,从项目资源加载图标;
3 .FromAsset()方法,从生文件中加载;
4 .FromFile(String path)方法,从具体文件中加载;
5 .FromBitMap()方法,使用位图像;
这样我们就为我们需要加标记的兴趣点加了自定义的标记。
标记功能截图如下:
1
对于Basic Map中的添加Marker我们有一些事件处理:
- 点击标记事件
- 拖动标记事件
- 点击信息窗口
1 OnMarkerClickListener(OnMarkerClick)
2 OnMarkerDragListener(OnMarkerDrag)
3 OnInfoWindowClickListener(OnInfoWindowClick)
再从刚才的例子中获取对于白标记点击时间的处理:
defaultMarker = aMap.addMarker(new MarkerOptions()
.position(Constants.FANGHENG).title("方恒").snippet("方恒国际中心大楼A座")
.icon(BitmapDescriptorFactory.defaultMarker()));
aMap.getUiSettings().setZoomControlsEnabled(true);// 设置系统默认缩放按钮可见
aMap.setOnMarkerClickListener(this);// 对marker添加点击监听器
这是设置一个兴趣点的标记,然后看监听事件的代码:
@Override
public boolean onMarkerClick(Marker marker) {
if (marker.equals(defaultMarker)) {
ToastUtil.show(BasicMapActivity.this, marker.getSnippet());
}
return false;
}
点击截图:
除了处理点击事件外,Amap还有一些常用的方法和时间处理:
1 比例尺:
public void getScale(View v) {
float scale = aMap.getScalePerPixel();
Toast.makeText(BasicMapActivity.this, "每像素代表" + scale + "米",
Toast.LENGTH_SHORT).show();
}
}
调用amp.getScalePerPixer()方法来获得比例尺;
2 处理截屏事件:
public void getMapScreenShot(View v) {
aMap.getMapPrintScreen(new AMap.onMapPrintScreenListener() {
@Override
public void onMapPrint(Drawable r) {
Bitmap bitmap = ((BitmapDrawable) r).getBitmap();
try {
FileOutputStream fos = new FileOutputStream(Environment
.getExternalStorageDirectory()
+ "/test_"
+ sdf.format(new Date()) + ".png");
boolean b = bitmap.compress(CompressFormat.PNG, 100, fos);
try {
fos.flush();
} catch (IOException e) {
e.printStackTrace();
}
try {
fos.close();
} catch (IOException e) {
e.printStackTrace();
}
if (b)
Toast.makeText(BasicMapActivity.this, "截屏成功",
Toast.LENGTH_SHORT).show();
} catch (FileNotFoundException e) {
e.printStackTrace();
}
}
});
}
调用amp.getMapPrintScreen()方法来获得截屏,而参数就是AMap.OnMapPrintScreenListener{onMapPrintSceen()},这样就可以处理截屏事件.
截屏之后将会把截屏图保存制定的文件: