百度地图API学习笔记

http://developer.baidu.com/map/android_refer/overview-tree.html

百度地图类分层结构

http://developer.baidu.com/map/android_refer/overview-tree.html

百度地图类分层结构

http://developer.baidu.com/map/android_refer/overview-tree.html

com.baidu.mapapi.map.MyLocationConfiguration.LocationMode是个枚举类，它有3种状态：

COMPASS

罗盘态，显示定位方向圈，保持定位图标在地图中心

FOLLOWING

跟随态，保持定位图标在地图中心

NORMAL

普通态： 更新定位数据时不对地图做任何操作

com.baidu.location.LocationClient，定位服务的客户端

它的start()方法启动定位sdk，它的stop()方法停止定位sdk。

com.baidu.location.LocationClientOption

booleanequals(LocationClientOption opt)
            java.lang.StringgetAddrType()
          获取地址信息设置 java.lang.StringgetCoorType()
          获得当前设置的坐标类型 LocationClientOption.LocationModegetLocationMode()
          获取当前的定位模式 java.lang.StringgetProdName()
          获取设置的Prod字段值 intgetScanSpan()
          获取 设置的扫描间隔，单位是毫秒 intgetTimeOut()
          NA booleanisLocationNotify()
          NA booleanisOpenGps()
          是否打开gps进行定位 voidsetCoorType(java.lang.String coorType)
          设置坐标类型 voidSetIgnoreCacheException(boolean cacheException)
          设置是否进行异常捕捉 voidsetIgnoreKillProcess(boolean killProcess)
          设置是否退出定位进程 voidsetIsNeedAddress(boolean isNeed)
          设置是否需要地址信息，默认为无地址 voidsetLocationMode(LocationClientOption.LocationMode mode)
          设置定位模式 voidsetLocationNotify(boolean notify)
          NA voidsetNeedDeviceDirect(boolean isNeedDeviceDirect)
          在网络定位时，是否需要设备方向 voidsetOpenGps(boolean openGps)
          是否打开gps进行定位 voidsetProdName(java.lang.String prodName)
          设置Prod字段值 voidsetScanSpan(int scanSpan)
          设置扫描间隔，单位是毫秒 voidsetTimeOut(int timeOut)
          NA

com.baidu.location.LocationClientOption.LocationMode

是一个枚举类

定位模式 分为高精度定位模式 低功耗定位模式 仅设备定位模式 高精度定位模式：这种定位模式下，会同时使用网络定位和GPS定位，优先返回最高精度的定位结果； 低功耗定位模式：这种定位模式下，不会使用GPS，只会使用网络定位（Wi-Fi和基站定位） 仅用设备定位模式：这种定位模式下，不需要连接网络，只使用GPS进行定位，这种模式下不支持室内环境的定位

枚举常量摘要Battery_Saving
          低功耗模式Device_Sensors
          仅设备(Gps)模式Hight_Accuracy
          高精度模式

com.baidu.mapapi.map.MapView继承自ViewGroup

一个显示地图的视图（View）。它负责从服务端获取地图数据。它将会捕捉屏幕触控手势事件。 使用这个类必须按照它的生命周期进行操控，你必须参照以下方法onCreate(Bundle)、 onResume()、onPause()、onDestroy()。等生命周期函数。在使用地图组件之前请确保已经调用了SDKInitializer.initialize(Context)函数以提供全局 Context 信息。使用它的getMap()方法可以获取地图控制器BaiduMap。

com.baidu.mapapi.map.BaiduMap

定义 BaiduMap 地图对象的操作方法与接口

限定符和类型字段和说明static intMAP_TYPE_NORMAL

普通地图模式常量， setMapType(int)

static intMAP_TYPE_SATELLITE

卫星图模式常量，setMapType(int)

嵌套类概要

嵌套类 限定符和类型类和说明static interface BaiduMap.OnMapClickListener

地图单击事件监听接口

static interface BaiduMap.OnMapDoubleClickListener

地图双击事件监听接口

static interface BaiduMap.OnMapLoadedCallback

