com.baidu.mapapi.map

Class BaiduMap

java.lang.Object

com.baidu.mapapi.map.BaiduMap

public class BaiduMap
extends java.lang.Object

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

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	BaiduMap.OnBaseIndoorMapListener 地图进入室内图模式回调函数
static interface	BaiduMap.OnMapClickListener 地图单击事件监听接口
static interface	BaiduMap.OnMapDoubleClickListener 地图双击事件监听接口
static interface	BaiduMap.OnMapDrawFrameCallback 地图绘制回调接口
static interface	BaiduMap.OnMapLoadedCallback 地图加载完成回调接口
static interface	BaiduMap.OnMapLongClickListener 地图长按事件监听接口
static interface	BaiduMap.OnMapStatusChangeListener 地图状态改变相关接口
static interface	BaiduMap.OnMapTouchListener 用户触摸地图时回调接口
static interface	BaiduMap.OnMarkerClickListener 地图 Marker 覆盖物点击事件监听接口
static interface	BaiduMap.OnMarkerDragListener 地图 Marker 覆盖物拖拽事件监听接口
static interface	BaiduMap.OnMyLocationClickListener 地图定位图标点击事件监听接口
static interface	BaiduMap.OnPolylineClickListener 地图polyline覆盖物点击事件监听接口
static interface	BaiduMap.SnapshotReadyCallback 地图截屏回调接口

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAP_TYPE_NONE 空白背景模式常量，setMapType(int)
static int	MAP_TYPE_NORMAL 普通地图模式常量， setMapType(int)
static int	MAP_TYPE_SATELLITE 卫星图模式常量，setMapType(int)

Method Summary

Methods

