TencentMap (shell-vector-api API)

All Known Subinterfaces:

TencentMapNavi
```
public interface TencentMap
```

Nested Class Summary

Nested Classes
Modifier and Type	Interface and Description
`static interface`	`TencentMap.AsyncOperateCallback<T>` 异步操作回调
`static interface`	`TencentMap.CancelableCallback` 地图变换相关操作的状态回调接口
`static interface`	`TencentMap.InfoWindowAdapter` 自定义 `Marker`气泡样式接口
`static interface`	`TencentMap.OnCameraChangeListener` 当地图发生变化时的调用接口
`static interface`	`TencentMap.OnCompassClickedListener` 当地图的罗盘被点击时的回调接口
`static interface`	`TencentMap.OnDismissCallback`
`static interface`	`TencentMap.OnIndoorStateChangeListener` 室内图回调
`static interface`	`TencentMap.OnInfoWindowClickListener` 当 `Marker` 气泡窗口被点击时的回调
`static interface`	`TencentMap.OnMapClickListener` 当地图被点击时回调接口
`static interface`	`TencentMap.OnMapLoadedCallback` 地图加载完成的回调接口,设置之后只回调一次，如果需要再获取，则需要重新设置回调
`static interface`	`TencentMap.OnMapLongClickListener` 当地图被长按时回调接口
`static interface`	`TencentMap.OnMapPoiClickListener` poi点击listener
`static interface`	`TencentMap.OnMarkerClickListener` 当 `Marker` 被点击时回调接口
`static interface`	`TencentMap.OnMarkerDragListener` 当 `Marker` 被拖动时回调接口
`static interface`	`TencentMap.OnMyLocationChangeListener` 地图接收到我的位置发生变化时，回调接口
`static interface`	`TencentMap.OnPolylineClickListener` 当一条折线被点击时的回调。
`static interface`	`TencentMap.OnTrafficEventClickListener` 事件点击回调监听
`static interface`	`TencentMap.SnapshotReadyCallback` 地图截图的回调接口,回调是在主线程中运行的。

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`MAP_MODE_NAV` Deprecated. 从4.1.2弃用，请使用 `MAP_TYPE_NAVI`
`static int`	`MAP_MODE_NAV_NIGHT` Deprecated. 从4.1.2弃用，请使用 `MAP_TYPE_NIGHT`
`static int`	`MAP_MODE_NAV_TRAFFIC` Deprecated. 从4.1.2弃用，请使用 `MAP_TYPE_TRAFFIC_NAVI`
`static int`	`MAP_MODE_NORMAL` Deprecated. 从4.1.2弃用，请使用 `MAP_TYPE_NORMAL`
`static int`	`MAP_MODE_NORMAL_TRAFFIC` Deprecated. 从4.1.2弃用，请使用 `setTrafficEnabled(boolean)`
`static int`	`MAP_TYPE_DARK` 暗色模式
`static int`	`MAP_TYPE_NAVI` 导航模式
`static int`	`MAP_TYPE_NIGHT` 夜间模式
`static int`	`MAP_TYPE_NONE` 默认的地图类型
`static int`	`MAP_TYPE_NORMAL` 普通地图
`static int`	`MAP_TYPE_SATELLITE` 卫星图
`static int`	`MAP_TYPE_TRAFFIC_NAVI` 导航白天 + 路况样式用于腾讯导航 sdk
`static int`	`MAP_TYPE_TRAFFIC_NIGHT` 导航夜间 + 路况样式用于腾讯导航 sdk

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method and Description
`Circle`	`addCircle(CircleOptions options)` 添加圆
`CustomLayer`	`addCustomLayer(CustomLayerOptions options)` 添加个性化图层
`Marker`	`addMarker(MarkerOptions options)` 添加标注(Marker)
`void`	`addOnMapLoadedCallback(TencentMap.OnMapLoadedCallback onMapLoadedCallback)` 设置地图加载完成回调接口
`Polygon`	`addPolygon(PolygonOptions options)` 添加多边形
`Polyline`	`addPolyline(PolylineOptions options)` 添加线
`void`	`addTencentMapGestureListener(TencentMapGestureListener listener)` 添加一个腾讯地图手势监听接口
`TileOverlay`	`addTileOverlay(TileOverlayOptions options)` 添加瓦片图层
`void`	`animateCamera(CameraUpdate cameraUpdate)` 把地图变换到指定的状态,带动画
`void`	`animateCamera(CameraUpdate cameraUpdate, long duration, TencentMap.CancelableCallback cancelableCallback)` 以动画的方式把地图变换到指定的状态
`void`	`animateCamera(CameraUpdate cameraUpdate, TencentMap.CancelableCallback cancelableCallback)` 以动画的方式把地图变换到指定的状态
`CameraPosition`	`calculateZoomToSpanLevel(java.util.List<IOverlay> elements, java.util.List<LatLng> points, int leftPadding, int rightPadding, int topPadding, int bottomPadding)` 计算出要在当前底图可视区域内显示一组元素及一组点的比例尺和中心点（有填边）目前只有在 `CameraPosition.bearing` == 0 且 `CameraPosition.tilt` == 0 时才能获取到正确的值
`void`	`clear()` Deprecated. 从4.3.0弃用，建议使用 {`clearAllOverlays()`}
`void`	`clearAllOverlays()` 清除地图上所有的标注类（Marker、Polyline、Polygon，TileOverlay除外）
`void`	`clearCache()` 清理缓存将自定义瓦片、卫星图、底图等缓存数据进行清理
`void`	`enableMultipleInfowindow(boolean enable)` 设置地图是否允许多InfoWindow模式，默认是false(只允许显示一个InfoWindow) 注意：此方法需要在addMarker之前调用。
`java.lang.String`	`getActivedIndoorBuilding(LatLng outPosition)` Deprecated. 从4.2.4弃用，室内图信息的获取应从回调中监听
`java.lang.String[]`	`getActivedIndoorFloorNames()` 获取当前激活状态室内图的楼层名称列表
`java.util.List<LatLng>`	`getBounderPoints(Marker marker)` 获取marker外包点集
`CameraPosition`	`getCameraPosition()` 获取当前地图的状态（包括中心点、比例尺、旋转角、倾斜角）
`java.lang.String`	`getCityName(LatLng latLng)` 获得当前经纬度所在的城市名称
`java.lang.String`	`getDebugError()` 获取地图引擎的Debug日志，在出现问题时用于日志分析
`int`	`getIndoorFloorId()` 获取当前激活状态室内图Building的选中楼层ID
`MapLanguage`	`getLanguage()` Deprecated. 从4.1.1.1弃用，目前地图暂不支持多语言
`TencentMapContext`	`getMapContext()`
`int`	`getMapHeight()` 获取 mapview 高度
`Rect`	`getMapPadding()` 获取底图相对上、下、左、右的边距
`int`	`getMapStyle()` 获取当前地图的样式
`int`	`getMapType()` 获取地图类型
`int`	`getMapWidth()` 获取 mapview 宽度
`float`	`getMaxZoomLevel()` 获取地图最大的支持的缩放级别
`float`	`getMinZoomLevel()` 获取地图最小的支持的缩放级别
`Location`	`getMyLocation()` 获取我的位置
`Projection`	`getProjection()` 获取坐标转换操作对象
`UiSettings`	`getUiSettings()` 获取地图界面操作对象
`java.lang.String`	`getVersion()` 获取当前地图SDK的版本号
`float`	`getZoomToSpanLevel(LatLng leftUpper, LatLng rightDown)` 根据两个经纬度指定一个范围，计算出当前屏幕如果要显示这个指定范围所要的缩放级别（需要等地图加载完成再调用）
`boolean`	`isBlockRouteEnabled()` Deprecated.
`boolean`	`isDestroyed()` 判断当前这个地图是不是已经被销毁了
`boolean`	`isHandDrawMapEnable()` 当前手绘图是否处于开启状态
`boolean`	`isMyLocationEnabled()` 获取是否显示我的位置
`boolean`	`isSateLiteEnable()` Deprecated. @since 4.3.0 使用 `getMapType()` `MAP_TYPE_SATELLITE` 替代
`boolean`	`isTrafficEnabled()` 获取地图当前是否开启实时交通路况
`void`	`loadKMLFile(java.lang.String filePath)` 加载 KML 文件
`void`	`moveCamera(CameraUpdate cameraUpdate)` 把地图变换到指定的状态
`void`	`removeOnMapLoadedCallback(TencentMap.OnMapLoadedCallback onMapLoadedCallback)` 设置地图加载完成回调接口
`void`	`removeTencentMapGestureListener(TencentMapGestureListener listener)` 移除一个腾讯地图手势监听接口
`void`	`setBlockRouteEnabled(boolean enable)` Deprecated.
`void`	`setBuildingEnable(boolean use3DStyle)` 设置是否显示3D建筑
`void`	`setCameraCenterProportion(float x, float y)` 设置camera变换的中心点并将变换中心点设置为地图当前的中心点
`void`	`setCameraCenterProportion(float x, float y, boolean moveMap)` 设置camera变换的中心点
`void`	`setCustomRender(CustomRender render)` 设置基于gles2.0的渲染器该方法可以在地图上添加自定义的3D模型
`void`	`setDrawPillarWith2DStyle(boolean use2DStyle)` Deprecated. 从4.2.4弃用，建议使用 `setBuildingEnable(boolean)` 替代
`void`	`setForeignLanguage(Language foreignLanguage)` 设置海外图优先显示的语言，默认优先显示中文（在创建地图时设置，不支持动态切换）
`void`	`setHandDrawMapEnable(boolean enable)` 设置是否开启手绘图
`void`	`setIndoorEnabled(boolean enable)` 设置是否显示室内图
`void`	`setIndoorFloor(int floorId)` 设置当前激活状态室内图Building的选中的楼层
`void`	`setIndoorFloor(java.lang.String buildingId, java.lang.String floorName)` 将buildingId对应的室内图建筑物设置到指定楼层展示。
`void`	`setInfoWindowAdapter(TencentMap.InfoWindowAdapter infoWindowAdapter)` 设置气泡样式接口
`void`	`setLocationSource(LocationSource locationSource)` 设置我的位置信息来源，
`void`	`setMapCenterAndScale(float centerX, float centerY, float targetScale)` 设置底图中心点及scale，屏幕左上角为 (0.0f, 0.0f), 右下角（1.0f, 1.0f)
`void`	`setMapStyle(int styleType)` 设置当前地图的样式根据自己在腾讯地图样式配置平台配置的样式对应的样式序号, 目前开放给用户自定义样式的值为 1 ~ 3 之间的整数只有在 `MAP_TYPE_NORMAL` 时，才修改地图样式
`void`	`setMapType(int mapType)` 设置地图类型
`void`	`setMaxZoomLevel(int zoomLevel)` 设置地图的最大缩放级别
`void`	`setMinZoomLevel(int zoomLevel)` 设置地图的最小缩放级别
`void`	`setMyLocationEnabled(boolean enable)` 设置是否显示我的位置
`void`	`setMyLocationStyle(MyLocationStyle myLocationStyle)` 设置定位的样式
`void`	`setOnCameraChangeListener(TencentMap.OnCameraChangeListener onCameraChangeListener)` 设置地图变换的监听接口
`void`	`setOnCompassClickedListener(TencentMap.OnCompassClickedListener onCompassClickedListener)` 设置罗盘位按钮监听接口
`void`	`setOnIndoorStateChangeListener(TencentMap.OnIndoorStateChangeListener listener)` 设置室内图状态变化回调
`void`	`setOnInfoWindowClickListener(TencentMap.OnInfoWindowClickListener listener)` 设置Marker气泡点击事件监听接口
`void`	`setOnMapClickListener(TencentMap.OnMapClickListener onMapClickListener)` 设置地图点击事件的监听接口
`void`	`setOnMapLoadedCallback(TencentMap.OnMapLoadedCallback onMapLoadedCallback)` Deprecated. 添加监听建议使用 `addOnMapLoadedCallback(OnMapLoadedCallback)` 移除监听建议使用 `removeOnMapLoadedCallback(OnMapLoadedCallback)`
`void`	`setOnMapLongClickListener(TencentMap.OnMapLongClickListener onMapLongClickListener)` 设置地图长按事件的监听接口
`void`	`setOnMapPoiClickListener(TencentMap.OnMapPoiClickListener listener)` 设置地图标注点点击回调
`void`	`setOnMarkerClickListener(TencentMap.OnMarkerClickListener listener)` 设置Marker点击事件的监听接口
`void`	`setOnMarkerDragListener(TencentMap.OnMarkerDragListener listener)` 设置Marker拖动事件的监听接口
`void`	`setOnMyLocationChangeListener(TencentMap.OnMyLocationChangeListener onMyLocationChangeListener)` 设置我的位置变化监听接口
`void`	`setOnPolylineClickListener(TencentMap.OnPolylineClickListener onPolylineClickListener)` 设置线被点击时的回调接口
`void`	`setOnTapMapViewInfoWindowHidden(boolean enable)` 点击地图其他区域时，InfoWindow是否需要隐藏
`void`	`setOnTrafficEventClickListener(TencentMap.OnTrafficEventClickListener listener)` 事件点击回调
`void`	`setPadding(int left, int top, int right, int bottom)` 设置底图相对上、下、左、右的边距
`void`	`setPadding(int left, int top, int right, int bottom, boolean moveCenter)` 设置底图相对上、下、左、右的边距，并移动地图中心点
`void`	`setPointToCenter(int x, int y)` 设置屏幕上的某个像素点为中心
`void`	`setPoisEnabled(boolean enabled)` 底图 poi 开关
`void`	`setRestrictBounds(LatLngBounds restrictBounds, RestrictBoundsFitMode fitMode)` 限制地图的显示范围。此接口同时会限制地图的最小缩放级别，用户还可以通过 `setMinZoomLevel(int)` 修改自己需要的最小缩放级别获取需要的展示效果
`void`	`setSatelliteEnabled(boolean enable)` Deprecated. @since 4.3.0 使用 `setMapType(int)` `MAP_TYPE_SATELLITE` 替代
`void`	`setTencentMapGestureListener(TencentMapGestureListener listener)` Deprecated. 弃用，建议使用{`addTencentMapGestureListener(TencentMapGestureListener)`}
`void`	`setTrafficEnabled(boolean enable)` 开启或关闭实时交通路况的功能
`void`	`snapshot(TencentMap.SnapshotReadyCallback callback)` 获取地图当前截图如果调用了 animateCamera 接口，请在 CameraChangeFinished 回调后再进行截图
`void`	`snapshot(TencentMap.SnapshotReadyCallback callback, Bitmap.Config config)` 获取地图当前截图如果调用了 animateCamera 接口，请在 CameraChangeFinished 回调后再进行截图
`void`	`stopAnimation()` 停止地图所有正在进行的动画