地图加载完成回调接口

static interface BaiduMap.OnMapLongClickListener

地图长按事件监听接口

static interface BaiduMap.OnMapStatusChangeListener

地图状态改变相关接口

static interface BaiduMap.OnMarkerClickListener

地图 Marker 覆盖物点击事件监听接口

static interface BaiduMap.OnMarkerDragListener

地图 Marker 覆盖物拖拽事件监听接口

static interface BaiduMap.OnMyLocationClickListener

地图定位图标点击事件监听接口

static interface BaiduMap.SnapshotReadyCallback

地图截屏回调接口

方法概要

方法 限定符和类型方法和说明voidaddHeatMap(HeatMap heatmap)

添加热力图

OverlayaddOverlay(OverlayOptions options)

向地图添加一个 Overlay

voidanimateMapStatus(MapStatusUpdate update)

以动画方式更新地图状态，动画耗时 300 ms

voidanimateMapStatus(MapStatusUpdate update, int durationMs)

以动画方式更新地图状态

voidclear()

清空地图所有的 Overlay 覆盖物以及 InfoWindow

MyLocationConfigurationgetLocationConfigeration()

获取定位图层配置信息

MyLocationDatagetLocationData()

获取定位数据

MapStatusgetMapStatus()

获取地图的当前状态

intgetMapType()

获取地图当前的模式，普通地图或者卫星图

floatgetMaxZoomLevel()

获取地图最大缩放级别

floatgetMinZoomLevel()

获取地图最小缩放级别

ProjectiongetProjection()

获取地图投影坐标转换器, 当地图初始化完成之前返回 null，在 OnMapLoadedCallback.onMapLoaded() 之后才能正常

UiSettingsgetUiSettings()

获取地图ui控制器

voidhideInfoWindow()

隐藏当前 InfoWindow

booleanisBuildingsEnabled()

获取是否允许楼块效果

booleanisMyLocationEnabled()

获取是否允许定位图层

booleanisTrafficEnabled()

获取是否打开交通图层

voidsetBuildingsEnabled(boolean enabled)

设置是否允许楼块效果

voidsetMapStatus(MapStatusUpdate update)

改变地图状态

voidsetMapType(int type)

设置地图类型 MAP_TYPE_NORMAL 普通图； MAP_TYPE_SATELLITE 卫星图

voidsetMaxAndMinZoomLevel(float max, float min)

设置地图最大以及最小缩放级别，地图支持的最大最小级别分别为[3-19]

voidsetMyLocationConfigeration(MyLocationConfiguration configeration)

设置定位图层配置信息，只有先允许定位图层后设置定位图层配置信息才会生效，参见 setMyLocationEnabled(boolean)

voidsetMyLocationData(MyLocationData data)

设置定位数据, 只有先允许定位图层后设置数据才会生效，参见 setMyLocationEnabled(boolean)

voidsetMyLocationEnabled(boolean enabled)

设置是否允许定位图层

voidsetOnMapClickListener(BaiduMap.OnMapClickListener listener)

设置地图单击事件监听者

voidsetOnMapDoubleClickListener(BaiduMap.OnMapDoubleClickListener listener)

设置地图双击事件监听者

voidsetOnMapLoadedCallback(BaiduMap.OnMapLoadedCallback callback)

设置地图加载完成回调

voidsetOnMapLongClickListener(BaiduMap.OnMapLongClickListener listener)

设置地图长按事件监听者

voidsetOnMapStatusChangeListener(BaiduMap.OnMapStatusChangeListener listener)

设置地图状态监听者

voidsetOnMarkerClickListener(BaiduMap.OnMarkerClickListener listener)

设置地图 Marker 覆盖物点击事件监听者

voidsetOnMarkerDragListener(BaiduMap.OnMarkerDragListener listener)

设置 Marker 拖拽事件监听者

voidsetOnMyLocationClickListener(BaiduMap.OnMyLocationClickListener listener)

设置定位图标点击事件监听者

voidsetTrafficEnabled(boolean enabled)

设置是否打开交通图层