Modifier and Type	Method and Description
void	addHeatMap(HeatMap heatmap) 添加热力图
Overlay	addOverlay(OverlayOptions options) 向地图添加一个 Overlay
java.util.List<Overlay>	addOverlays(java.util.List<OverlayOptions> options) 向地图添加多个 Overlay
TileOverlay	addTileLayer(TileOverlayOptions overlayOptions) 向地图添加一个TileOverlay覆盖物
void	animateMapStatus(MapStatusUpdate update) 以动画方式更新地图状态，动画耗时 300 ms
void	animateMapStatus(MapStatusUpdate update, int durationMs) 以动画方式更新地图状态
void	clear() 清空地图所有的 Overlay 覆盖物以及 InfoWindow
Point	getCompassPosition() 获取屏幕坐标系下指南针位置
MapBaseIndoorMapInfo	getFocusedBaseIndoorMapInfo() 获取当前聚焦的室内图信息
MyLocationConfiguration	getLocationConfigeration() 获取定位图层配置信息
MyLocationData	getLocationData() 获取定位数据
MapStatus	getMapStatus() 获取地图的当前状态
LatLngBounds	getMapStatusLimit() 获取地图可移动区域
int	getMapType() 获取地图当前的模式，空白地图、普通地图或者卫星图
java.util.List<Marker>	getMarkersInBounds(LatLngBounds bounds) 获取指定区域内所有的Marker点
float	getMaxZoomLevel() 获取地图最大缩放级别
float	getMinZoomLevel() 获取地图最小缩放级别
Projection	getProjection() 获取地图投影坐标转换器, 当地图初始化完成之前返回 null，在 OnMapLoadedCallback.onMapLoaded() 之后才能正常
UiSettings	getUiSettings() 获取地图ui控制器
void	hideInfoWindow() 隐藏当前 InfoWindow
boolean	isBaiduHeatMapEnabled() 获取是否打开百度热力图层(百度自有数据图层)
boolean	isBaseIndoorMapMode() 是否进入室内图
boolean	isBuildingsEnabled() 获取是否允许楼块效果
boolean	isMyLocationEnabled() 获取是否允许定位图层
boolean	isSupportBaiduHeatMap() 查询当前图区是否支持百度热力图
boolean	isTrafficEnabled() 获取是否打开交通图层
void	removeMarkerClickListener(BaiduMap.OnMarkerClickListener listener) 移除一个地图 Marker 覆盖物点击事件监听者
void	setBaiduHeatMapEnabled(boolean enabled) 设置是否打开百度热力图图层(百度自有数据图层) 注：地图层级大于11时，可显示热力图
void	setBuildingsEnabled(boolean enabled) 设置是否允许楼块效果
void	setCompassIcon(Bitmap icon) 设置指南针自定义图标
void	setCompassPosition(Point p) 设置指南针的位置
void	setIndoorEnable(boolean enabled) 设置是否显示室内图, 默认室内图不显示
void	setMapStatus(MapStatusUpdate update) 改变地图状态
void	setMapStatusLimits(LatLngBounds bounds) 设置地图的可移动区域，只有在 OnMapLoadedCallback.onMapLoaded() 之后设置才生效
void	setMapType(int type) 设置地图类型 MAP_TYPE_NORMAL 普通图； MAP_TYPE_SATELLITE 卫星图；MAP_TYPE_NONE 卫星图
void	setMaxAndMinZoomLevel(float max, float min) 设置地图最大以及最小缩放级别，地图支持的最大最小级别分别为[3-21]
void	setMyLocationConfigeration(MyLocationConfiguration configeration) 设置定位图层配置信息，只有先允许定位图层后设置定位图层配置信息才会生效，参见 setMyLocationEnabled(boolean)
void	setMyLocationData(MyLocationData data) 设置定位数据, 只有先允许定位图层后设置数据才会生效，参见 setMyLocationEnabled(boolean)
void	setMyLocationEnabled(boolean enabled) 设置是否允许定位图层
void	setOnBaseIndoorMapListener(BaiduMap.OnBaseIndoorMapListener listener) 设置室内图模式监听者
void	setOnMapClickListener(BaiduMap.OnMapClickListener listener) 设置地图单击事件监听者
void	setOnMapDoubleClickListener(BaiduMap.OnMapDoubleClickListener listener) 设置地图双击事件监听者
void	setOnMapDrawFrameCallback(BaiduMap.OnMapDrawFrameCallback callback) 设置百度地图在每一帧绘制时的回调接口，该接口在绘制线程中调用
void	setOnMapLoadedCallback(BaiduMap.OnMapLoadedCallback callback) 设置地图加载完成回调
void	setOnMapLongClickListener(BaiduMap.OnMapLongClickListener listener) 设置地图长按事件监听者
void	setOnMapStatusChangeListener(BaiduMap.OnMapStatusChangeListener listener) 设置地图状态监听者
void	setOnMapTouchListener(BaiduMap.OnMapTouchListener listener) 设置触摸地图事件监听者
void	setOnMarkerClickListener(BaiduMap.OnMarkerClickListener listener) 设置地图 Marker 覆盖物点击事件监听者,自3.4.0版本起可设置多个监听对象，停止监听时调用removeMarkerClickListener移除监听对象
void	setOnMarkerDragListener(BaiduMap.OnMarkerDragListener listener) 设置 Marker 拖拽事件监听者
void	setOnMyLocationClickListener(BaiduMap.OnMyLocationClickListener listener) 设置定位图标点击事件监听者
void	setOnPolylineClickListener(BaiduMap.OnPolylineClickListener listener) 设置地图 Polyline 覆盖物点击事件监听者
void	setPadding(int left, int top, int right, int bottom) Deprecated. use setViewPadding(int left, int top, int right, int bottom) instead
void	setTrafficEnabled(boolean enabled) 设置是否打开交通图层
void	setViewPadding(int left, int top, int right, int bottom) 设置地图边界，只有在 OnMapLoadedCallback.onMapLoaded() 之后设置才生效
void	showInfoWindow(InfoWindow infoWindow) 显示 InfoWindow
void	showMapIndoorPoi(boolean isShow) 设置是否显示室内图标注, 默认显示
void	showMapPoi(boolean isShow) 控制是否显示底图默认标注, 默认显示
void	snapshot(BaiduMap.SnapshotReadyCallback callback) 发起截图请求
void	snapshotScope(Rect rect, BaiduMap.SnapshotReadyCallback callback) 发起区域截图请求 注： Rect为null，截全屏
MapBaseIndoorMapInfo.SwitchFloorError	switchBaseIndoorMapFloor(java.lang.String strFloor, java.lang.String strID) 切换室内图楼层set

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MAP_TYPE_NORMAL