- Field Detail
  - MAP_TYPE_NONE
```
static final int MAP_TYPE_NONE
```
    默认的地图类型
    
    See Also:
    
    Constant Field Values
  - MAP_TYPE_NORMAL
```
static final int MAP_TYPE_NORMAL
```
    普通地图
    
    Since:
    
    4.3.0 只能通过 setMapType(int) 设置
    
    See Also:
    
    Constant Field Values
  - MAP_TYPE_DARK
```
static final int MAP_TYPE_DARK
```
    暗色模式
    
    Since:
    
    4.3.0 新增
    
    See Also:
    
    Constant Field Values
  - MAP_TYPE_SATELLITE
```
static final int MAP_TYPE_SATELLITE
```
    卫星图
    
    Since:
    
    4.3.0 新增
    
    See Also:
    
    Constant Field Values
  - MAP_TYPE_TRAFFIC_NAVI
```
static final int MAP_TYPE_TRAFFIC_NAVI
```
    导航白天 + 路况样式
    用于腾讯导航 sdk
    
    See Also:
    
    Constant Field Values
  - MAP_TYPE_TRAFFIC_NIGHT
```
static final int MAP_TYPE_TRAFFIC_NIGHT
```
    导航夜间 + 路况样式
    用于腾讯导航 sdk
    
    See Also:
    
    Constant Field Values
  - MAP_TYPE_NIGHT