voidshowInfoWindow(InfoWindow infoWindow)

显示 InfoWindow

voidsnapshot(BaiduMap.SnapshotReadyCallback callback)

发起截图请求

com.baidu.location.BDLocationListener是一个接口

方法详细信息

onReceiveLocation

void onReceiveLocation(BDLocation location)

定位请求回调函数

参数：

BDLocaiton：定位结果 -

com.baidu.location.BDLocation，定位结果

com.baidu.mapapi.map.BitmapDescriptor，bitmap 描述信息

限定符和类型方法和说明voidrecycle()

回收 bitmap 资源，请确保在不再使用该 bitmap descriptor 时再调用该函数。

com.baidu.mapapi.search.geocode.GeoCoder，地理编码查询接口，但是它是类而不是接口

限定符和类型方法和说明voiddestroy()

释放该地理编码查询对象

booleangeocode(GeoCodeOption option)

发起地理编码(地址信息->经纬度)请求

static GeoCodernewInstance()

新建地理编码查询

booleanreverseGeoCode(ReverseGeoCodeOption option)

发起反地理编码请求(经纬度->地址信息)

voidsetOnGetGeoCodeResultListener(OnGetGeoCoderResultListener listener)

设置查询结果监听者

com.baidu.mapapi.model.LatLng，地理坐标基本数据结构，封装了纬度（latitude）和经度（longitude）

com.baidu.mapapi.search.core.PoiInfo，地图注点（Point of Interest）信息类

限定符和类型字段和说明java.lang.Stringaddress

poi地址信息

java.lang.Stringcity

poi所在城市

booleanhasCaterDetails

poi点是否有美食类详情页面

booleanisPano

poi点附近是否有街景，可使用uid检索全景组件的全景数据

LatLnglocation

poi坐标, 当ePoiType为2或4时，pt 为空

java.lang.Stringname

poi名称

java.lang.StringphoneNum

poi电话信息

java.lang.StringpostCode

poi邮编

PoiInfo.POITYPEtype

poi类型，0：普通点，1：公交站，2：公交线路，3：地铁站，4：地铁线路,

java.lang.Stringuid

poi id 如果为isPano为true，可用此参数 调用街景组件PanoramaService类的requestPanoramaWithPoiUId方法检索街景数据

com.baidu.mapapi.search.core.PoiInfo.POITYPE，是一个枚举类，Poi 类型枚举

枚举常量和说明BUS_LINE BUS_STATION POINT SUBWAY_LINE SUBWAY_STATION 

com.baidu.mapapi.search.poi.PoiSearch，POI检索接口，但它其实是类而不是接口
限定符和类型方法和说明voiddestroy()

释放检索对象

static PoiSearchnewInstance()

创建PoiSearch实例

booleansearchInBound(PoiBoundSearchOption option)

范围内检索

booleansearchInCity(PoiCitySearchOption option)

城市内检索

booleansearchNearby(PoiNearbySearchOption option)

周边检索

booleansearchPoiDetail(PoiDetailSearchOption option)

POI 详情检索， 使用详情检索，需在 AndroidManifest.xml 文件中声明 PlaceCaterActivity

voidsetOnGetPoiSearchResultListener(OnGetPoiSearchResultListener listener)

设置poi检索监听者

com.baidu.mapapi.search.sug.SuggestionSearch，建议查询接口，但它其实是类而不是接口

限定符和类型方法和说明voiddestroy()

释放对象资源

static SuggestionSearchnewInstance()

获取建议检索实例

booleanrequestSuggestion(SuggestionSearchOption option)

建议请求入口

voidsetOnGetSuggestionResultListener(OnGetSuggestionResultListener listener)

设置建议请求结果监听器

com.baidu.mapapi.map.MyLocationData，定位数据

字段概要

字段 限定符和类型字段和说明floataccuracy

定位精度

floatdirection

GPS定位时方向角度

doublelatitude

百度纬度坐标

doublelongitude

百度经度坐标

intsatellitesNum

GPS定位时卫星数目

floatspeed

GPS定位时速度