在Manifest中添加Android版本支持
- <supports-screensandroid:largeScreens="true"
- android:normalScreens="true"android:smallScreens="true"
- android:resizeable="true"android:anyDensity="true"/>
- <uses-sdkandroid:minSdkVersion="3"></uses-sdk>
让创建的地图Activity继承com.baidu.mapapi.MapActivity, 并import相关类
- importjava.util.ArrayList;
- importjava.util.List;
- importandroid.content.Context;
- importandroid.graphics.Canvas;
- importandroid.graphics.Paint;
- importandroid.graphics.Point;
- importandroid.graphics.drawable.Drawable;
- importandroid.location.Location;
- importandroid.os.Bundle;
- importandroid.util.Log;
- importandroid.view.View;
- importandroid.widget.Toast;
- importcom.baidu.mapapi.BMapManager;
- importcom.baidu.mapapi.GeoPoint;
- importcom.baidu.mapapi.ItemizedOverlay;
- importcom.baidu.mapapi.LocationListener;
- importcom.baidu.mapapi.MKAddrInfo;
- importcom.baidu.mapapi.MKDrivingRouteResult;
- importcom.baidu.mapapi.MKGeneralListener;
- importcom.baidu.mapapi.MKLocationManager;
- importcom.baidu.mapapi.MKPlanNode;
- importcom.baidu.mapapi.MKPoiResult;
- importcom.baidu.mapapi.MKSearch;
- importcom.baidu.mapapi.MKSearchListener;
- importcom.baidu.mapapi.MKTransitRouteResult;
- importcom.baidu.mapapi.MKWalkingRouteResult;
- importcom.baidu.mapapi.MapActivity;
- importcom.baidu.mapapi.MapController;
- importcom.baidu.mapapi.MapView;
- importcom.baidu.mapapi.MyLocationOverlay;
- importcom.baidu.mapapi.Overlay;
- importcom.baidu.mapapi.OverlayItem;
- importcom.baidu.mapapi.PoiOverlay;
- importcom.baidu.mapapi.RouteOverlay;
- importcom.baidu.mapapi.TransitOverlay;
- publicclassMyMapActivityextendsMapActivity{
- @Override
- publicvoidonCreate(Bundle savedInstanceState){
- super.onCreate(savedInstanceState);
- setContentView(R.layout.main);
- }
- @Override
- protectedbooleanisRouteDisplayed(){
- returnfalse;
- }
- }
在布局xml中添加地图控件
- <?xmlversion="1.0"encoding="utf-8"?>
- <LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"
- android:orientation="vertical"android:layout_width="fill_parent"
- android:layout_height="fill_parent">
- <TextViewandroid:layout_width="fill_parent"
- android:layout_height="wrap_content"android:text="@string/hello"/>
- <com.baidu.mapapi.MapViewandroid:id="@+id/bmapsView"
- android:layout_width="fill_parent"android:layout_height="fill_parent"
- android:clickable="true"/>
- </LinearLayout>
初始化地图Activity
在地图Activity中定义变量:BMapManager mBMapMan=null;在onCreate方法中增加以下代码,并将您申请的Key替换“我的Key”: <style> <!-- --> </style>
- mBMapMan=newBMapManager(getApplication());
- mBMapMan.init("我的Key",null);
- super.initMapActivity(mBMapMan);
- MapView mMapView=(MapView)findViewById(R.id.bmapsView);
- mMapView.setBuiltInZoomControls(true);//设置启用内置的缩放控件
- MapController mMapController=mMapView.getController();// 得到mMapView的控制权,可以用它控制和驱动平移和缩放
- GeoPoint point=newGeoPoint((int)(39.915*1E6),
- (int)(116.404*1E6));//用给定的经纬度构造一个GeoPoint,单位是微度 (度 * 1E6)
- mMapController.setCenter(point);//设置地图中心点
- mMapController.setZoom(12);//设置地图zoom级别
Override以下方法,管理API: <style> <!-- --> </style>
- @Override
- protectedvoidonDestroy(){
- if(mBMapMan!=null){
- mBMapMan.destroy();
- mBMapMan=null;
- }
- super.onDestroy();
- }
- @Override
- protectedvoidonPause(){
- if(mBMapMan!=null){
- mBMapMan.stop();
- }
- super.onPause();
- }
- @Override
- protectedvoidonResume(){
- if(mBMapMan!=null){
- mBMapMan.start();
- }
- super.onResume();
- }
完成上述步骤后,运行程序,结果如下:
地图图层
地图图层概念 地图可以包含一个或多个图层,每个图层在每个级别都是由若干张图块组成的,它们覆盖了地球的整个表面。例如您所看到包括街道、兴趣点、学校、公园等内容的地图展现就是一个图层,另外交通流量的展现也是通过图层来实现的。
底图
基本的地图图层,包括若干个缩放级别,显示基本的地图信息,包括道路、街道、学校、公园等内容。
实时交通信息
在以下11个城市中,支持实时交通信息:北京,上海,广州,深圳,南京,南昌,成都,重庆,武汉,大连,常州。在地图中显示实时交通信息示例如下: <style> <!-- --> </style>
- mMapView.setTraffic(true);
运行程序,结果如下:
卫星图
在此版本API中暂不支持。 <style> <!-- --> </style>
- mMapView.setSatellite(true);
实景图
在此版本API中暂不支持。 <style> <!-- --> </style>
- mMapView.setStreetView(true);
覆盖物
地图覆盖物概述 所有叠加或覆盖到地图的内容,我们统称为地图覆盖物。如标注、矢量图形元素(包括:折线和多边形和圆)、定位图标等。覆盖物拥有自己的地理坐标,当您拖动或缩放地图时,它们会相应的移动。地图API提供了如下几种覆盖物:
- Overlay:覆盖物的抽象基类,所有的覆盖物均继承此类的方法,实现用户自定义图层显示。
- MyLocationOverlay:一个负责显示用户当前位置的Overlay。
-
ItemizedOverlay<Item extends OverlayItem>:Overlay的一个基类,包含了一个OverlayItem列表,相当于一组分条的Overlay,通过继承此类,将一组兴趣点显示在地图上。
-
PoiOverlay:本地搜索图层,提供某一特定地区的位置搜索服务,比如在北京市搜索“公园”,通过此图层将公园显示在地图上。
-
RouteOverlay:步行、驾车导航线路图层,将步行、驾车出行方案的路线及关键点显示在地图上。
-
TransitOverlay:公交换乘线路图层,将某一特定地区的公交出行方案的路线及换乘位置显示在地图上。
覆盖物的抽象基类:Overlay
一般来说,在MapView中添加一个Overlay需要经过以下步骤:
- 自定义类继承Overlay,并Override其draw()方法,如果需要点击、按键、触摸等交互操作,还需Override onTap()等方法。 <style> <!-- --> </style>
- publicclassMyOverlayextendsOverlay{
- GeoPoint geoPoint=newGeoPoint((int)(39.915*1E6),(int)(116.404*1E6));
- paint=new();
- @Override
- publicvoiddraw(canvas, MapView mapView,booleanshadow){
- //在的位置绘制一个String
- point=mMapView.getProjection().toPixels(geoPoint,null);
- canvas.drawText("★这里是", point.x, point.y, paint);
- }
- }
添加到MapView的覆盖物中: <style> <!-- --> </style>
- mMapView.getOverlays().add(newMyOverlay());
运行结果如下:
当前位置:MyLocationOverlay
将MyLocationOverlay添加到覆盖物中,能够实现在地图上显示当前位置的图标以及指南针:
- 初始化Location模块 <style> <!-- --> </style>
- // 初始化Location模块
- mLocationManager=mBMapMan.getLocationManager();
- // 通过enableProvider和disableProvider方法,选择定位的Provider
- // mLocationManager.enableProvider(MKLocationManager.MK_NETWORK_PROVIDER);
- // mLocationManager.disableProvider(MKLocationManager.MK_GPS_PROVIDER);
- // 添加定位图层
- MyLocationOverlay mylocTest=newMyLocationOverlay(this, mMapView);
- mylocTest.enableMyLocation();// 启用定位
- mylocTest.enableCompass();// 启用指南针
- mMapView.getOverlays().add(mylocTest);
运行结果如下:
分条目覆盖物:ItemizedOverlay
某个类型的覆盖物,包含多个类型相同、显示方式相同、处理方式相同的项时,使用此类:
- 自定义类继承ItemizedOverlay<OverlayItem>,并Override其draw()方法,如果需要点击、按键、触摸等交互操作,还需Override onTap()等方法。 <style> <!-- --> </style>
- classOverItemTextendsItemizedOverlay<OverlayItem>{
- privateList<OverlayItem>GeoList=newArrayList<OverlayItem>();
- privatemContext;
- privatedoublemLat1=39.90923;//39.9022; // point1纬度
- privatedoublemLon1=116.397428;//116.3822; // point1经度
- privatedoublemLat2=39.9022;
- privatedoublemLon2=116.3922;
- privatedoublemLat3=39.917723;
- privatedoublemLon3=116.3722;
- publicOverItemT(Drawable marker,context){
- super(boundCenterBottom(marker));
- this.mContext=context;
- // 用给定的经纬度构造GeoPoint,单位是微度 (度 * 1E6)
- GeoPoint p1=newGeoPoint((int)(mLat1*1E6),(int)(mLon1*1E6));
- GeoPoint p2=newGeoPoint((int)(mLat2*1E6),(int)(mLon2*1E6));
- GeoPoint p3=newGeoPoint((int)(mLat3*1E6),(int)(mLon3*1E6));
- GeoList.add(newOverlayItem(p1,"P1","point1"));
- GeoList.add(newOverlayItem(p2,"P2","point2"));
- GeoList.add(newOverlayItem(p3,"P3","point3"));
- populate();//createItem(int)方法构造item。一旦有了数据,在调用其它方法前,首先调用这个方法
- }
- @Override
- protectedOverlayItem createItem(inti){
- returnGeoList.get(i);
- }
- @Override
- publicintsize(){
- returnGeoList.size();
- }
- @Override
- // 处理当点击事件
- protectedbooleanonTap(inti){
- Toast.makeText(this.mContext, GeoList.get(i).getSnippet(),
- Toast.LENGTH_SHORT).show();
- returntrue;
- }
- }
添加到MapView的覆盖物中: <style> <!-- --> </style>
- Drawable marker=getResources().getDrawable(R.drawable.iconmark);//得到需要标在地图上的资源
- mMapView.getOverlays().add(newOverItemT(marker,this));//添加ItemizedOverlay实例到mMapView
点击其中一个图标,运行结果如下:
本地搜索覆盖物:PoiOverlay
详见详见在。
驾车路线覆盖物:RouteOverlay
详见详见在和。
换乘路线覆盖物:TransitOverlay
详见详见在。
服务类
搜索服务
百度地图移动版API集成搜索服务包括:位置检索、周边检索、范围检索、公交检索、驾乘检索、步行检索,通过初始化MKSearch类,注册搜索结果的监听对象MKSearchListener,实现异步搜索服务。首先自定义MySearchListener实现MKSearchListener接口,通过不同的回调方法,获得搜索结果: <style> <!-- --> </style>
- publicclassMySearchListenerimplementsMKSearchListener{
- @Override
- publicvoidonGetAddrResult(MKAddrInfo result,intiError){
- }
- @Override
- publicvoidonGetDrivingRouteResult(MKDrivingRouteResult result,intiError){
- }
- @Override
- publicvoidonGetPoiResult(MKPoiResult result,inttype,intiError){
- }
- @Override
- publicvoidonGetTransitRouteResult(MKTransitRouteResult result,intiError){
- }
- @Override
- publicvoidonGetWalkingRouteResult(MKWalkingRouteResult result,intiError){
- }
- }
然后初始化MKSearch类: <style> <!-- --> </style>
- mMKSearch=newMKSearch();
- mMKSearch.init(mBMapMan,newMySearchListener());
POI搜索及PoiOverlay
POI搜索有三种方式,根据范围和检索词发起范围检索poiSearchInbounds,城市poi检索poiSearchInCity,周边检索poiSearchNearBy,以下以周边检索为例介绍如何进行检索并显示覆盖物PoiOverlay:
- 检索周边5000米之内的KFC餐厅: <style> <!-- --> </style>
- mMKSearch.poiSearchNearBy("KFC",newGeoPoint((int)(39.915*1E6),(int)(116.404*1E6)),5000);
- 实现MySearchListener的onGetPoiResult,并展示检索结果: <style> <!-- --> </style>
- @Override
- publicvoidonGetPoiResult(MKPoiResult result,inttype,intiError){
- if(result==null){
- return;
- }
- PoiOverlay poioverlay=newPoiOverlay(MyMapActivity.this, mMapView);
- poioverlay.setData(result.getAllPoi());
- mMapView.getOverlays().add(poioverlay);
- }
运行结果如下:
驾车路线搜索及RouteOverlay
- 检索从到百度大厦的驾车路线: <style> <!-- --> </style>
- MKPlanNode start=newMKPlanNode();
- start.pt=newGeoPoint((int)(39.915*1E6),(int)(116.404*1E6));
- MKPlanNode end=newMKPlanNode();
- end.pt=newGeoPoint(40057031,116307852);
- // 设置驾车路线搜索策略,时间优先、费用最少或距离最短
- mMKSearch.setDrivingPolicy(MKSearch.ECAR_TIME_FIRST);
- mMKSearch.drivingSearch(null, start,null, end);
- 实现MySearchListener的onGetDrivingRouteResult,并展示检索结果: <style> <!-- --> </style>
- @Override
- publicvoidonGetDrivingRouteResult(MKDrivingRouteResult result,intiError){
- if(result==null){
- return;
- }
- RouteOverlay routeOverlay=newRouteOverlay(MyMapActivity.this, mMapView);
- // 此处仅展示一个方案作为示例
- routeOverlay.setData(result.getPlan(0).getRoute(0));
- mMapView.getOverlays().add(routeOverlay);
- }
运行结果如下:
步行路线搜索及RouteOverlay
方式与驾车路线搜索类似,只需将mMKSearch.drivingSearch(null, start, null, end)修改为mMKSearch.walkingSearch(null, start, null, end),实现的方法改为onGetWalkingRouteResult即可,不再赘述。
公交换乘路线搜索及TransitOverlay
- 检索从到百度大厦的公交换乘路线: <style> <!-- --> </style>
- MKPlanNode start=newMKPlanNode();
- start.pt=newGeoPoint((int)(39.915*1E6),(int)(116.404*1E6));
- MKPlanNode end=newMKPlanNode();
- end.pt=newGeoPoint(40057031,116307852);
- // 设置乘车路线搜索策略,时间优先、最少换乘、最少步行距离或不含地铁
- mMKSearch.setTransitPolicy(MKSearch.EBUS_TRANSFER_FIRST);
- mMKSearch.transitSearch("北京", start, end);// 必须设置城市名
- 实现MySearchListener的onGetTransitRouteResult(MKTransitRouteResult, int),并展示检索结果: <style> <!-- --> </style>
- @Override
- publicvoidonGetTransitRouteResult(MKTransitRouteResult result,intiError){
- if(result==null){
- return;
- }
- TransitOverlay transitOverlay=newTransitOverlay(MyMapActivity.this, mMapView);
- // 此处仅展示一个方案作为示例
- transitOverlay.setData(result.getPlan(0));
- mMapView.getOverlays().add(transitOverlay);
- }
地址信息查询
根据地理坐标查询地址信息: <style> <!-- --> </style>
- mMKSearch.reverseGeocode(newGeoPoint(40057031,116307852));
实现MySearchListener的onGetAddrResult,得到查询结果。
事件
定位监听
实现方式与系统的定位监听类似,通过MKLocationManager注册或者移除定位监听器: <style> <!-- --> </style>
- mLocationManager=mBMapMan.getLocationManager();
- LocationListener listener=newLocationListener(){
- @Override
- publicvoidonLocationChanged(Location location){
- // TODO 在此处处理位置变化
- }
- };
- // 注册监听
- mLocationManager.requestLocationUpdates(listener);
- // 不需要时移除监听
- mLocationManager.removeUpdates(listener);
一般事件监听
在初始化地图Activity时,注册一般事件监听,并实现MKGeneralListener的接口处理相应事件,将mBMapMan.init("我的Key", null)替换为下面的代码: <style> <!-- --> </style>
- mBMapMan.init("我的key",newMKGeneralListener(){
- @Override
- publicvoidonGetPermissionState(intiError){
- // TODO 返回授权验证错误,通过错误代码判断原因,MKEvent中常量值。
- }
- @Override
- publicvoidonGetNetworkState(intiError){
- // TODO 返回网络错误,通过错误代码判断原因,MKEvent中常量值。
- }
- });