```
static final int MAP_TYPE_NIGHT
```
    夜间模式
    
    See Also:
    
    Constant Field Values
  - MAP_TYPE_NAVI
```
static final int MAP_TYPE_NAVI
```
    导航模式
    
    See Also:
    
    Constant Field Values
  - MAP_MODE_NORMAL
```
static final int MAP_MODE_NORMAL
```
    Deprecated. 从4.1.2弃用，请使用 MAP_TYPE_NORMAL
    
    See Also:
    
    Constant Field Values
  - MAP_MODE_NORMAL_TRAFFIC
```
static final int MAP_MODE_NORMAL_TRAFFIC
```
    Deprecated. 从4.1.2弃用，请使用 setTrafficEnabled(boolean)
    
    See Also:
    
    Constant Field Values
  - MAP_MODE_NAV
```
static final int MAP_MODE_NAV
```
    Deprecated. 从4.1.2弃用，请使用 MAP_TYPE_NAVI
    
    See Also:
    
    Constant Field Values
  - MAP_MODE_NAV_TRAFFIC
```
static final int MAP_MODE_NAV_TRAFFIC
```
    Deprecated. 从4.1.2弃用，请使用 MAP_TYPE_TRAFFIC_NAVI
    
    See Also:
    
    Constant Field Values
  - MAP_MODE_NAV_NIGHT