public static final int MAP_TYPE_NORMAL

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

MAP_TYPE_SATELLITE

public static final int MAP_TYPE_SATELLITE

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

MAP_TYPE_NONE

public static final int MAP_TYPE_NONE

空白背景模式常量，setMapType(int)

Method Detail

addOverlay

public final Overlay addOverlay(OverlayOptions options)

向地图添加一个 Overlay

Parameters:

options - 将要添加的 overlay 选项

Returns:

被添加的 overlay 对象

addOverlays

public final java.util.List<Overlay> addOverlays(java.util.List<OverlayOptions> options)

向地图添加多个 Overlay

Parameters:

options - 将要添加的 overlay 选项

Returns:

被添加的 overlay 对象

getMarkersInBounds

public java.util.List<Marker> getMarkersInBounds(LatLngBounds bounds)

获取指定区域内所有的Marker点

Returns:

指定区域内所有的marker的list

clear

public final void clear()

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

setMapStatus

public final void setMapStatus(MapStatusUpdate update)

改变地图状态

Parameters:

update - 地图状态将要发生的变化

getMapStatus

public final MapStatus getMapStatus()

获取地图的当前状态

Returns:

地图的当前状态

getMapStatusLimit

public final LatLngBounds getMapStatusLimit()

获取地图可移动区域

Returns:

地图的可移动区域

setMapStatusLimits

public final void setMapStatusLimits(LatLngBounds bounds)

设置地图的可移动区域，只有在 OnMapLoadedCallback.onMapLoaded() 之后设置才生效

Parameters:

bounds -

animateMapStatus

public final void animateMapStatus(MapStatusUpdate update,
                    int durationMs)

以动画方式更新地图状态

Parameters:

update - 地图状态将要发生的变化

durationMs - 动画时间

animateMapStatus

public final void animateMapStatus(MapStatusUpdate update)

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

Parameters:

update - 地图状态将要发生的变化

setMapType

public final void setMapType(int type)

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

Parameters:

type - 地图类型

getMapType

public final int getMapType()

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

Returns:

地图当前的模式

getMaxZoomLevel

public final float getMaxZoomLevel()

获取地图最大缩放级别

Returns:

地图最大缩放级别

setMaxAndMinZoomLevel

public final void setMaxAndMinZoomLevel(float max,
                         float min)

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

Parameters:

max - [3-21] 且 max > min, 否则无效

min - [3-21] 且 max > min, 否则无效

getMinZoomLevel

public final float getMinZoomLevel()

获取地图最小缩放级别

Returns:

地图最小缩放级别

getProjection

public final Projection getProjection()

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

Returns:

地图投影坐标转换器

getUiSettings

public final UiSettings getUiSettings()

获取地图ui控制器

Returns:

地图ui控制器

setBuildingsEnabled

public final void setBuildingsEnabled(boolean enabled)

设置是否允许楼块效果

Parameters:

enabled - 是否允许楼块效果

isBuildingsEnabled

public final boolean isBuildingsEnabled()

获取是否允许楼块效果

Returns:

是否允许楼块效果

setMyLocationEnabled

public final void setMyLocationEnabled(boolean enabled)

设置是否允许定位图层

Parameters:

enabled - 是否允许定位图层

isMyLocationEnabled

public final boolean isMyLocationEnabled()

获取是否允许定位图层

Returns:

