这个api为我们开发者提供了本地搜索、路线规划、地图定位灯等数据的服务。
要使用百度地图api，首先要申请它的API key，申请这个key是为了相对百度系统唯一标识这个应用的。
申请完key之后，把这个key放到我们的常量接口中去。这些做完之后还要添加地图引擎到工程中，这个引擎包含了百度mapapi的jar包和负责定位的locSDK的jar包。
在工程中添加网络状态的一些权限和获取手机信息的权限。
然后在布局文件中添加MapView控件用于展示地图。这个MapView是百度地图api中继承ViewGroup的一个类，是一个自定义控件。
需要注意的是，在我们加载布局之前，要先到百度地图的服务器端校验我们获取到的key，校验时初始化地图引擎，使用地图引擎的管理类BMapManager进行初始化，初始化时会校验key还有网络状态。key为300时表示授权验证失败，网络状态为2时表示未连接上网络。
做了这几步就可以把地图展示在手机上面。
只做以上几步，我遇到了这样一个问题，当第一次显示地图时能够正常显示，但退出后，再进来就看不到地图的。这时候就得考虑到activity的生命周期问题了，得把activity的onResume、onPause、onDestroy这三个方法都覆写后才能正常显示。
使用这个api有三个核心的类BMapManager、MapView、MapController.
BMapManager类用于地图的管理，比如地图的初始化；MapView类用于地图的展示；MapController类用于对地图的控制，主要用于控制地图的移动、缩放和旋转。对当前正在显示的Map进行控制。
效果一：地图的放大与缩小。 通过MapView设置缩放控件，首先要明确缩放级别。在2.0版本之前支持的缩放级别是3-18，在2.0版本之后所支持的缩放级别变成了3-19，所多的这一个级别是使地图呈现3D效果。
一般会在MapView中添加一个能够让用户控制的能放大和缩小的控件，调用MapView里的setBuiltInZoomControls(true)方法添加控件。
也可以使用zoomIn方法和zoomOut方法，分别放大和缩小一个级别。
效果二：地图的移动百度地图默认的中心点是北京天安门，移动要调用MapController类中的animateTo方法，给这个方法传进一个GeoPoint对象。GeoPoint对象里放的是经纬度信息。
效果三：地图的旋转
地图上的旋转分为水平方向上的旋转和垂直方向上的旋转。
水平方向上的旋转，调用MapController中的setRotation方法，在这个方法里传入旋转角度，逆时针旋转为角度增大方向。
垂直方向上的旋转，调用MapController中的setOverlooking方法，在这个方法里传入旋转角度。这里的角度都为负数，范围在-45-0。
效果三：点击获取兴趣点信息版本2.0之后在MapView添加了一个MKMapViewListener，它是地图显示事件监听器，这个监听器里有四个方法，第一个onClickMapPoi(MapPoi mapPoiInfo) 方法， 点击到地图可以点击的标注时会回调此接口，需要通过MapController.enableClick(true)方法来控制点击的开关，否则点击会没反应。第二个onGetCurrentMap(Bitmap b)方法，截图成功后会回调此接口，动画结束时会回调消息onMapAnimationFinish()，地图移动完成时会回调接口onMapMoveFinish()。我们调用MapView的regMapViewListener注册监听器，并把我之前说的监听器放进去，就可以实现点击地图上的兴趣点获取信息的功能。
知识点四：地图图层我们把地图展现出来以后，要想在地图上覆盖一些东西，就设计到了地图图层的知识。地图可以包含一个或多个图层，每个图层在每个级别都是由若干张图块组成的，它们覆盖了地图的整个表面。例如您所看到包括街道、兴趣点、学校、公园等内容的地图展现就是一个图层，另外交通流量的展现也是通过图层来实现的。
图层分为三类：底图、实时交通信息层和卫星图。
地图是基本的地图图层，包括若干个缩放级别，显示基本的地图信息，包括道路、街道、学校、公园等内容。
实时交通信息层可以调用MapView中的setTraffic(true)方法展示出来。
卫星地图是卫星拍摄的真实的地理面貌，所以卫星地图可用来检测地面的信息，你可以了解到地理位置，地形等，调用MapView中的setSatellite(true)方法实现。
效果五：底图展示底图展示是默认的
效果六：显示实时交通MapView.setTraffic(true)
效果七：卫星图MapView.setSatellite(true)
需要注意的是，展示底图的时候要关闭掉实时交通图和卫星图，显示实时交通图的时候关闭掉卫星图，显示卫星图的时候要关闭掉实时交通图，分别setTraffic(false)和setSatellite(false)。
知识点七：覆盖物有了地图的图层，我们就可以在地图上叠加或覆盖内容，这些内容我们把它称作地图覆盖物。比如说覆盖一些标注，矢量图形元素，定位坐标这些。覆盖物都有自己的地理坐标，当我们拖动或缩放地图时，它们会做相应的处理。
关于覆盖物有一个重要的类Overlay，它表示可以显示在地图上的覆盖物。如果想在图层上画一些东西,就必须继承Overlay,关于Overlay的使用，在MapView上显示Overlay的步骤是固定的。一共三步，
第一步是要获取到MapView中保存Overlay的集合 mapView.getOverlays()。这个集合是一个list.
第二步是在这个集合里添加需要显示的内容。
第三步刷新界面。
我们处理不同的覆盖物所做的不同的地方就是如何给不同的Overlay设置数据。
知识点八：覆盖物的分类通常我们使用百度地图会用到的覆盖物有：
几何图形绘制覆盖物：GraphicsOverlay
文字绘制覆盖物：TextOverlay
分条目覆盖物：ItemizedOverlay
本地搜索覆盖物：PoiOverlay
驾车路线覆盖物：RouteOverlay
换乘路线覆盖物：TransitOverlay
我的位置覆盖物：MyLocationOverlay
效果九：几何图形绘制覆盖物几何图形无非是点、线、面，面里面分为圆、矩形、多边形这几种。
使用绘制覆盖物的通用三步。
在这三步中，我们定义自己的覆盖物GraphicsOverlay，然后设置覆盖物的数据。
比如说画一个圆,这里有一个几何图形类Geometry，使用这个类的setCircle方法可以获取一个圆，我们得指定这个圆的圆心和半径,在这个setCircle方法中传进来圆的圆心还有半径(单位是米)，这样就把这个圆给确定下来了.接下来给这个圆设置样式,比如圆的颜色,圆的线条,是否填充这个圆。
然后把这个覆盖物添加到集合中就可以显示出来了。
效果九：文字绘制覆盖物还有一种是文字图形覆盖物，我们可以在地图的某个点上绘制一段文字信息。这里我们要处理的数据是这个点，要显示的文字的内容，以及文字的样式，比如文字的大小还有颜色。Overlay类中提供了addText方法，绘制文字覆盖物方便多了。
效果十：分条目覆盖物分条目覆盖物所对应的信息就是一个一个的item，比如说我想描述一下我们这个附近有小吃的地儿，我们就可以把搜索到的结果绘制在地图上。这里有个类是ItemizedOverlay，我们在处理某个类型的覆盖物，包含多个类型相同、显示方式相同、处理方式相同的项的时候，使用这个类，比如说我们在附近画一些点，ItemizedOverlay这个类本身包含list，我们分别设置这些点的位置信息，文字片段信息，还有item的标题文本，把这些点一个一个或者批量的添加到list中，这些数据设置好后，再把这个覆盖物添加到Overlay的集合中，就可以显示出来了。
效果十一：点击条目，显示泡泡窗口我们还会做一个效果，当用户点击这个item的时候，能够显示一个泡泡出来，泡泡的布局文件是一个linearlayout，布局文件里有三个控件，两个ImageView中间加一个TextView，两边的图片一个用来显示路线，一个用作搜索，加载这个布局后，设置泡泡的信息然后添加到mapView中。
当条目被点击的时候，我们会覆盖onTap这个方法，在处理onTap时更新Layout，利用LayoutParams传递点位信息，同时可以获取标题信息，设置给TextView 。这时候，我们再点击条目的时候，就能够显示这个泡泡了。
知识点十二：搜索百度地图里也集成了很多搜索服务，比如说位置检索、周边检索、范围检索、公交检索、驾乘检索、步行检索这些。
搜索里有两个核心的类MKSearch和MKSearchListener。要实现搜索功能，首先要初始化MKSearch类，然后通过它的init方法注册搜索结果的监听对象MKSearchListener，来实现异步搜索服务。然后通过自定义MySearchListener实现类，处理不同的回调方法，获得搜索结果。
效果十三：在一个圆形区域内进行兴趣点搜索比如我们搜多本公司周边的饭店，我们要调用MKSearch对象的poiSearchNearBy方法，在这个方法里传入我们要搜索的内容，我们公司的点以及所要搜索的范围。结果的处理要在MKSearchListener的onGetPoiResult方法中，在该方法中可以通过传递的type值来区分是范围搜索还是城市检索。之后的处理是先判断服务器是否返回有效数据，然后创建poi覆盖物，再将服务器返回数据添加到poi覆盖物中，然后添加覆盖物到MapView，最后刷新MapView就实现了搜索的功能，显示我们要搜索的信息。
效果十四：在一个矩形区域内进行兴趣点的搜索为什么要有这样的一个搜索呢？市面上有这样的应用，在地图上画一条线，要求在这条线的附近搜索我们想要找的东西。这时候的处理是将这条曲线的两个端点作为圆形区域搜索，而把线的部分作为矩形区域来搜索。矩形搜索也是会经常用到的。
矩形搜索所用到的api是poiSearchInbounds，和圆形搜索类似，只是在搜索的时候变为矩形，在方法中传入搜索关键词，左下角地理坐标和左上角地理坐标。通过这两个坐标，我们就能得到所需要的矩形。区域设置好后，我们结果的处理依然是在MKSearchListener的onGetPoiResult方法中，处理的方式不变。
效果十五：全城搜索全城搜索使用到的方法是poiSearchInCity，这里我们只需要传进来两个参数，一个是城市的名字，一个是我们搜索的关键词。在这里对返回的结果要做处理，因为对于一个城市，我们所搜索的内容对应的地方可能很多，所以这里要做分页处理。我们在处理分页的时候，关注几点内容，当前页、总页数、总记录数以及每一页所显示的条目。这些数据我们都可以从MKPoiResult这个类中获取到，然后获取当前页的所有兴趣点，就可以实现全城搜索的分页显示了。要注意的是要在显示下一页的时候，将当前页显示的overlay清空。我们还可以在调用这个类中的设置每页容量的方法。
效果十六：关于路线的搜索-驾车路线搜索调用MKSearch里的drivingSearch方法，传进来起点和终点的城市名，搜索的起点位置和终点位置，还可以指定途径点。
这里要注意MKPlanNode内容的设置：可以使用经纬度和地名，需要输入准确的名称，可以通过setDrivingPolicy(int policy) 来设置驾车路线规划策略。
结果的处理在MKSearchListener的onGetDrivingRouteResult方法中。
效果十七：步行路线搜索调用MKSearch里的walkingSearch方法，传进来起点和终点的城市名，搜索的起点位置和终点位置，还可以指定途径点。这里要注意MKPlanNode内容的设置：可以使用经纬度和地名，需要输入准确的名称，可以通过。结果的处理在MKSearchListener的onGetWalkingRouteResult方法中。
十八：公交换乘路线调用MKSearch的transitSearch方法，传入城市名，搜索的起点和终点，通过setTransitPolicy设置路线规划策略
结果处理在MKSearchListener类的onGetTransitRouteResult方法中,MKPlanNode可以使用name进行搜索.
在搜索时还要进行新的地图中心点的设置，使用MapController里的setCenter方法，还要使用MapController里的enableClick方法是我们点击的时候提示我们换乘信息。这样就实现了公交换乘路线的搜索。
效果十九：定位定位到自己的位置，对于这个功能，百度地图的API中有告诉我们怎么去写定位的Demo，里面说的第一步是导入库文件，也就是把sdkjar包拷贝到我们工程的libs里，为了避免各个应用公用一个service出现的权限问题，我们还要在应用的配置文件中配置自己单独拥有的service。添加一些必要的权限。这里需要访问服务器，使用到的类是LocationClient，
有一个负责显示用户当前位置的Overlay，即MyLocationOverlay，MyLocationOverlay只负责显示我的位置，位置数据请使用百度定位SDK获取，将获取的位置数据放在一个LocationData结构中并用该结构设置MyLcationOverlay的数据源，即可创建MyLocationOverlay。
然后就是LocationData数据获取，
先要创建监听器，当获取到位置信息时，将信息添加到LocationData中，监听器需要实现BDLocationListener接口，在这里有两个方法需要实现：
1.接收异步返回的定位结果，参数是BDLocation类型参数。
2.接收异步返回的POI查询结果，参数是BDLocation类型参数。
然后是监听的设置：
先创建LocationClient对象，并注册监听registerLocationListener
设置定位参数（LocationClientOption）：定位模式（单次定位，定时定位），返回坐标类型，是否打开GPS等等。
通过LocationClient的start、stop控制定位信息获取，在做中间可以手动发起定位的请求requestLocation。
（
在百度地图移动版API中，提供一个重要的特色功能：定位，通过这个功能，能获取到用户当前所在位置。
在程序中，如果使用此功能，必须注册GPS和网络的使用权限。
在获取用户位置时，优先使用GPS进行定位；如果GPS定位没有打开或者没有可用位置信息，则会通过判断网络是否连接（即确认手机是否能上网，不论是连接2G/3G或Wi-Fi网络），如果是，则通过请求百度网络定位服务，返回网络定位结果。为了使获得的网络定位结果更加精确，请打开手机的Wi-Fi开关。
目前系统自带的网络定位服务精度低，且服务不稳定、精度低，并且从未来的趋势看，基站定位是不可控的（移动公司随时可能更改基站编号以垄断定位服务），而Wi-Fi定位则不然，它是一种精度更高、不受管制的定位方法。国内其它使用Wi-Fi定位的地图软件，Wi-Fi定位基本不可用，百度的定位服务量化指标优秀，网络接口返回速度快（服务端每次定位响应时间50毫秒以内），平均精度70米，其中Wi-Fi精度40米左右，基站定位精度200米左右，覆盖率98%，在国内处于一枝独秀的地位。
）
火星坐标系统：关于火星坐标系统，我们平时用到的地球坐标系统，叫做WGS84（World Geodetic System 1984）坐标，国家保密插件，也叫做加密插件或者加偏或者SM模组，其实就是对真实坐标系统进行人为的加偏处理，按照几行代码的算法，将真实的坐标加密成虚假的坐标，而这个加偏并不是线性的加偏，所以各地的偏移情况都会有所不同。而加密后的坐标也常被人称为火星坐标系统，这是我们的国家又一个伟大的发明，让国外的政府和企业等，都看不懂我们的坐标系统。
现在，所有的电子地图所有的导航设备，都需要加入国家保密插件。第一步，地图公司测绘地图，测绘完成后，送到国家测绘局，将真实坐标的电子地图，加密成“火星坐标”，这样的地图才是可以出版和发布的，然后才可以让GPS公司处理。第二步，所有的GPS公司，只要需要汽车导航的，需要用到导航电子地图的，统统需要在软件中加入国家保密算法，将COM口读出来的真实的坐标信号，加密转换成国家要求的保密的坐标，这样，GPS导航仪和导航电子地图就可以完全匹配啦，GPS也就可以正常工作啦。
我们需要知道真实经纬度坐标转换的算法：
我用到了两个文件：axisoffset.dat和ModifyOffset.java，第一个表示真实坐标与火星坐标的映射关系，第二个修订偏移的java文件，是把标准坐标转换成火星坐标。
在我们自己的代码中声明ModifyOffset对象，也就是得到位置转化工具类的实例，然后调用这个类中的s2c方法，这个方法是将真实坐标转化成火星坐标，传进真实的经纬度就实现了转换。