```
static final int MAP_MODE_NAV_NIGHT
```
    Deprecated. 从4.1.2弃用，请使用 MAP_TYPE_NIGHT
    
    See Also:
    
    Constant Field Values
- Method Detail
  - getMapContext
```
TencentMapContext getMapContext()
```
  - getCameraPosition
```
CameraPosition getCameraPosition()
```
    获取当前地图的状态（包括中心点、比例尺、旋转角、倾斜角）
    
    Returns:
    
    当前地图的状态CameraPosition
  - getZoomToSpanLevel
```
float getZoomToSpanLevel(LatLng leftUpper,
                         LatLng rightDown)
```
    根据两个经纬度指定一个范围，计算出当前屏幕如果要显示这个指定范围所要的缩放级别（需要等地图加载完成再调用）
    
    Parameters:
    
    leftUpper - 左上角要显示的经纬度
    
    rightDown - 右下角要显示的经纬度
    
    Returns:
    
    缩放级别
  - getMaxZoomLevel
```
float getMaxZoomLevel()
```
    获取地图最大的支持的缩放级别
    
    Returns:
    
    最大的缩放级别，默认是 20.0
  - getMinZoomLevel
```
float getMinZoomLevel()
```
    获取地图最小的支持的缩放级别
    
    Returns:
    
    最上的缩放级别，默认是 3.0
  - setOnTapMapViewInfoWindowHidden
```
void setOnTapMapViewInfoWindowHidden(boolean enable)
```
    点击地图其他区域时，InfoWindow是否需要隐藏
    
    Parameters:
    
    enable - 隐藏开关
    true：点击地图其他区域，隐藏InfoWindow
    
    false：点击地图其他区域，不隐藏InfoWindow
  - moveCamera
```
void moveCamera(CameraUpdate cameraUpdate)
```
    把地图变换到指定的状态
    
    Parameters:
    
    cameraUpdate - 状态对象参见CameraUpdate
  - animateCamera
```
void animateCamera(CameraUpdate cameraUpdate)
```
    把地图变换到指定的状态,带动画
    
    Parameters:
    
    cameraUpdate - 状态对象参见CameraUpdate
  - animateCamera
```
void animateCamera(CameraUpdate cameraUpdate,
                   TencentMap.CancelableCallback cancelableCallback)
```
    以动画的方式把地图变换到指定的状态
    
    Parameters:
    
    cameraUpdate - 状态对象参见CameraUpdate
    
    cancelableCallback - 动画状态监听器TencentMap.CancelableCallback
  - animateCamera
```
void animateCamera(CameraUpdate cameraUpdate,
                   long duration,
                   TencentMap.CancelableCallback cancelableCallback)
```
    以动画的方式把地图变换到指定的状态
    
    Parameters:
    
    cameraUpdate - 状态对象参见CameraUpdate
    
    duration - 动画执行时间（单位：ms）
    
    cancelableCallback - 动画状态监听器TencentMap.CancelableCallback
  - stopAnimation
```
void stopAnimation()
```
    停止地图所有正在进行的动画
  - addTileOverlay
```
TileOverlay addTileOverlay(TileOverlayOptions options)
```
    添加瓦片图层
    
    Parameters:
    
    options - 瓦片选项
    
    Returns:
    
    新创建的瓦片图层
    
    Since:
    
    4.2.5
  - addCustomLayer
```
CustomLayer addCustomLayer(CustomLayerOptions options)
```
    添加个性化图层
    
    Parameters:
    
    options - 图层选项
    
    Returns:
    
    新创建的图层
    
    Since:
    
    4.2.9
  - addPolyline
```
Polyline addPolyline(PolylineOptions options)
```
    添加线
    
    Parameters:
    
    options - 线属性,参见PolylineOptions
    
    Returns:
    
    新创建的线
  - addPolygon
```
Polygon addPolygon(PolygonOptions options)
```
    添加多边形
    
    Parameters:
    
    options - 多边形属性,参见PolygonOptions
    
    Returns:
    
    新创建的多边形
  - addCircle
```
Circle addCircle(CircleOptions options)
```
    添加圆
    
    Parameters:
    
    options - 折线的参数,参见CircleOptions
    
    Returns:
    
    新创建的圆
  - addMarker
