什么是百度地图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();
}
完成上述步骤后，运行程序，结果如下：
地图图层概念
地图可以包含一个或多个图层，每个图层在每个级别都是由若干张图块组成的，它们覆盖了地球的整个表面。例如您所看到包括街道、兴趣点、学校、公园等内容的地图展现就是一个图层，另外交通流量的展现也是通过图层来实现的。
底图
基本的地图图层，包括若干个缩放级别，显示基本的地图信息，包括道路、街道、学校、公园等内容。
实时交通信息
在以下11个城市中，支持实时交通信息：北京，上海，广州，深圳，南京，南昌，成都，重庆，武汉，大连，常州。在地图中显示实时交通信息示例如下：
mMapView.setTraffic(true);
运行程序，结果如下：
卫星图
在此版本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());
运行结果如下：
当前位置：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
点击其中一个图标，运行结果如下：
本地搜索覆盖物：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);
}
运行结果如下：
驾车路线搜索及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中这些有的已经过时，但是基本原理还是这些。几天后我开发玩我的项目会来补全这些。
本文链接：https://my.lmcjl.com/post/14944.html
4 评论