什么是百度地图API?
百度地图移动版API(Android)是一套基于Android 1.5及以上设备的应用程序接口,通过该接口,您可以轻松访问百度服务和数据,构建功能丰富、交互性强的地图应用程序。百度地图移动版API不仅包含构建地图的基本接口,还提供了诸如地图定位、本地搜索、路线规划等数据服务,你可以根据自己的需要进行选择。
面向的读者
API是提供给那些具有一定Android编程经验和了解面向对象概念的读者使用。此外,读者还应该对地图产品有一定的了解。
您在使用中遇到任何问题,都可以通过API贴吧或交流群反馈给我们。
获取API Key
用户在使用API之前需要获取百度地图移动版APIKey,该Key与你的百度账户相关联,您必须先有百度帐户,才能获得API KEY。并且,该KEY与您引用API的程序名称有关,具体流程请参照获取密钥。
兼容性
支持Android 1.5及以上系统。
如何把API添加到我的Andoid工程中?
首先将API包括的两个文件baidumapapi.jar和libBMapApiEngine.so拷贝到工程根目录及libs\armeabi目录下,并在工程属性->Java BuildPath->Libraries中选择“Add JARs”,选定baidumapapi.jar,确定后返回,这样您就可以在您的程序中使用API了。
百度地图的“Hello,World”
在Manifest中添加使用权限
<uses-permissionandroid:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
<uses-permissionandroid:name="android.permission.ACCESS_FINE_LOCATION"></uses-permission>
<uses-permissionandroid:name="android.permission.INTERNET"></uses-permission>
<uses-permissionandroid:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>
<uses-permissionandroid:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
<uses-permissionandroid:name="android.permission.CHANGE_WIFI_STATE"></uses-permission>
<uses-permissionandroid:name="android.permission.READ_PHONE_STATE"></uses-permission>
在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;
import com.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;
import com.baidu.mapapi.TransitOverlay;
public classMyMapActivity extends MapActivity {
@Override
public void onCreate(BundlesavedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
}
@Override
protected boolean isRouteDisplayed() {
return false;
}
}
在布局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">
<TextView android: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”:
mBMapMan = newBMapManager(getApplication());
mBMapMan.init("我的Key",null);
super.initMapActivity(mBMapMan);
MapView mMapView =(MapView) findViewById(R.id.bmapsView);
mMapView.setBuiltInZoomControls(true); //设置启用内置的缩放控件
MapControllermMapController = 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:
@Override
protected voidonDestroy() {
if (mBMapMan != null) {
mBMapMan.destroy();
mBMapMan = null;
}
super.onDestroy();
}
@Override
protected voidonPause() {
if (mBMapMan != null) {
mBMapMan.stop();
}
super.onPause();
}
@Override
protected voidonResume() {
if (mBMapMan != null) {
mBMapMan.start();
}
super.onResume();
}
完成上述步骤后,运行程序,结果如下:
![](https://img-my.csdn.net/uploads/201304/20/1366395698_8008.jpg)
地图图层概念
地图可以包含一个或多个图层,每个图层在每个级别都是由若干张图块组成的,它们覆盖了地球的整个表面。例如您所看到包括街道、兴趣点、学校、公园等内容的地图展现就是一个图层,另外交通流量的展现也是通过图层来实现的。
底图
基本的地图图层,包括若干个缩放级别,显示基本的地图信息,包括道路、街道、学校、公园等内容。
实时交通信息
在以下11个城市中,支持实时交通信息:北京,上海,广州,深圳,南京,南昌,成都,重庆,武汉,大连,常州。在地图中显示实时交通信息示例如下:
mMapView.setTraffic(true);
运行程序,结果如下:
![](https://img-my.csdn.net/uploads/201304/20/1366395760_2788.jpg)
卫星图
在此版本API中暂不支持。
mMapView.setSatellite(true);
实景图
在此版本API中暂不支持。
mMapView.setStreetView(true);
地图覆盖物概述
所有叠加或覆盖到地图的内容,我们统称为地图覆盖物。如标注、矢量图形元素(包括:折线和多边形和圆)、定位图标等。覆盖物拥有自己的地理坐标,当您拖动或缩放地图时,它们会相应的移动。
地图API提供了如下几种覆盖物:
Overlay:覆盖物的抽象基类,所有的覆盖物均继承此类的方法,实现用户自定义图层显示。
MyLocationOverlay:一个负责显示用户当前位置的Overlay。
ItemizedOverlay<Itemextends OverlayItem>:Overlay的一个基类,包含了一个OverlayItem列表,相当于一组分条的Overlay,通过继承此类,将一组兴趣点显示在地图上。
PoiOverlay:本地搜索图层,提供某一特定地区的位置搜索服务,比如在北京市搜索“公园”,通过此图层将公园显示在地图上。
RouteOverlay:步行、驾车导航线路图层,将步行、驾车出行方案的路线及关键点显示在地图上。
TransitOverlay:公交换乘线路图层,将某一特定地区的公交出行方案的路线及换乘位置显示在地图上。
覆盖物的抽象基类:Overlay
一般来说,在MapView中添加一个Overlay需要经过以下步骤:
自定义类继承Overlay,并Override其draw()方法,如果需要点击、按键、触摸等交互操作,还需Override onTap()等方法。
public classMyOverlay extends Overlay {
GeoPoint geoPoint = new GeoPoint((int)(39.915 * 1E6), (int) (116.404 * 1E6));
Paint paint = new Paint();
@Override
public void draw(Canvas canvas, MapViewmapView, boolean shadow) {
//在天安门的位置绘制一个String
Point point =mMapView.getProjection().toPixels(geoPoint, null);
canvas.drawText("★这里是天安门", point.x, point.y, paint);
}
}
添加到MapView的覆盖物中:
mMapView.getOverlays().add(newMyOverlay());
运行结果如下:
![](https://img-my.csdn.net/uploads/201304/20/1366395829_4099.jpg)
当前位置:MyLocationOverlay
将MyLocationOverlay添加到覆盖物中,能够实现在地图上显示当前位置的图标以及指南针:
初始化Location模块
// 初始化Location模块
mLocationManager =mBMapMan.getLocationManager();
// 通过enableProvider和disableProvider方法,选择定位的Provider
//mLocationManager.enableProvider(MKLocationManager.MK_NETWORK_PROVIDER);
//mLocationManager.disableProvider(MKLocationManager.MK_GPS_PROVIDER);
// 添加定位图层
MyLocationOverlaymylocTest = new MyLocationOverlay(this, mMapView);
mylocTest.enableMyLocation();// 启用定位
mylocTest.enableCompass(); // 启用指南针
mMapView.getOverlays().add(mylocTest);
运行结果如下:分条目覆盖物:ItemizedOverlay
某个类型的覆盖物,包含多个类型相同、显示方式相同、处理方式相同的项时,使用此类:
自定义类继承ItemizedOverlay<OverlayItem>,并Override其draw()方法,如果需要点击、按键、触摸等交互操作,还需Override onTap()等方法。
class OverItemTextends ItemizedOverlay<OverlayItem> {
private List<OverlayItem> GeoList =new ArrayList<OverlayItem>();
private Context mContext;
private double mLat1 = 39.90923;//39.9022;// point1纬度
private double mLon1 =116.397428;//116.3822; // point1经度
private double mLat2 = 39.9022;
private double mLon2 = 116.3922;
private double mLat3 = 39.917723;
private double mLon3 = 116.3722;
public OverItemT(Drawable marker, Context context) {
super(boundCenterBottom(marker));
this.mContext = context;
// 用给定的经纬度构造GeoPoint,单位是微度 (度 * 1E6)
GeoPoint p1 = new GeoPoint((int) (mLat1* 1E6), (int) (mLon1 * 1E6));
GeoPoint p2 = new GeoPoint((int) (mLat2* 1E6), (int) (mLon2 * 1E6));
GeoPoint p3 = new GeoPoint((int) (mLat3* 1E6), (int) (mLon3 * 1E6));
GeoList.add(new OverlayItem(p1,"P1", "point1"));
GeoList.add(new OverlayItem(p2,"P2", "point2"));
GeoList.add(new OverlayItem(p3,"P3", "point3"));
populate(); //createItem(int)方法构造item。一旦有了数据,在调用其它方法前,首先调用这个方法
}
@Override
protected OverlayItem createItem(int i) {
return GeoList.get(i);
}
@Override
public int size() {
return GeoList.size();
}
@Override
// 处理当点击事件
protected boolean onTap(int i) {
Toast.makeText(this.mContext,GeoList.get(i).getSnippet(),
Toast.LENGTH_SHORT).show();
return true;
}
}
添加到MapView的覆盖物中:
Drawable marker =getResources().getDrawable(R.drawable.iconmark);
//得到需要标在地图上的资源
mMapView.getOverlays().add(newOverItemT(marker, this));
//添加ItemizedOverlay实例到mMapView
点击其中一个图标,运行结果如下:
![](https://img-my.csdn.net/uploads/201304/20/1366395918_9470.jpg)
本地搜索覆盖物:PoiOverlay
详见详见在POI搜索及PoiOverlay。
驾车路线覆盖物:RouteOverlay
详见详见在驾车路线搜索及RouteOverlay和步行路线搜索及RouteOverlay。
换乘路线覆盖物:TransitOverlay
详见详见在公交换乘路线搜索及TransitOverlay。
搜索服务
百度地图移动版API集成搜索服务包括:位置检索、周边检索、范围检索、公交检索、驾乘检索、步行检索,通过初始化MKSearch类,注册搜索结果的监听对象MKSearchListener,实现异步搜索服务。首先自定义MySearchListener实现MKSearchListener接口,通过不同的回调方法,获得搜索结果:
public classMySearchListener implements MKSearchListener {
@Override
public void onGetAddrResult(MKAddrInforesult, int iError) { }
@Override
public voidonGetDrivingRouteResult(MKDrivingRouteResult result, int iError) { }
@Override
public void onGetPoiResult(MKPoiResultresult, int type, int iError) { }
@Override
public voidonGetTransitRouteResult(MKTransitRouteResult result, int iError) { }
@Override
public voidonGetWalkingRouteResult(MKWalkingRouteResult result, int iError) { }
}
然后初始化MKSearch类:
mMKSearch = newMKSearch();
mMKSearch.init(mBMapMan,new MySearchListener());
POI搜索及PoiOverlay
POI搜索有三种方式,根据范围和检索词发起范围检索poiSearchInbounds,城市poi检索poiSearchInCity,周边检索poiSearchNearBy,以下以周边检索为例介绍如何进行检索并显示覆盖物PoiOverlay:
检索天安门周边5000米之内的KFC餐厅:
mMKSearch.poiSearchNearBy("KFC",new GeoPoint((int) (39.915 * 1E6), (int) (116.404 * 1E6)), 5000);
实现MySearchListener的onGetPoiResult,并展示检索结果:
@Override
public voidonGetPoiResult(MKPoiResult result, int type, int iError) {
if (result == null) {
return;
}
PoiOverlay poioverlay = new PoiOverlay(MyMapActivity.this,mMapView);
poioverlay.setData(result.getAllPoi());
mMapView.getOverlays().add(poioverlay);
}
运行结果如下:
![](https://img-my.csdn.net/uploads/201304/20/1366395971_9146.jpg)
驾车路线搜索及RouteOverlay
检索从天安门到百度大厦的驾车路线:
MKPlanNode start =new MKPlanNode();
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,并展示检索结果:
@Override
public voidonGetDrivingRouteResult(MKDrivingRouteResult result, int iError) {
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
检索从天安门到百度大厦的公交换乘路线:
MKPlanNode start =new MKPlanNode();
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),并展示检索结果:
@Override
public voidonGetTransitRouteResult(MKTransitRouteResult result, int iError) {
if (result == null) {
return;
}
TransitOverlay transitOverlay = newTransitOverlay(MyMapActivity.this, mMapView);
// 此处仅展示一个方案作为示例
transitOverlay.setData(result.getPlan(0));
mMapView.getOverlays().add(transitOverlay);
}
地址信息查询
根据地理坐标查询地址信息:
mMKSearch.reverseGeocode(newGeoPoint(40057031, 116307852));
实现MySearchListener的onGetAddrResult,得到查询结果。
事件
定位监听
实现方式与系统的定位监听类似,通过MKLocationManager注册或者移除定位监听器:
mLocationManager =mBMapMan.getLocationManager();
LocationListenerlistener = new LocationListener() {
@Override
public void onLocationChanged(Locationlocation) {
// TODO 在此处处理位置变化
}
};
// 注册监听
mLocationManager.requestLocationUpdates(listener);
// 不需要时移除监听
mLocationManager.removeUpdates(listener);
一般事件监听
在初始化地图Activity时,注册一般事件监听,并实现MKGeneralListener的接口处理相应事件,将mBMapMan.init("我的Key", null)替换为下面的代码:
mBMapMan.init("我的key",new MKGeneralListener() {
@Override
public void onGetPermissionState(intiError) {
// TODO 返回授权验证错误,通过错误代码判断原因,MKEvent中常量值。
}
@Override
public void onGetNetworkState(int iError) {
// TODO 返回网络错误,通过错误代码判断原因,MKEvent中常量值。
}
});
这是我在看了一天百度地图开发以及别人的例子所理解的,都是最基础的。不过我看的例子不是百度发布的最新的api,在新的api中这些有的已经过时,但是基本原理还是这些。几天后我开发玩我的项目会来补全这些。