```
Marker addMarker(MarkerOptions options)
```
    添加标注(Marker)
    
    Parameters:
    
    options - marker 属性,参见MarkerOptions
    
    Returns:
    
    新创建的标注
  - clearAllOverlays
```
void clearAllOverlays()
```
    清除地图上所有的标注类（Marker、Polyline、Polygon，TileOverlay除外）
    
    Since:
    
    4.3.0
  - clear
```
void clear()
```
    Deprecated. 从4.3.0弃用，建议使用 {clearAllOverlays()}
  - clearCache
```
void clearCache()
```
    清理缓存将自定义瓦片、卫星图、底图等缓存数据进行清理
    建议在线程中执行
    
    Since:
    
    4.3.0
  - setMapType
```
void setMapType(int mapType)
```
    设置地图类型
    
    Parameters:
    
    mapType - 仅限设置为：MAP_TYPE_NORMAL、 MAP_TYPE_DARK、 MAP_TYPE_SATELLITE
    
    Since:
    
    4.3.0
  - getMapType
```
int getMapType()
```
    获取地图类型
    
    Since:
    
    4.3.0
  - setMapStyle
```
void setMapStyle(int styleType)
```
    设置当前地图的样式
    根据自己在腾讯地图样式配置平台配置的样式对应的样式序号, 目前开放给用户自定义样式的值为 1 ~ 3 之间的整数
    只有在 MAP_TYPE_NORMAL 时，才修改地图样式
    
    Parameters:
    
    styleType - 地图样式
  - getMapStyle
```
int getMapStyle()
```
    获取当前地图的样式
    
    Returns:
    
    当前地图样式
  - isTrafficEnabled
```
boolean isTrafficEnabled()
```
    获取地图当前是否开启实时交通路况
    
    Returns:
    
    是否开启：true 开启 false 关闭
  - setTrafficEnabled
```
void setTrafficEnabled(boolean enable)
```
    开启或关闭实时交通路况的功能
    
    Parameters:
    
    enable - 是否开启：true 开启 false 关闭
  - setSatelliteEnabled
```
void setSatelliteEnabled(boolean enable)
```
    Deprecated. @since 4.3.0 使用 setMapType(int) MAP_TYPE_SATELLITE 替代
    
    开启或关闭实时卫星视图的功能注： 1、开启卫星图状态下,用户调用setMapStyle(int) / setMapType(int)切换样式将不生效 2、关闭卫星图，则恢复到开启卫星图之前设置的样式
    
    Parameters:
    
    enable - 是否开启：true 开启 false 关闭
  - isSateLiteEnable
```
boolean isSateLiteEnable()
```
    Deprecated. @since 4.3.0 使用 getMapType() MAP_TYPE_SATELLITE 替代
    
    返回卫星图状态
    
    Returns:
    
    是否开启卫星图
  - isMyLocationEnabled
```
boolean isMyLocationEnabled()
```
    获取是否显示我的位置
    
    Returns:
    
    是否显示：true 显示 false 隐藏
  - setMyLocationEnabled
```
void setMyLocationEnabled(boolean enable)
```
    设置是否显示我的位置
    注：地图SDK不负责获取位置，由外界提供，开启地图定位功能建议使用腾讯Android定位SDK
    设置定位，请参考LocationSource
    
    Parameters:
    
    enable - 是否显示：true 显示 false 隐藏
  - getMyLocation
```
Location getMyLocation()
```
    获取我的位置
    
    Returns:
    
    我的位置信息, 具体参见 Android Location
  - setLocationSource
```
void setLocationSource(LocationSource locationSource)
```
    设置我的位置信息来源，
    
    Parameters:
    
    locationSource - 参见LocationSource
  - getUiSettings
```
UiSettings getUiSettings()
```
    获取地图界面操作对象
    
    Returns:
    
    当前地图操作对象参见 UiSettings
  - getProjection
```
Projection getProjection()
```
    获取坐标转换操作对象
    
    Returns:
    
    当前地图的坐标转换对象参见Projection
  - setOnCameraChangeListener
```
void setOnCameraChangeListener(TencentMap.OnCameraChangeListener onCameraChangeListener)
```
    设置地图变换的监听接口
    
    Parameters:
    
    onCameraChangeListener - 参见TencentMap.OnCameraChangeListener
  - setOnMapClickListener
```
void setOnMapClickListener(TencentMap.OnMapClickListener onMapClickListener)
```
    设置地图点击事件的监听接口
    
    Parameters:
    
    onMapClickListener - 参见TencentMap.OnMapClickListener
  - setOnMapLongClickListener
```
void setOnMapLongClickListener(TencentMap.OnMapLongClickListener onMapLongClickListener)
```
    设置地图长按事件的监听接口
    
    Parameters:
    
    onMapLongClickListener - 参见TencentMap.OnMapLongClickListener
  - setOnPolylineClickListener
```
void setOnPolylineClickListener(TencentMap.OnPolylineClickListener onPolylineClickListener)
```
    设置线被点击时的回调接口
    
    Parameters:
    
    onPolylineClickListener - 参见TencentMap.OnPolylineClickListener
  - setOnMyLocationChangeListener
```
void setOnMyLocationChangeListener(TencentMap.OnMyLocationChangeListener onMyLocationChangeListener)
```
    设置我的位置变化监听接口
    
    Parameters:
    
    onMyLocationChangeListener - 参见TencentMap.OnMyLocationChangeListener
  - setOnCompassClickedListener
