百度地图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

boolean	equals(LocationClientOption opt)
java.lang.String	getAddrType()           获取地址信息设置
java.lang.String	getCoorType()           获得当前设置的坐标类型
LocationClientOption.LocationMode	getLocationMode()           获取当前的定位模式
java.lang.String	getProdName()           获取设置的Prod字段值
int	getScanSpan()           获取 设置的扫描间隔，单位是毫秒
int	getTimeOut()           NA
boolean	isLocationNotify()           NA
boolean	isOpenGps()           是否打开gps进行定位
void	setCoorType(java.lang.String coorType)           设置坐标类型
void	SetIgnoreCacheException(boolean cacheException)           设置是否进行异常捕捉
void	setIgnoreKillProcess(boolean killProcess)           设置是否退出定位进程
void	setIsNeedAddress(boolean isNeed)           设置是否需要地址信息，默认为无地址
void	setLocationMode(LocationClientOption.LocationMode mode)           设置定位模式
void	setLocationNotify(boolean notify)           NA
void	setNeedDeviceDirect(boolean isNeedDeviceDirect)           在网络定位时，是否需要设备方向
void	setOpenGps(boolean openGps)           是否打开gps进行定位
void	setProdName(java.lang.String prodName)           设置Prod字段值
void	setScanSpan(int scanSpan)           设置扫描间隔，单位是毫秒
void	setTimeOut(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 int	MAP_TYPE_NORMAL 普通地图模式常量， setMapType(int)
static int	MAP_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 地图截屏回调接口

方法概要

方法  

限定符和类型	方法和说明
void	addHeatMap(HeatMap heatmap) 添加热力图
Overlay	addOverlay(OverlayOptions options) 向地图添加一个 Overlay
void	animateMapStatus(MapStatusUpdate update) 以动画方式更新地图状态，动画耗时 300 ms
void	animateMapStatus(MapStatusUpdate update, int durationMs) 以动画方式更新地图状态
void	clear() 清空地图所有的 Overlay 覆盖物以及 InfoWindow
MyLocationConfiguration	getLocationConfigeration() 获取定位图层配置信息
MyLocationData	getLocationData() 获取定位数据
MapStatus	getMapStatus() 获取地图的当前状态
int	getMapType() 获取地图当前的模式，普通地图或者卫星图
float	getMaxZoomLevel() 获取地图最大缩放级别
float	getMinZoomLevel() 获取地图最小缩放级别
Projection	getProjection() 获取地图投影坐标转换器, 当地图初始化完成之前返回 null，在 OnMapLoadedCallback.onMapLoaded() 之后才能正常
UiSettings	getUiSettings() 获取地图ui控制器
void	hideInfoWindow() 隐藏当前 InfoWindow
boolean	isBuildingsEnabled() 获取是否允许楼块效果
boolean	isMyLocationEnabled() 获取是否允许定位图层
boolean	isTrafficEnabled() 获取是否打开交通图层
void	setBuildingsEnabled(boolean enabled) 设置是否允许楼块效果
void	setMapStatus(MapStatusUpdate update) 改变地图状态
void	setMapType(int type) 设置地图类型 MAP_TYPE_NORMAL 普通图； MAP_TYPE_SATELLITE 卫星图
void	setMaxAndMinZoomLevel(float max, float min) 设置地图最大以及最小缩放级别，地图支持的最大最小级别分别为[3-19]
void	setMyLocationConfigeration(MyLocationConfiguration configeration) 设置定位图层配置信息，只有先允许定位图层后设置定位图层配置信息才会生效，参见 setMyLocationEnabled(boolean)
void	setMyLocationData(MyLocationData data) 设置定位数据, 只有先允许定位图层后设置数据才会生效，参见 setMyLocationEnabled(boolean)
void	setMyLocationEnabled(boolean enabled) 设置是否允许定位图层
void	setOnMapClickListener(BaiduMap.OnMapClickListener listener) 设置地图单击事件监听者
void	setOnMapDoubleClickListener(BaiduMap.OnMapDoubleClickListener listener) 设置地图双击事件监听者
void	setOnMapLoadedCallback(BaiduMap.OnMapLoadedCallback callback) 设置地图加载完成回调
void	setOnMapLongClickListener(BaiduMap.OnMapLongClickListener listener) 设置地图长按事件监听者
void	setOnMapStatusChangeListener(BaiduMap.OnMapStatusChangeListener listener) 设置地图状态监听者
void	setOnMarkerClickListener(BaiduMap.OnMarkerClickListener listener) 设置地图 Marker 覆盖物点击事件监听者
void	setOnMarkerDragListener(BaiduMap.OnMarkerDragListener listener) 设置 Marker 拖拽事件监听者
void	setOnMyLocationClickListener(BaiduMap.OnMyLocationClickListener listener) 设置定位图标点击事件监听者
void	setTrafficEnabled(boolean enabled) 设置是否打开交通图层
void	showInfoWindow(InfoWindow infoWindow) 显示 InfoWindow
void	snapshot(BaiduMap.SnapshotReadyCallback callback) 发起截图请求

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

方法详细信息

onReceiveLocation

void onReceiveLocation(BDLocation location)

定位请求回调函数

参数：

BDLocaiton：定位结果 -

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

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

限定符和类型	方法和说明
void	recycle() 回收 bitmap 资源，请确保在不再使用该 bitmap descriptor 时再调用该函数。

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

限定符和类型	方法和说明
void	destroy() 释放该地理编码查询对象
boolean	geocode(GeoCodeOption option) 发起地理编码(地址信息->经纬度)请求
static GeoCoder	newInstance() 新建地理编码查询
boolean	reverseGeoCode(ReverseGeoCodeOption option) 发起反地理编码请求(经纬度->地址信息)
void	setOnGetGeoCodeResultListener(OnGetGeoCoderResultListener listener) 设置查询结果监听者

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

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

限定符和类型	字段和说明
java.lang.String	address poi地址信息
java.lang.String	city poi所在城市
boolean	hasCaterDetails poi点是否有美食类详情页面
boolean	isPano poi点附近是否有街景，可使用uid检索全景组件的全景数据
LatLng	location poi坐标, 当ePoiType为2或4时，pt 为空
java.lang.String	name poi名称
java.lang.String	phoneNum poi电话信息
java.lang.String	postCode poi邮编
PoiInfo.POITYPE	type poi类型，0：普通点，1：公交站，2：公交线路，3：地铁站，4：地铁线路,
java.lang.String	uid 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检索接口，但它其实是类而不是接口

限定符和类型	方法和说明
void	destroy() 释放检索对象
static PoiSearch	newInstance() 创建PoiSearch实例
boolean	searchInBound(PoiBoundSearchOption option) 范围内检索
boolean	searchInCity(PoiCitySearchOption option) 城市内检索
boolean	searchNearby(PoiNearbySearchOption option) 周边检索
boolean	searchPoiDetail(PoiDetailSearchOption option) POI 详情检索， 使用详情检索，需在 AndroidManifest.xml 文件中声明 PlaceCaterActivity
void	setOnGetPoiSearchResultListener(OnGetPoiSearchResultListener listener) 设置poi检索监听者

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

限定符和类型	方法和说明
void	destroy() 释放对象资源
static SuggestionSearch	newInstance() 获取建议检索实例
boolean	requestSuggestion(SuggestionSearchOption option) 建议请求入口
void	setOnGetSuggestionResultListener(OnGetSuggestionResultListener listener) 设置建议请求结果监听器

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

字段概要

字段  

限定符和类型	字段和说明
float	accuracy 定位精度
float	direction GPS定位时方向角度
double	latitude 百度纬度坐标
double	longitude 百度经度坐标
int	satellitesNum GPS定位时卫星数目
float	speed GPS定位时速度