是否允许定位图层

setMyLocationData

public final void setMyLocationData(MyLocationData data)

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

Parameters:

data - 定位数据

getLocationData

public final MyLocationData getLocationData()

获取定位数据

Returns:

定位数据

setMyLocationConfigeration

public final void setMyLocationConfigeration(MyLocationConfiguration configeration)

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

Parameters:

configeration - 定位图层配置信息

getLocationConfigeration

public final MyLocationConfiguration getLocationConfigeration()

获取定位图层配置信息

Returns:

定位图层配置信息

addHeatMap

public void addHeatMap(HeatMap heatmap)

添加热力图

Parameters:

heatmap - 热力图

setBaiduHeatMapEnabled

public final void setBaiduHeatMapEnabled(boolean enabled)

设置是否打开百度热力图图层(百度自有数据图层) 注：地图层级大于11时，可显示热力图

Parameters:

enabled - 是否打开百度热力图图层(百度自有数据图层)

setIndoorEnable

public final void setIndoorEnable(boolean enabled)

设置是否显示室内图, 默认室内图不显示

Parameters:

enabled - 室内图开关

setCompassPosition

public void setCompassPosition(Point p)

设置指南针的位置

Parameters:

p - 指南针的位置

setCompassIcon

public void setCompassIcon(Bitmap icon)

设置指南针自定义图标

Parameters:

icon - 自定义的指南针图标

getCompassPosition

public final Point getCompassPosition()

获取屏幕坐标系下指南针位置

Returns:

指南针位置，屏幕坐标

isBaiduHeatMapEnabled

public final boolean isBaiduHeatMapEnabled()

获取是否打开百度热力图层(百度自有数据图层)

Returns:

是否打开百度热力图层(百度自有数据图层)

isSupportBaiduHeatMap

public final boolean isSupportBaiduHeatMap()

查询当前图区是否支持百度热力图

Returns:

是否支持百度热力图

setTrafficEnabled

public final void setTrafficEnabled(boolean enabled)

设置是否打开交通图层

Parameters:

enabled - 是否打开交通图层

isTrafficEnabled

public final boolean isTrafficEnabled()

获取是否打开交通图层

Returns:

是否打开交通图层

showMapPoi

public final void showMapPoi(boolean isShow)

控制是否显示底图默认标注, 默认显示

Parameters:

isShow - true为显示，false为关闭

showMapIndoorPoi

public final void showMapIndoorPoi(boolean isShow)

设置是否显示室内图标注, 默认显示

Parameters:

isShow - true为显示，false为关闭

setPadding

@Deprecated
public final void setPadding(int left,
                         int top,
                         int right,
                         int bottom)

Deprecated. use setViewPadding(int left, int top, int right, int bottom) instead

设置地图上控件与地图边界的距离, 包含比例尺、缩放控件、logo、指南针的位置

setViewPadding

public final void setViewPadding(int left,
                  int top,
                  int right,
                  int bottom)

设置地图边界，只有在 OnMapLoadedCallback.onMapLoaded() 之后设置才生效

Parameters:

left - 左边距, 单位为pixel

top - 上边距, 单位为pixel

right - 右边距, 单位为pixel

bottom - 下边距, 单位为pixel

snapshot

public final void snapshot(BaiduMap.SnapshotReadyCallback callback)

发起截图请求

Parameters:

callback - 截图完成后的回调

snapshotScope

public final void snapshotScope(Rect rect,
                 BaiduMap.SnapshotReadyCallback callback)

发起区域截图请求 注： Rect为null，截全屏

Parameters:

Rect - 截图的矩形范围

callback - 截图完成后的回调

showInfoWindow

public void showInfoWindow(InfoWindow infoWindow)

显示 InfoWindow

Parameters:

infoWindow - 要显示的 InfoWindow 对象

hideInfoWindow

public void hideInfoWindow()

隐藏当前 InfoWindow

setOnMapStatusChangeListener