```
void setOnCompassClickedListener(TencentMap.OnCompassClickedListener onCompassClickedListener)
```
    设置罗盘位按钮监听接口
    
    Parameters:
    
    onCompassClickedListener - 参见TencentMap.OnCompassClickedListener
  - setOnMapLoadedCallback
```
void setOnMapLoadedCallback(TencentMap.OnMapLoadedCallback onMapLoadedCallback)
```
    Deprecated. 添加监听建议使用 addOnMapLoadedCallback(OnMapLoadedCallback)
    移除监听建议使用 removeOnMapLoadedCallback(OnMapLoadedCallback)
    
    设置地图加载完成回调接口
    
    Parameters:
    
    onMapLoadedCallback - 参见TencentMap.OnMapLoadedCallback
  - addOnMapLoadedCallback
```
void addOnMapLoadedCallback(TencentMap.OnMapLoadedCallback onMapLoadedCallback)
```
    设置地图加载完成回调接口
    
    Parameters:
    
    onMapLoadedCallback - 参见TencentMap.OnMapLoadedCallback
  - removeOnMapLoadedCallback
```
void removeOnMapLoadedCallback(TencentMap.OnMapLoadedCallback onMapLoadedCallback)
```
    设置地图加载完成回调接口
    
    Parameters:
    
    onMapLoadedCallback - 参见TencentMap.OnMapLoadedCallback
  - snapshot
```
void snapshot(TencentMap.SnapshotReadyCallback callback,
              Bitmap.Config config)
```
    获取地图当前截图
    如果调用了 animateCamera 接口，请在 CameraChangeFinished 回调后再进行截图
    
    Parameters:
    
    callback - 截图回调
    
    config - 截图配置
  - snapshot
```
void snapshot(TencentMap.SnapshotReadyCallback callback)
```
    获取地图当前截图
    如果调用了 animateCamera 接口，请在 CameraChangeFinished 回调后再进行截图
    
    Parameters:
    
    callback - 截图回调
  - getCityName
```
java.lang.String getCityName(LatLng latLng)
```
    获得当前经纬度所在的城市名称
    
    Parameters:
    
    latLng - 经纬度
    
    Returns:
    
    城市的名称
  - setTencentMapGestureListener
```
void setTencentMapGestureListener(TencentMapGestureListener listener)
```
    Deprecated. 弃用，建议使用{addTencentMapGestureListener(TencentMapGestureListener)}
  - addTencentMapGestureListener
```
void addTencentMapGestureListener(TencentMapGestureListener listener)
```
    添加一个腾讯地图手势监听接口
    
    Parameters:
    
    listener - 参见TencentMapGestureListener
  - removeTencentMapGestureListener
```
void removeTencentMapGestureListener(TencentMapGestureListener listener)
```
    移除一个腾讯地图手势监听接口
    
    Parameters:
    
    listener - 参见TencentMapGestureListener
  - calculateZoomToSpanLevel
```
CameraPosition calculateZoomToSpanLevel(java.util.List<IOverlay> elements,
                                        java.util.List<LatLng> points,
                                        int leftPadding,
                                        int rightPadding,
                                        int topPadding,
                                        int bottomPadding)
```
    计算出要在当前底图可视区域内显示一组元素及一组点的比例尺和中心点（有填边）
    目前只有在 CameraPosition.bearing == 0 且 CameraPosition.tilt == 0 时才能获取到正确的值
    
    Parameters:
    
    elements - 要显示在底图上的元素
    
    points - 要显示在底图上的点
    
    leftPadding - 要显示的元素和点距离底图左边的边距(必须为正数）
    
    rightPadding - 要显示的元素和点距离底图右边的边距(必须为正数）
    
    topPadding - 要显示的元素和点距离底图上边的边距(必须为正数）
    
    bottomPadding - 要显示的元素和点距离底图下边的边距(必须为正数）
    
    Returns:
    
    显示一组元素和一组点的摄像机位置（底图的旋转角和俯仰角保持不变）（如果发生错误则比例尺返回@link com.tencent.map.lib.ErrorCode中定义的错误代码）
  - getVersion
```
java.lang.String getVersion()
```
    获取当前地图SDK的版本号
    
    Returns:
    
    地图版本号
  - isDestroyed
```
boolean isDestroyed()
```
    判断当前这个地图是不是已经被销毁了
    
    Returns:
    
    地图是否已经被销毁：true 被销毁 false 未销毁
  - setBuildingEnable
```
void setBuildingEnable(boolean use3DStyle)
```
    设置是否显示3D建筑
    
    Parameters:
    
    use3DStyle - 是否使用3D的模式绘制楼快，默认是true
  - setMapCenterAndScale
```
void setMapCenterAndScale(float centerX,
                          float centerY,
                          float targetScale)
```
    设置底图中心点及scale，屏幕左上角为 (0.0f, 0.0f), 右下角（1.0f, 1.0f)
    
    Parameters:
    
    centerX - 0~1.0f
    
    centerY - 0~1.0f
    
    targetScale - 目标scale
  - setPadding
```
void setPadding(int left,
                int top,
                int right,
                int bottom)
```
    设置底图相对上、下、左、右的边距
    
    Parameters:
    
    left - 左边距
    
    top - 上边距
    
    right - 右边距
    
    bottom - 下边距
  - setPadding
```
void setPadding(int left,
                int top,
                int right,
                int bottom,
                boolean moveCenter)
```
    设置底图相对上、下、左、右的边距，并移动地图中心点
    
    Parameters:
    
    left - 左边距
    
    top - 上边距
    
    right - 右边距
    
    bottom - 下边距
    
    Since:
    
    4.2.6.3
  - getMapPadding
```
Rect getMapPadding()
```
    获取底图相对上、下、左、右的边距
    
    Returns:
    
    左、上、右、下
  - getBounderPoints
```
java.util.List<LatLng> getBounderPoints(Marker marker)
```
    获取marker外包点集
    
    Returns:
    
    外包点集
  - getLanguage
```
MapLanguage getLanguage()
```
    Deprecated. 从4.1.1.1弃用，目前地图暂不支持多语言
  - setOnMarkerClickListener
```
void setOnMarkerClickListener(TencentMap.OnMarkerClickListener listener)
```
    设置Marker点击事件的监听接口
    
    Parameters:
    
    listener - 参见 TencentMap.OnMarkerClickListener
  - setOnMarkerDragListener
```
void setOnMarkerDragListener(TencentMap.OnMarkerDragListener listener)
```
    设置Marker拖动事件的监听接口
    
    Parameters:
    
    listener - 参见 TencentMap.OnMarkerDragListener
  - setOnInfoWindowClickListener
```
void setOnInfoWindowClickListener(TencentMap.OnInfoWindowClickListener listener)
```
    设置Marker气泡点击事件监听接口
    
    Parameters:
    
    listener - 参见 TencentMap.OnInfoWindowClickListener
  - setInfoWindowAdapter
```
void setInfoWindowAdapter(TencentMap.InfoWindowAdapter infoWindowAdapter)
```
    设置气泡样式接口
    
    Parameters:
    
    infoWindowAdapter - 参见 TencentMap.InfoWindowAdapter
  - setMyLocationStyle
```
void setMyLocationStyle(MyLocationStyle myLocationStyle)
```
    设置定位的样式
    
    Parameters:
    
    myLocationStyle - MyLocationStyle
  - setOnIndoorStateChangeListener
```
void setOnIndoorStateChangeListener(TencentMap.OnIndoorStateChangeListener listener)
```
    设置室内图状态变化回调
    
    Parameters:
    
    listener - 参见TencentMap.OnIndoorStateChangeListener
  - setIndoorEnabled
```
void setIndoorEnabled(boolean enable)
```
    设置是否显示室内图
    
    Parameters:
    
    enable - true 展示室内图
  - setIndoorFloor
```
void setIndoorFloor(int floorId)
```
    设置当前激活状态室内图Building的选中的楼层
  - setIndoorFloor
```
void setIndoorFloor(java.lang.String buildingId,
                    java.lang.String floorName)
```
    将buildingId对应的室内图建筑物设置到指定楼层展示。
    
    Parameters:
    
    buildingId - 要设置楼层的 buildingId
    
    floorName - 楼层名称，参见 IndoorLevel.getName()
  - getIndoorFloorId
```
int getIndoorFloorId()
```
    获取当前激活状态室内图Building的选中楼层ID
  - getActivedIndoorFloorNames
```
java.lang.String[] getActivedIndoorFloorNames()
```
    获取当前激活状态室内图的楼层名称列表
  - getActivedIndoorBuilding
```
@Deprecated
java.lang.String getActivedIndoorBuilding(LatLng outPosition)
```
    Deprecated. 从4.2.4弃用，室内图信息的获取应从回调中监听
  - setOnMapPoiClickListener
```
void setOnMapPoiClickListener(TencentMap.OnMapPoiClickListener listener)
```
    设置地图标注点点击回调
    
    Parameters:
    
    listener - 参见TencentMap.OnMapPoiClickListener
  - setCameraCenterProportion
```
void setCameraCenterProportion(float x,
                               float y)
```
    设置camera变换的中心点并将变换中心点设置为地图当前的中心点
    
    Parameters:
    
    x - 变换中心点在 mapView 水平方向的百分比 [0, 1]
    
    y - 变换中心点在 mapView 垂直方向的百分比 [0, 1]
  - setCameraCenterProportion
```
void setCameraCenterProportion(float x,
                               float y,
                               boolean moveMap)
```
    设置camera变换的中心点
    
    Parameters:
    
    x - 变换中心点在 mapView 水平方向的百分比 [0, 1]
    
    y - 变换中心点在 mapView 垂直方向的百分比 [0, 1]
    
    moveMap - 是否将变换中心点设置为地图当前的中心点
  - setPointToCenter
```
void setPointToCenter(int x,
                      int y)
```
    设置屏幕上的某个像素点为中心
    
    Parameters:
    
    x - X像素坐标
    
    y - Y像素坐标
  - setMaxZoomLevel
```
void setMaxZoomLevel(int zoomLevel)
```
    设置地图的最大缩放级别
    
    Parameters:
    
    zoomLevel - 缩放级别[1~20]
  - setMinZoomLevel
```
void setMinZoomLevel(int zoomLevel)
```
    设置地图的最小缩放级别
    
    Parameters:
    
    zoomLevel - 缩放级别[1~20]
  - loadKMLFile
```
void loadKMLFile(java.lang.String filePath)
```
    加载 KML 文件
    
    Parameters:
    
    filePath - KML 文件路径
  - setDrawPillarWith2DStyle
```
void setDrawPillarWith2DStyle(boolean use2DStyle)
```
    Deprecated. 从4.2.4弃用，建议使用 setBuildingEnable(boolean) 替代
    
    设置楼块绘制2d, 3d模式，此接口只会影响地图3D态时（地图倾斜角或旋转角不为0）的楼块显示情况，地图2D状态下（地图倾斜角和旋转角都为0）不显示楼块 1、use2DStyle为true时,在地图3D态时,不显示楼块 2、use2DStyle为false时, 在地图3D态时,会显示楼块
    
    Parameters:
    
    use2DStyle - 是否使用2D模式绘制楼快
  - setBlockRouteEnabled
```
void setBlockRouteEnabled(boolean enable)
```
    Deprecated.
    
    设置是否展示封闭路段
    
    Parameters:
    
    enable - true 展示封路；false 不展示封路
    
    Since:
    
    4.3.0 不再保证此功能可用性
  - isBlockRouteEnabled
```
boolean isBlockRouteEnabled()
```
    Deprecated.
    
    获取是否封闭路段展示
    
    Returns:
    
    true 展示封路；false 不展示封路
    
    Since:
    
    4.3.0 不再保证此功能可用性
  - setHandDrawMapEnable
```
void setHandDrawMapEnable(boolean enable)
```
    设置是否开启手绘图
    
    Parameters:
    
    enable - true 开启手绘图
  - isHandDrawMapEnable
```
boolean isHandDrawMapEnable()
```
    当前手绘图是否处于开启状态
    
    Returns:
    
    是否开启手绘图
  - enableMultipleInfowindow
```
void enableMultipleInfowindow(boolean enable)
```
    设置地图是否允许多InfoWindow模式，默认是false(只允许显示一个InfoWindow) 注意：此方法需要在addMarker之前调用。
    
    Parameters:
    
    enable - 是否开启多窗口InfoWindow
  - getMapWidth
```
int getMapWidth()
```
    获取 mapview 宽度
    
    Returns:
    
    宽度
  - getMapHeight
```
int getMapHeight()
```
    获取 mapview 高度
    
    Returns:
    
    高度
  - setForeignLanguage
```
void setForeignLanguage(Language foreignLanguage)
```
    设置海外图优先显示的语言，默认优先显示中文（在创建地图时设置，不支持动态切换）
    
    Parameters:
    
    foreignLanguage - 海外图语言
  - getDebugError
```
java.lang.String getDebugError()
```
    获取地图引擎的Debug日志，在出现问题时用于日志分析
    
    Returns:
    
    错误信息
  - setPoisEnabled
```
void setPoisEnabled(boolean enabled)
```
    底图 poi 开关
    
    Parameters:
    
    enabled - 是否开启POI
  - setRestrictBounds
```
void setRestrictBounds(LatLngBounds restrictBounds,
                       RestrictBoundsFitMode fitMode)
```
    限制地图的显示范围。此接口同时会限制地图的最小缩放级别，用户还可以通过 setMinZoomLevel(int) 修改自己需要的最小缩放级别获取需要的展示效果
    
    Parameters:
    
    restrictBounds - 地图显示范围将要限制到的区域，如果要取消限制，需要传入一个宽度、高度都为0的区域，比如 new LatLngBounds(new LatLng(0, 0), new LatLng(0, 0))
    
    fitMode - 显示范围适配模式, RestrictBoundsFitMode.FIT_WIDTH 或者 RestrictBoundsFitMode.FIT_HEIGHT
    
    Since:
    
    4.3.4.1
  - setOnTrafficEventClickListener
```
void setOnTrafficEventClickListener(TencentMap.OnTrafficEventClickListener listener)
```
    事件点击回调
    
    Parameters:
    
    listener -
  - setCustomRender
```
void setCustomRender(CustomRender render)
```
    设置基于gles2.0的渲染器该方法可以在地图上添加自定义的3D模型
    
    Parameters:
    
    render - gl渲染器

Interface TencentMap

Nested Class Summary

Field Summary

Method Summary

Field Detail

MAP_TYPE_NONE

MAP_TYPE_NORMAL

MAP_TYPE_DARK

MAP_TYPE_SATELLITE

MAP_TYPE_TRAFFIC_NAVI

MAP_TYPE_TRAFFIC_NIGHT

MAP_TYPE_NIGHT

MAP_TYPE_NAVI

MAP_MODE_NORMAL

MAP_MODE_NORMAL_TRAFFIC

MAP_MODE_NAV

MAP_MODE_NAV_TRAFFIC

MAP_MODE_NAV_NIGHT

Method Detail

getMapContext

getCameraPosition

getZoomToSpanLevel

getMaxZoomLevel

getMinZoomLevel

setOnTapMapViewInfoWindowHidden

moveCamera

animateCamera

animateCamera

animateCamera

stopAnimation

addTileOverlay

addCustomLayer

addPolyline

addPolygon

addCircle

addMarker

clearAllOverlays

clear

clearCache

setMapType

getMapType

setMapStyle

getMapStyle

isTrafficEnabled

setTrafficEnabled

setSatelliteEnabled

isSateLiteEnable

isMyLocationEnabled

setMyLocationEnabled

getMyLocation

setLocationSource

getUiSettings

getProjection

setOnCameraChangeListener

setOnMapClickListener

setOnMapLongClickListener

setOnPolylineClickListener

setOnMyLocationChangeListener

setOnCompassClickedListener

setOnMapLoadedCallback

addOnMapLoadedCallback

removeOnMapLoadedCallback

snapshot

snapshot

getCityName

setTencentMapGestureListener

addTencentMapGestureListener

removeTencentMapGestureListener

calculateZoomToSpanLevel

getVersion

isDestroyed

setBuildingEnable

setMapCenterAndScale

setPadding

setPadding

getMapPadding

getBounderPoints

getLanguage

setOnMarkerClickListener

setOnMarkerDragListener