public final void setOnMapStatusChangeListener(BaiduMap.OnMapStatusChangeListener listener)

设置地图状态监听者

Parameters:

listener - 地图状态监听者

setOnMapTouchListener

public final void setOnMapTouchListener(BaiduMap.OnMapTouchListener listener)

设置触摸地图事件监听者

Parameters:

listener - 地图触摸事件监听者

setOnMapClickListener

public final void setOnMapClickListener(BaiduMap.OnMapClickListener listener)

设置地图单击事件监听者

Parameters:

listener - 地图单击事件监听者

setOnMapLoadedCallback

public void setOnMapLoadedCallback(BaiduMap.OnMapLoadedCallback callback)

设置地图加载完成回调

Parameters:

callback - 地图加载完成回调

setOnMapDoubleClickListener

public final void setOnMapDoubleClickListener(BaiduMap.OnMapDoubleClickListener listener)

设置地图双击事件监听者

Parameters:

listener - 地图双击事件监听者

setOnMapLongClickListener

public final void setOnMapLongClickListener(BaiduMap.OnMapLongClickListener listener)

设置地图长按事件监听者

Parameters:

listener - 地图长按事件监听者

setOnPolylineClickListener

public final void setOnPolylineClickListener(BaiduMap.OnPolylineClickListener listener)

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

Parameters:

listener - Polyline 覆盖物点击事件监听者

setOnMarkerClickListener

public final void setOnMarkerClickListener(BaiduMap.OnMarkerClickListener listener)

设置地图 Marker 覆盖物点击事件监听者,自3.4.0版本起可设置多个监听对象，停止监听时调用removeMarkerClickListener移除监听对象

Parameters:

listener - Marker 覆盖物点击事件监听者

setOnMarkerDragListener

public final void setOnMarkerDragListener(BaiduMap.OnMarkerDragListener listener)

设置 Marker 拖拽事件监听者

Parameters:

listener - Marker 拖拽事件监听者

setOnMyLocationClickListener

public final void setOnMyLocationClickListener(BaiduMap.OnMyLocationClickListener listener)

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

Parameters:

listener - 定位图标点击事件监听者

setOnMapDrawFrameCallback

public final void setOnMapDrawFrameCallback(BaiduMap.OnMapDrawFrameCallback callback)

设置百度地图在每一帧绘制时的回调接口，该接口在绘制线程中调用

Parameters:

callback - 百度地图在每一帧绘制时的回调接口

setOnBaseIndoorMapListener

public final void setOnBaseIndoorMapListener(BaiduMap.OnBaseIndoorMapListener listener)

设置室内图模式监听者

Parameters:

listener - 室内图模式监听者

getFocusedBaseIndoorMapInfo

public MapBaseIndoorMapInfo getFocusedBaseIndoorMapInfo()

获取当前聚焦的室内图信息

Returns:

返回室内图描述信息类

switchBaseIndoorMapFloor

public MapBaseIndoorMapInfo.SwitchFloorError switchBaseIndoorMapFloor(java.lang.String strFloor,
                                                             java.lang.String strID)

切换室内图楼层set

Parameters:

strFloor - [in] 室内图楼层,格式为F1,B1… strID [in] 室内图ID

Returns:

标识切换楼层错误信息, see #(SwitchFloorError)

isBaseIndoorMapMode

public boolean isBaseIndoorMapMode()

是否进入室内图

Returns:

进入室内图返回true，否则返回false

removeMarkerClickListener

public final void removeMarkerClickListener(BaiduMap.OnMarkerClickListener listener)

移除一个地图 Marker 覆盖物点击事件监听者

Parameters:

listener -

addTileLayer

public TileOverlay addTileLayer(TileOverlayOptions overlayOptions)

向地图添加一个TileOverlay覆盖物

Parameters:

overlayOptions - 将要被添加的TileOverlay属性，它定义了要添加TileOverlay的属性

Returns:

被添加的TileOverlay对象