com.tencent.tencentmap.mapsdk.maps

## 接口 TencentMap

- 所有超级接口:
    IIndoor, IMyLocation
  所有已知子接口:
    TencentMapNavi

      public interface TencentMap
      extends IIndoor, IMyLocation

- - ### 嵌套类概要

    嵌套类
    限定符和类型 | 接口和说明
    --- | ---
    `static interface` | `TencentMap.AsyncOperateCallback<T>` 异步操作回调
    `static interface` | `TencentMap.CancelableCallback` 地图变换相关操作的状态回调接口 参见 `animateCamera(CameraUpdate, CancelableCallback)` 参见 `animateCamera(CameraUpdate, long, CancelableCallback)`
    `static interface` | `TencentMap.IClickedObject` 被点击对象的抽象接口
    `static interface` | `TencentMap.InfoWindowAdapter` 自定义 `Marker`气泡样式接口 参见 `setInfoWindowAdapter(InfoWindowAdapter)`
    `static interface` | `TencentMap.OnAuthResultCallback` 地图鉴权结果的回调接口
    `static interface` | `TencentMap.OnCameraChangeListener` 当地图发生变化时的调用接口 参见 `setOnCameraChangeListener(OnCameraChangeListener)`
    `static interface` | `TencentMap.OnCompassClickedListener` 当地图的罗盘被点击时的回调接口 参见 `setOnCompassClickedListener(OnCompassClickedListener)`
    `static interface` | `TencentMap.OnDismissCallback`
    `static interface` | `TencentMap.OnIndoorStateChangeListener` 室内图回调 参见 `TencentMap#setOnIndoorStateChangeListener(OnIndoorStateChangeListener listener)`
    `static interface` | `TencentMap.OnInfoWindowClickListener` 当 `Marker` 气泡窗口被点击时的回调 参见 `setInfoWindowAdapter(InfoWindowAdapter)`
    `static interface` | `TencentMap.OnMapClickListener` 当地图被点击时回调接口 参见 `setOnMapClickListener(OnMapClickListener)`
    `static interface` | `TencentMap.OnMapLoadedCallback` 地图加载完成的回调接口,设置之后只回调一次，如果需要再获取，则需要重新设置回调 参见 `setOnMapLoadedCallback(OnMapLoadedCallback)`
    `static interface` | `TencentMap.OnMapLongClickListener` 当地图被长按时回调接口 参见 `setOnMapLongClickListener(OnMapLongClickListener)`
    `static interface` | `TencentMap.OnMapPoiClickListener` poi点击listener 参见 `setOnMapPoiClickListener(OnMapPoiClickListener callback)`
    `static interface` | `TencentMap.OnMarkerClickListener` 当 `Marker` 被点击时回调接口 参见 `setOnMarkerClickListener(OnMarkerClickListener)`
    `static interface` | `TencentMap.OnMarkerDragListener` 当 `Marker` 被拖动时回调接口 参见 `setOnMarkerDragListener(OnMarkerDragListener)`
    `static interface` | `TencentMap.OnMyLocationChangeListener` 地图接收到我的位置发生变化时，回调接口 参见 `TencentMap#setOnMyLocationChangeListener(OnMyLocationChangeListener)`
    `static interface` | `TencentMap.OnMyLocationClickListener` 点击我的位置时的回调接口
    `static interface` | `TencentMap.OnPolygonClickListener` 当一个多边形被点击时的回调。
    `static interface` | `TencentMap.OnPolylineClickListener` 当一条折线被点击时的回调。
    `static interface` | `TencentMap.OnScaleViewChangedListener` 当比例尺级别变化时回调接口 参见 `setOnScaleViewChangedListener(OnScaleViewChangedListener)`
    `static interface` | `TencentMap.OnTrafficEventClickListener` 事件点击回调监听
    `static interface` | `TencentMap.OnVectorOverlayClickListener`
    `static interface` | `TencentMap.SnapshotReadyCallback` 地图截图的回调接口,回调是在主线程中运行的。

  - ### 字段概要

    字段
    限定符和类型 | 字段和说明
    --- | ---
    `static int` | `MAP_MODE_NAV` 已过时。 从4.1.2弃用，请使用 `MAP_TYPE_NAVI`
    `static int` | `MAP_MODE_NAV_NIGHT` 已过时。 从4.1.2弃用，请使用 `MAP_TYPE_NIGHT`
    `static int` | `MAP_MODE_NAV_TRAFFIC` 已过时。 从4.1.2弃用，请使用 `MAP_TYPE_TRAFFIC_NAVI`
    `static int` | `MAP_MODE_NORMAL` 已过时。 从4.1.2弃用，请使用 `MAP_TYPE_NORMAL`
    `static int` | `MAP_MODE_NORMAL_TRAFFIC` 已过时。 从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

  - ### 方法概要

    所有方法 实例方法 抽象方法 已过时的方法
    限定符和类型 | 方法和说明
    --- | ---
    `AoiLayer` | `addAoiLayer(java.lang.String poiId, AoiLayerOptions options, AoiLayer.OnAoiLayerLoadListener listener)` 添加标注点的区域面
    `Arc` | `addArc(ArcOptions options)` 添加弧线
    `Circle` | `addCircle(CircleOptions options)` 添加圆
    `CustomLayer` | `addCustomLayer(CustomLayerOptions options)` 添加个性化图层
    `GroundOverlay` | `addGroundOverlay(GroundOverlayOptions options)` 添加 GroundOverlay
    `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)` 添加瓦片图层
    `VectorHeatOverlay` | `addVectorHeatOverlay(VectorHeatOverlayOptions options)` 已过时。 请使用 `addVectorOverlay(VectorOverlayProvider)`
    `<L extends VectorOverlay> L` | `addVectorOverlay(VectorOverlayProvider provider)` 添加矢量图层
    `VisualLayer` | `addVisualLayer(VisualLayerOptions 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()` 已过时。 从4.3.0弃用，建议使用 {`clearAllOverlays()`}
    `void` | `clearAllOverlays()` 清除地图上所有的标注类（Marker、Polyline、Polygon，TileOverlay除外）
    `void` | `clearCache()` 清理缓存 将自定义瓦片、卫星图、底图等缓存数据进行清理 建议在线程中执行
    `void` | `enableAutoMaxSkew(boolean enabled)` 允许最大俯仰角跟随缩放级别变化
    `void` | `enableMultipleInfowindow(boolean enable)` 设置地图是否允许多InfoWindow模式，默认是false(只允许显示一个InfoWindow) 注意：此方法需要在addMarker之前调用。
    `java.lang.String` | `executeVisualLayerCommand(VisualLayer visualLayer, java.lang.String commandJson)`
    `java.util.List<LatLng>` | `getBounderPoints(Marker marker)` 获取marker外包点集
    `CameraPosition` | `getCameraPosition()` 获取当前地图的状态（包括中心点、比例尺、旋转角、倾斜角）
    `java.lang.String` | `getCityName(LatLng latLng)` 获得当前经纬度所在的城市名称
    `java.lang.String` | `getDebugError()` 获取地图引擎的Debug日志，在出现问题时用于日志分析
    `Language` | `getLanguage()` 地图当前的语言
    `<T extends TencentMapComponent.Component> T` | `getMapComponent(java.lang.Class<T> t)` 获取地图组件
    `TencentMapContext` | `getMapContext()` 获取地图上下文
    `int` | `getMapHeight()` 获取 mapview 高度
    `android.graphics.Rect` | `getMapPadding()` 获取底图相对上、下、左、右的边距
    `int` | `getMapStyle()` 获取当前地图的样式
    `int` | `getMapType()` 获取地图类型
    `int` | `getMapWidth()` 获取 mapview 宽度
    `float` | `getMaxZoomLevel()` 获取地图最大的支持的缩放级别
    `float` | `getMinZoomLevel()` 获取地图最小的支持的缩放级别
    `Projection` | `getProjection()` 获取坐标转换操作对象
    `java.util.List<Marker>` | `getScreenMarkers()` 获取屏幕范围内的全部标注(Marker)
    `UiSettings` | `getUiSettings()` 获取地图界面操作对象
    `java.lang.String` | `getVersion()` 获取当前地图SDK的版本号
    `VisualSettings` | `getVisualSettings()` 获取可视化图层配置对象
    `float` | `getZoomToSpanLevel(LatLng leftUpper, LatLng rightDown)` 根据两个经纬度指定一个范围，计算出当前屏幕如果要显示这个指定范围所要的缩放级别（需要等地图加载完成再调用）
    `boolean` | `isBlockRouteEnabled()` 已过时。 从4.3.5起，此功能废弃
    `boolean` | `isDestroyed()` 判断当前这个地图是不是已经被销毁了
    `boolean` | `isHandDrawMapEnable()` 当前手绘图是否处于开启状态
    `boolean` | `isSateLiteEnable()` 已过时。 @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` | `setBaseMapEnabled(boolean enabled)` 底图展示开关。
    `void` | `setBlockRouteEnabled(boolean enable)` 已过时。 从4.3.5起，此功能废弃
    `void` | `setBuilding3dEffectEnable(boolean enableEffect)` 设置是否显示3D建筑
    `void` | `setBuildingBlackList(java.util.List<LatLngBounds> latLngBounds)` 设置区域内3D建筑物拍平
    `void` | `setBuildingEnable(boolean use3DStyle)` 已过时。 use `setBuilding3dEffectEnable(boolean)` instead
    `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)` 已过时。 从4.2.4弃用，建议使用 `setBuildingEnable(boolean)` 替代
    `void` | `setForeignLanguage(Language foreignLanguage)` 设置海外图优先显示的语言，默认优先显示中文（在创建地图时设置，不支持动态切换）
    `void` | `setHandDrawMapEnable(boolean enable)` 设置是否开启手绘图
    `void` | `setInfoWindowAdapter(TencentMap.InfoWindowAdapter infoWindowAdapter)` 设置气泡样式接口
    `void` | `setLanguage(Language language)` 设置底图语言，默认为中文简体
    `void` | `setLocationCompassHidden(boolean hidden)` 设置隐藏定位罗盘
    `void` | `setLocationNavigationGravityLineHidden(boolean hidden)` 设置隐藏导航引导线
    `void` | `setMapCenterAndScale(float centerX, float centerY, float targetScale)` 设置底图中心点及scale， 屏幕左上角为 (0.0f, 0.0f), 右下角（1.0f, 1.0f)
    `void` | `setMapFontSize(MapFontSize fontSize)` 设置地图文字大小
    `void` | `setMapFrameRate(float frameRate)` 设置地图刷新帧率
    `void` | `setMapStyle(int styleType)` 设置当前地图的样式 根据自己在腾讯地图样式配置平台配置的样式对应的样式序号, 目前开放给用户自定义样式的值为 1 ~ 3 之间的整数 只有在 `MAP_TYPE_NORMAL` 时，才修改地图样式
    `void` | `setMapType(int mapType)` 设置地图类型
    `void` | `setMaxZoomLevel(int zoomLevel)` 设置地图的最大缩放级别
    `void` | `setMinZoomLevel(int zoomLevel)` 设置地图的最小缩放级别
    `void` | `setMyLocationStyle(MyLocationStyle myLocationStyle)` 设置定位的样式
    `void` | `setOnCameraChangeListener(TencentMap.OnCameraChangeListener onCameraChangeListener)` 设置地图变换的监听接口
    `void` | `setOnCompassClickedListener(TencentMap.OnCompassClickedListener onCompassClickedListener)` 设置罗盘位按钮监听接口
    `void` | `setOnInfoWindowClickListener(TencentMap.OnInfoWindowClickListener listener)` 设置Marker气泡点击事件监听接口
    `void` | `setOnMapClickListener(TencentMap.OnMapClickListener onMapClickListener)` 设置地图点击事件的监听接口
    `void` | `setOnMapLoadedCallback(TencentMap.OnMapLoadedCallback onMapLoadedCallback)` 已过时。 添加监听建议使用 `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` | `setOnPolygonClickListener(TencentMap.OnPolygonClickListener onPolygonClickListener)` 设置多边形被点击时的回调接口
    `void` | `setOnPolylineClickListener(TencentMap.OnPolylineClickListener onPolylineClickListener)` 设置线被点击时的回调接口
    `void` | `setOnScaleViewChangedListener(TencentMap.OnScaleViewChangedListener onScaleViewChangedListener)` 设置比例尺级别变化的监听接口
    `void` | `setOnTapMapViewInfoWindowHidden(boolean enable)` 点击地图其他区域时，InfoWindow是否需要隐藏
    `void` | `setOnTrafficEventClickListener(TencentMap.OnTrafficEventClickListener listener)` 事件点击回调
    `void` | `setOnVectorOverlayClickListener(TencentMap.OnVectorOverlayClickListener listener)` 设置地图可视化图层点击回调
    `void` | `setOverSeaEnable(boolean enable)` 是否开启海外图 如果鉴权不允许，则此开关设置无效
    `void` | `setOverSeaTileProvider(OverSeaTileProvider provider)` 设置海外图图源提供
    `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)` 限制地图的显示范围。
    `void` | `setSatelliteEnabled(boolean enable)` 已过时。 @since 4.3.0 使用 `setMapType(int)` `MAP_TYPE_SATELLITE` 替代
    `void` | `setSceneByTag(java.lang.String tag)`
    `void` | `setTencentMapGestureListener(TencentMapGestureListener listener)` 已过时。 弃用，建议使用{`addTencentMapGestureListener(TencentMapGestureListener)`}
    `void` | `setTrafficEnabled(boolean enable)` 开启或关闭实时交通路况的功能
    `void` | `setTrafficMode(int mode, int zoomLevel)` 设置路况状态模式
    `void` | `showBuilding(boolean shown)` 是否展示建筑物，不同于 `setBuilding3dEffectEnable(boolean)`,这个接口用于控制建筑物是否能够展示，默认 `true`
    `void` | `snapshot(TencentMap.SnapshotReadyCallback callback)` 获取地图当前截图 如果调用了 animateCamera 接口，请在 CameraChangeFinished 回调后再进行截图
    `void` | `snapshot(TencentMap.SnapshotReadyCallback callback, android.graphics.Bitmap.Config config)` 获取地图当前截图 如果调用了 animateCamera 接口，请在 CameraChangeFinished 回调后再进行截图
    `void` | `snapshot(TencentMap.SnapshotReadyCallback callback, android.graphics.Bitmap.Config config, int timeOut)` 获取地图当前截图 如果调用了 animateCamera 接口，请在 CameraChangeFinished 回调后再进行截图
    `void` | `stopAnimation()` 停止地图所有正在进行的动画
    `void` | `updateVectorOverlay(VectorOverlay overlay, VectorOverlayProvider provider)` 更新矢量图层

    - ### 从接口继承的方法 com.tencent.map.sdk.comps.indoor.IIndoor

      `getActivedIndoorBuilding, getActivedIndoorFloorNames, getIndoorFloorId, resetIndoorCellInfo, setIndoorCellInfo, setIndoorEnabled, setIndoorFloor, setIndoorFloor, setIndoorMaskColor, setOnIndoorStateChangeListener`

    - ### 从接口继承的方法 com.tencent.map.sdk.comps.mylocation.IMyLocation

      `getMyLocation, isMyLocationEnabled, setLocationSource, setMyLocationClickListener, setMyLocationEnabled, setOnMyLocationChangeListener`

- - ### 字段详细资料

    - #### MAP_TYPE_NONE

          static final int MAP_TYPE_NONE

      默认的地图类型
      另请参阅:
        常量字段值

    - #### MAP_TYPE_NORMAL

          static final int MAP_TYPE_NORMAL

      普通地图
      从以下版本开始:
        4.3.0 只能通过 `setMapType(int)` 设置
      另请参阅:
        常量字段值

    - #### MAP_TYPE_DARK

          static final int MAP_TYPE_DARK

      暗色模式
      从以下版本开始:
        4.3.0 新增
      另请参阅:
        常量字段值

    - #### MAP_TYPE_SATELLITE

          static final int MAP_TYPE_SATELLITE

      卫星图
      从以下版本开始:
        4.3.0 新增
      另请参阅:
        常量字段值

    - #### MAP_TYPE_TRAFFIC_NAVI

          static final int MAP_TYPE_TRAFFIC_NAVI

      导航白天 + 路况样式
      用于腾讯导航 sdk
      另请参阅:
        常量字段值

    - #### MAP_TYPE_TRAFFIC_NIGHT

          static final int MAP_TYPE_TRAFFIC_NIGHT

      导航夜间 + 路况样式
      用于腾讯导航 sdk
      另请参阅:
        常量字段值

    - #### MAP_TYPE_NIGHT

          static final int MAP_TYPE_NIGHT

      夜间模式
      另请参阅:
        常量字段值

    - #### MAP_TYPE_NAVI

          static final int MAP_TYPE_NAVI

      导航模式
      另请参阅:
        常量字段值

    - #### MAP_MODE_NORMAL

          static final int MAP_MODE_NORMAL

      已过时。 从4.1.2弃用，请使用 `MAP_TYPE_NORMAL`
      另请参阅:
        常量字段值

    - #### MAP_MODE_NORMAL_TRAFFIC

          static final int MAP_MODE_NORMAL_TRAFFIC

      已过时。 从4.1.2弃用，请使用 `setTrafficEnabled(boolean)`
      另请参阅:
        常量字段值

    - #### MAP_MODE_NAV

          static final int MAP_MODE_NAV

      已过时。 从4.1.2弃用，请使用 `MAP_TYPE_NAVI`
      另请参阅:
        常量字段值

    - #### MAP_MODE_NAV_TRAFFIC

          static final int MAP_MODE_NAV_TRAFFIC

      已过时。 从4.1.2弃用，请使用 `MAP_TYPE_TRAFFIC_NAVI`
      另请参阅:
        常量字段值

    - #### MAP_MODE_NAV_NIGHT

          static final int MAP_MODE_NAV_NIGHT

      已过时。 从4.1.2弃用，请使用 `MAP_TYPE_NIGHT`
      另请参阅:
        常量字段值

  - ### 方法详细资料

    - #### getMapContext

          TencentMapContext getMapContext()

      获取地图上下文
      返回:
        地图上下文

    - #### getMapComponent

          <T extends TencentMapComponent.Component> T getMapComponent(java.lang.Class<T> t)

      获取地图组件
      类型参数:
        `T` - 组件
      参数:
        `t` - 组件类
      返回:
        组件对象

    - #### getCameraPosition

          CameraPosition getCameraPosition()

      获取当前地图的状态（包括中心点、比例尺、旋转角、倾斜角）
      返回:
        当前地图的状态`CameraPosition`

    - #### getZoomToSpanLevel

          float getZoomToSpanLevel(LatLng leftUpper,
                                   LatLng rightDown)

      根据两个经纬度指定一个范围，计算出当前屏幕如果要显示这个指定范围所要的缩放级别（需要等地图加载完成再调用）
      参数:
        `leftUpper` - 左上角要显示的经纬度
        `rightDown` - 右下角要显示的经纬度
      返回:
        缩放级别

    - #### getMaxZoomLevel

          float getMaxZoomLevel()

      获取地图最大的支持的缩放级别
      返回:
        最大的缩放级别，默认是 20.0

    - #### getMinZoomLevel

          float getMinZoomLevel()

      获取地图最小的支持的缩放级别
      返回:
        最上的缩放级别，默认是 3.0

    - #### setOnTapMapViewInfoWindowHidden

          void setOnTapMapViewInfoWindowHidden(boolean enable)

      点击地图其他区域时，InfoWindow是否需要隐藏
      参数:
        `enable` - 隐藏开关

        true：点击地图其他区域，隐藏InfoWindow

        false：点击地图其他区域，不隐藏InfoWindow

    - #### moveCamera

          void moveCamera(CameraUpdate cameraUpdate)

      把地图变换到指定的状态
      参数:
        `cameraUpdate` - 状态对象 参见`CameraUpdate`

    - #### animateCamera

          void animateCamera(CameraUpdate cameraUpdate)

      把地图变换到指定的状态,带动画
      参数:
        `cameraUpdate` - 状态对象 参见`CameraUpdate`

    - #### animateCamera

          void animateCamera(CameraUpdate cameraUpdate,
                             TencentMap.CancelableCallback cancelableCallback)

      以动画的方式把地图变换到指定的状态
      参数:
        `cameraUpdate` - 状态对象 参见`CameraUpdate`
        `cancelableCallback` - 动画状态监听器`TencentMap.CancelableCallback`

    - #### animateCamera

          void animateCamera(CameraUpdate cameraUpdate,
                             long duration,
                             TencentMap.CancelableCallback cancelableCallback)

      以动画的方式把地图变换到指定的状态
      参数:
        `cameraUpdate` - 状态对象 参见`CameraUpdate`
        `duration` - 动画执行时间（单位：ms）
        `cancelableCallback` - 动画状态监听器`TencentMap.CancelableCallback`

    - #### stopAnimation

          void stopAnimation()

      停止地图所有正在进行的动画

    - #### addTileOverlay

          TileOverlay addTileOverlay(TileOverlayOptions options)

      添加瓦片图层
      参数:
        `options` - 瓦片选项
      返回:
        新创建的瓦片图层
      从以下版本开始:
        4.2.5

    - #### addCustomLayer

          CustomLayer addCustomLayer(CustomLayerOptions options)

      添加个性化图层
      参数:
        `options` - 图层选项
      返回:
        新创建的图层
      从以下版本开始:
        4.2.9

    - #### addPolyline

          Polyline addPolyline(PolylineOptions options)

      添加线
      参数:
        `options` - 线属性,参见`PolylineOptions`
      返回:
        新创建的线

    - #### addPolygon

          Polygon addPolygon(PolygonOptions options)

      添加多边形
      参数:
        `options` - 多边形属性,参见`PolygonOptions`
      返回:
        新创建的多边形

    - #### addCircle

          Circle addCircle(CircleOptions options)

      添加圆
      参数:
        `options` - 折线的参数,参见`CircleOptions`
      返回:
        新创建的圆

    - #### addMarker

          Marker addMarker(MarkerOptions options)

      添加标注(Marker)
      参数:
        `options` - marker 属性,参见`MarkerOptions`
      返回:
        新创建的标注

    - #### getScreenMarkers

          java.util.List<Marker> getScreenMarkers()

      获取屏幕范围内的全部标注(Marker)
      参数:
        -
      返回:
        屏幕内的全部标注

    - #### addArc

          Arc addArc(ArcOptions options)

      添加弧线
      参数:
        `options` - 弧属性, 参见`ArcOptions`
      返回:

    - #### clearAllOverlays

          void clearAllOverlays()

      清除地图上所有的标注类（Marker、Polyline、Polygon，TileOverlay除外）
      从以下版本开始:
        4.3.0

    - #### clear

          void clear()

      已过时。 从4.3.0弃用，建议使用 {`clearAllOverlays()`}

    - #### clearCache

          void clearCache()

      清理缓存 将自定义瓦片、卫星图、底图等缓存数据进行清理

      建议在线程中执行

      从以下版本开始:
        4.3.0

    - #### setMapType

          void setMapType(int mapType)

      设置地图类型
      参数:
        `mapType` - 仅限设置为：`MAP_TYPE_NORMAL`、 `MAP_TYPE_DARK`、 `MAP_TYPE_SATELLITE`
      从以下版本开始:
        4.3.0

    - #### getMapType

          int getMapType()

      获取地图类型
      从以下版本开始:
        4.3.0

    - #### setMapStyle

          void setMapStyle(int styleType)

      设置当前地图的样式
      根据自己在腾讯地图样式配置平台配置的样式对应的样式序号, 目前开放给用户自定义样式的值为 1 ~ 3 之间的整数
      只有在 `MAP_TYPE_NORMAL` 时，才修改地图样式
      参数:
        `styleType` - 地图样式

    - #### getMapStyle

          int getMapStyle()

      获取当前地图的样式
      返回:
        当前地图样式

    - #### isTrafficEnabled

          boolean isTrafficEnabled()

      获取地图当前是否开启实时交通路况
      返回:
        是否开启：true 开启 false 关闭

    - #### setTrafficEnabled

          void setTrafficEnabled(boolean enable)

      开启或关闭实时交通路况的功能
      参数:
        `enable` - 是否开启：true 开启 false 关闭

    - #### setTrafficMode

          void setTrafficMode(int mode,
                              int zoomLevel)

      设置路况状态模式
      参数:
        `mode` - 路况模式 0: 普通模式, 1: 数据重用模式, 只更新路况状态 默认0
        `zoomLevel` - 开始的级别, 仅当mode为1时生效

    - #### setMapFontSize

          void setMapFontSize(MapFontSize fontSize)

      设置地图文字大小
      参数:
        `fontSize` - 文字大小,支持5种尺寸

    - #### setSatelliteEnabled

          void setSatelliteEnabled(boolean enable)

      已过时。 @since 4.3.0 使用 `setMapType(int)` `MAP_TYPE_SATELLITE` 替代
      开启或关闭实时卫星视图的功能 注： 1、开启卫星图状态下,用户调用`setMapStyle(int)` / `setMapType(int)`切换样式将不生效 2、关闭卫星图，则恢复到开启卫星图之前设置的样式
      参数:
        `enable` - 是否开启：true 开启 false 关闭

    - #### isSateLiteEnable

          boolean isSateLiteEnable()

      已过时。 @since 4.3.0 使用 `getMapType()` `MAP_TYPE_SATELLITE` 替代
      返回卫星图状态
      返回:
        是否开启卫星图

    - #### getUiSettings

          UiSettings getUiSettings()

      获取地图界面操作对象
      返回:
        当前地图操作对象 参见 `UiSettings`

    - #### getProjection

          Projection getProjection()

      获取坐标转换操作对象
      返回:
        当前地图的坐标转换对象 参见`Projection`

    - #### getVisualSettings

          VisualSettings getVisualSettings()

      获取可视化图层配置对象
      返回:
        当前地图的可视化图层配置对象 参见`VisualSettings`

    - #### setOnCameraChangeListener

          void setOnCameraChangeListener(TencentMap.OnCameraChangeListener onCameraChangeListener)

      设置地图变换的监听接口
      参数:
        `onCameraChangeListener` - 参见`TencentMap.OnCameraChangeListener`

    - #### setOnScaleViewChangedListener

          void setOnScaleViewChangedListener(TencentMap.OnScaleViewChangedListener onScaleViewChangedListener)

      设置比例尺级别变化的监听接口
      参数:
        `onScaleViewChangedListener` - 参见 `TencentMap.OnScaleViewChangedListener`

    - #### setOnMapClickListener

          void setOnMapClickListener(TencentMap.OnMapClickListener onMapClickListener)

      设置地图点击事件的监听接口
      参数:
        `onMapClickListener` - 参见`TencentMap.OnMapClickListener`

    - #### setOnMapLongClickListener

          void setOnMapLongClickListener(TencentMap.OnMapLongClickListener onMapLongClickListener)

      设置地图长按事件的监听接口
      参数:
        `onMapLongClickListener` - 参见`TencentMap.OnMapLongClickListener`

    - #### setOnPolylineClickListener

          void setOnPolylineClickListener(TencentMap.OnPolylineClickListener onPolylineClickListener)

      设置线被点击时的回调接口
      参数:
        `onPolylineClickListener` - 参见`TencentMap.OnPolylineClickListener`

    - #### setOnPolygonClickListener

          void setOnPolygonClickListener(TencentMap.OnPolygonClickListener onPolygonClickListener)

      设置多边形被点击时的回调接口
      参数:
        `onPolygonClickListener` - 参见`TencentMap.OnPolygonClickListener`

    - #### setOnCompassClickedListener

          void setOnCompassClickedListener(TencentMap.OnCompassClickedListener onCompassClickedListener)

      设置罗盘位按钮监听接口
      参数:
        `onCompassClickedListener` - 参见`TencentMap.OnCompassClickedListener`

    - #### setOnMapLoadedCallback

          void setOnMapLoadedCallback(TencentMap.OnMapLoadedCallback onMapLoadedCallback)

      已过时。 添加监听建议使用 `addOnMapLoadedCallback(OnMapLoadedCallback)`

      移除监听建议使用 `removeOnMapLoadedCallback(OnMapLoadedCallback)`

      设置地图加载完成回调接口
      参数:
        `onMapLoadedCallback` - 参见`TencentMap.OnMapLoadedCallback`

    - #### addOnMapLoadedCallback

          void addOnMapLoadedCallback(TencentMap.OnMapLoadedCallback onMapLoadedCallback)

      设置地图加载完成回调接口
      参数:
        `onMapLoadedCallback` - 参见`TencentMap.OnMapLoadedCallback`

    - #### removeOnMapLoadedCallback

          void removeOnMapLoadedCallback(TencentMap.OnMapLoadedCallback onMapLoadedCallback)

      设置地图加载完成回调接口
      参数:
        `onMapLoadedCallback` - 参见`TencentMap.OnMapLoadedCallback`

    - #### snapshot

          void snapshot(TencentMap.SnapshotReadyCallback callback)

      获取地图当前截图
      如果调用了 animateCamera 接口，请在 CameraChangeFinished 回调后再进行截图
      参数:
        `callback` - 截图回调

    - #### snapshot

          void snapshot(TencentMap.SnapshotReadyCallback callback,
                        android.graphics.Bitmap.Config config)

      获取地图当前截图
      如果调用了 animateCamera 接口，请在 CameraChangeFinished 回调后再进行截图
      参数:
        `callback` - 截图回调
        `config` - 截图配置

    - #### snapshot

          void snapshot(TencentMap.SnapshotReadyCallback callback,
                        android.graphics.Bitmap.Config config,
                        int timeOut)

      获取地图当前截图
      如果调用了 animateCamera 接口，请在 CameraChangeFinished 回调后再进行截图
      参数:
        `callback` - 截图回调
        `config` - 截图配置
        `timeOut` - 超时时间，单位 ms, 当到达设置的超时时间时(这个超时时间并不精确，可能会有不超过 100ms 的延迟)， 无论地图是否完成渲染，都会返回截图，当设置的值小于等于 0 时，忽略这个值，地图渲染完成才进行截图

    - #### getCityName

          java.lang.String getCityName(LatLng latLng)

      获得当前经纬度所在的城市名称
      参数:
        `latLng` - 经纬度
      返回:
        城市的名称

    - #### setTencentMapGestureListener

          void setTencentMapGestureListener(TencentMapGestureListener listener)

      已过时。 弃用，建议使用{`addTencentMapGestureListener(TencentMapGestureListener)`}

    - #### addTencentMapGestureListener

          void addTencentMapGestureListener(TencentMapGestureListener listener)

      添加一个腾讯地图手势监听接口
      参数:
        `listener` - 参见`TencentMapGestureListener`

    - #### removeTencentMapGestureListener

          void removeTencentMapGestureListener(TencentMapGestureListener listener)

      移除一个腾讯地图手势监听接口
      参数:
        `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 时才能获取到正确的值
      参数:
        `elements` - 要显示在底图上的元素
        `points` - 要显示在底图上的点
        `leftPadding` - 要显示的元素和点距离底图左边的边距(必须为正数）
        `rightPadding` - 要显示的元素和点距离底图右边的边距(必须为正数）
        `topPadding` - 要显示的元素和点距离底图上边的边距(必须为正数）
        `bottomPadding` - 要显示的元素和点距离底图下边的边距(必须为正数）
      返回:
        显示一组元素和一组点的摄像机位置（底图的旋转角和俯仰角保持不变）（如果发生错误 则比例尺返回@link com.tencent.map.lib.ErrorCode中定义的错误代码）

    - #### getVersion

          java.lang.String getVersion()

      获取当前地图SDK的版本号
      返回:
        地图版本号

    - #### isDestroyed

          boolean isDestroyed()

      判断当前这个地图是不是已经被销毁了
      返回:
        地图是否已经被销毁：true 被销毁 false 未销毁

    - #### showBuilding

          void showBuilding(boolean shown)

      是否展示建筑物，不同于 `setBuilding3dEffectEnable(boolean)`,这个接口用于控制建筑物是否能够展示，默认 `true`
      参数:
        `shown` - 是否可以展示建筑物， `true`：展示建筑物；`false`:不展示

    - #### setBuildingEnable

          void setBuildingEnable(boolean use3DStyle)

      已过时。 use `setBuilding3dEffectEnable(boolean)` instead
      设置是否显示3D建筑
      参数:
        `use3DStyle` - 是否使用3D的模式绘制楼快，默认是true

    - #### setBuilding3dEffectEnable

          void setBuilding3dEffectEnable(boolean enableEffect)

      设置是否显示3D建筑
      参数:
        `enableEffect` - 是否使用3D的模式绘制楼块，默认是true
      从以下版本开始:
        4.3.9.2

    - #### setBuildingBlackList

          void setBuildingBlackList(java.util.List<LatLngBounds> latLngBounds)

      设置区域内3D建筑物拍平
      参数:
        `latLngBounds` -

    - #### setMapCenterAndScale

          void setMapCenterAndScale(float centerX,
                                    float centerY,
                                    float targetScale)

      设置底图中心点及scale， 屏幕左上角为 (0.0f, 0.0f), 右下角（1.0f, 1.0f)
      参数:
        `centerX` - 0~1.0f
        `centerY` - 0~1.0f
        `targetScale` - 目标scale

    - #### setPadding

          void setPadding(int left,
                          int top,
                          int right,
                          int bottom)

      设置底图相对上、下、左、右的边距
      参数:
        `left` - 左边距
        `top` - 上边距
        `right` - 右边距
        `bottom` - 下边距

    - #### setPadding

          void setPadding(int left,
                          int top,
                          int right,
                          int bottom,
                          boolean moveCenter)

      设置底图相对上、下、左、右的边距，并移动地图中心点
      参数:
        `left` - 左边距
        `top` - 上边距
        `right` - 右边距
        `bottom` - 下边距
      从以下版本开始:
        4.2.6.3

    - #### getMapPadding

          android.graphics.Rect getMapPadding()

      获取底图相对上、下、左、右的边距
      返回:
        左、上、右、下

    - #### getBounderPoints

          java.util.List<LatLng> getBounderPoints(Marker marker)

      获取marker外包点集
      返回:
        外包点集

    - #### getLanguage

          Language getLanguage()

      地图当前的语言

    - #### setLanguage

          void setLanguage(Language language)

      设置底图语言，默认为中文简体
      参数:
        `language` - 语言

    - #### setOnMarkerClickListener

          void setOnMarkerClickListener(TencentMap.OnMarkerClickListener listener)

      设置Marker点击事件的监听接口
      参数:
        `listener` - 参见 `TencentMap.OnMarkerClickListener`

    - #### setOnMarkerDragListener

          void setOnMarkerDragListener(TencentMap.OnMarkerDragListener listener)

      设置Marker拖动事件的监听接口
      参数:
        `listener` - 参见 `TencentMap.OnMarkerDragListener`

    - #### setOnInfoWindowClickListener

          void setOnInfoWindowClickListener(TencentMap.OnInfoWindowClickListener listener)

      设置Marker气泡点击事件监听接口
      参数:
        `listener` - 参见 `TencentMap.OnInfoWindowClickListener`

    - #### setInfoWindowAdapter

          void setInfoWindowAdapter(TencentMap.InfoWindowAdapter infoWindowAdapter)

      设置气泡样式接口
      参数:
        `infoWindowAdapter` - 参见 `TencentMap.InfoWindowAdapter`

    - #### setMyLocationStyle

          void setMyLocationStyle(MyLocationStyle myLocationStyle)

      设置定位的样式
      指定者:
        `setMyLocationStyle` 在接口中 `IMyLocation`
      参数:
        `myLocationStyle` - `MyLocationStyle`

    - #### setLocationCompassHidden

          void setLocationCompassHidden(boolean hidden)

      设置隐藏定位罗盘
      参数:
        `hidden` - 默认为true

    - #### setLocationNavigationGravityLineHidden

          void setLocationNavigationGravityLineHidden(boolean hidden)

      设置隐藏导航引导线
      参数:
        `hidden` - 默认为true

    - #### setOnMapPoiClickListener

          void setOnMapPoiClickListener(TencentMap.OnMapPoiClickListener listener)

      设置地图标注点点击回调
      参数:
        `listener` - 参见`TencentMap.OnMapPoiClickListener`

    - #### setOnVectorOverlayClickListener

          void setOnVectorOverlayClickListener(TencentMap.OnVectorOverlayClickListener listener)

      设置地图可视化图层点击回调
      参数:
        `listener` - 参见`TencentMap.OnVectorOverlayClickListener`

    - #### setCameraCenterProportion

          void setCameraCenterProportion(float x,
                                         float y)

      设置camera变换的中心点并将变换中心点设置为地图当前的中心点
      参数:
        `x` - 变换中心点在 mapView 水平方向的百分比 [0, 1]
        `y` - 变换中心点在 mapView 垂直方向的百分比 [0, 1]

    - #### setCameraCenterProportion

          void setCameraCenterProportion(float x,
                                         float y,
                                         boolean moveMap)

      设置camera变换的中心点
      参数:
        `x` - 变换中心点在 mapView 水平方向的百分比 [0, 1]
        `y` - 变换中心点在 mapView 垂直方向的百分比 [0, 1]
        `moveMap` - 是否将变换中心点设置为地图当前的中心点

    - #### setPointToCenter

          void setPointToCenter(int x,
                                int y)

      设置屏幕上的某个像素点为中心
      参数:
        `x` - X像素坐标
        `y` - Y像素坐标

    - #### setMaxZoomLevel

          void setMaxZoomLevel(int zoomLevel)

      设置地图的最大缩放级别
      参数:
        `zoomLevel` - 缩放级别[1~20]

    - #### setMinZoomLevel

          void setMinZoomLevel(int zoomLevel)

      设置地图的最小缩放级别
      参数:
        `zoomLevel` - 缩放级别[1~20]

    - #### enableAutoMaxSkew

          void enableAutoMaxSkew(boolean enabled)

      允许最大俯仰角跟随缩放级别变化
      参数:
        `enabled` -

    - #### loadKMLFile

          void loadKMLFile(java.lang.String filePath)

      加载 KML 文件
      参数:
        `filePath` - KML 文件路径

    - #### setDrawPillarWith2DStyle

          void setDrawPillarWith2DStyle(boolean use2DStyle)

      已过时。 从4.2.4弃用，建议使用 `setBuildingEnable(boolean)` 替代
      设置楼块绘制2d, 3d模式，此接口只会影响地图3D态时（地图倾斜角或旋转角不为0）的楼块显示情况，地图2D状态下（地图倾斜角和旋转角都为0）不显示楼块 1、use2DStyle为true时,在地图3D态时,不显示楼块 2、use2DStyle为false时, 在地图3D态时,会显示楼块
      参数:
        `use2DStyle` - 是否使用2D模式绘制楼快

    - #### setBlockRouteEnabled

          void setBlockRouteEnabled(boolean enable)

      已过时。 从4.3.5起，此功能废弃
      设置是否展示封闭路段
      参数:
        `enable` - `true` 展示封路；`false` 不展示封路
      从以下版本开始:
        4.3.0 不再保证此功能可用性

    - #### isBlockRouteEnabled

          boolean isBlockRouteEnabled()

      已过时。 从4.3.5起，此功能废弃
      获取是否封闭路段展示
      返回:
        `true` 展示封路；`false` 不展示封路
      从以下版本开始:
        4.3.0 不再保证此功能可用性

    - #### setHandDrawMapEnable

          void setHandDrawMapEnable(boolean enable)

      设置是否开启手绘图
      参数:
        `enable` - true 开启手绘图

    - #### isHandDrawMapEnable

          boolean isHandDrawMapEnable()

      当前手绘图是否处于开启状态
      返回:
        是否开启手绘图

    - #### enableMultipleInfowindow

          void enableMultipleInfowindow(boolean enable)

      设置地图是否允许多InfoWindow模式，默认是false(只允许显示一个InfoWindow) 注意：此方法需要在addMarker之前调用。
      参数:
        `enable` - 是否开启多窗口InfoWindow

    - #### getMapWidth

          int getMapWidth()

      获取 mapview 宽度
      返回:
        宽度

    - #### getMapHeight

          int getMapHeight()

      获取 mapview 高度
      返回:
        高度

    - #### setForeignLanguage

          void setForeignLanguage(Language foreignLanguage)

      设置海外图优先显示的语言，默认优先显示中文（在创建地图时设置，不支持动态切换）
      参数:
        `foreignLanguage` - 海外图语言

    - #### setSceneByTag

          void setSceneByTag(java.lang.String tag)

    - #### getDebugError

          java.lang.String getDebugError()

      获取地图引擎的Debug日志，在出现问题时用于日志分析
      返回:
        错误信息

    - #### setPoisEnabled

          void setPoisEnabled(boolean enabled)

      底图 poi 开关
      参数:
        `enabled` - 是否开启POI

    - #### setRestrictBounds

          void setRestrictBounds(LatLngBounds restrictBounds,
                                 RestrictBoundsFitMode fitMode)

      限制地图的显示范围。此接口同时会限制地图的最小缩放级别，用户还可以通过 `setMinZoomLevel(int)` 修改自己需要的最小缩放级别获取需要的展示效果
      参数:
        `restrictBounds` - 地图显示范围将要限制到的区域，如果要取消限制，需要传入一个宽度、高度都为0的区域，比如 `new LatLngBounds(new LatLng(0, 0), new LatLng(0, 0))`
        `fitMode` - 显示范围适配模式, `RestrictBoundsFitMode.FIT_WIDTH` 或者 `RestrictBoundsFitMode.FIT_HEIGHT`
      从以下版本开始:
        4.3.4.1

    - #### setOnTrafficEventClickListener

          void setOnTrafficEventClickListener(TencentMap.OnTrafficEventClickListener listener)

      事件点击回调
      参数:
        `listener` -

    - #### setCustomRender

          void setCustomRender(CustomRender render)

      设置基于gles2.0的渲染器 该方法可以在地图上添加自定义的3D模型
      参数:
        `render` - gl渲染器

    - #### addVectorHeatOverlay

          VectorHeatOverlay addVectorHeatOverlay(VectorHeatOverlayOptions options)

      已过时。 请使用 `addVectorOverlay(VectorOverlayProvider)`
      添加矢量热力图图层

    - #### addVectorOverlay

          <L extends VectorOverlay> L addVectorOverlay(VectorOverlayProvider provider)

      添加矢量图层
      类型参数:
        `L` -
      参数:
        `provider` -
      返回:
        矢量图层

    - #### updateVectorOverlay

          void updateVectorOverlay(VectorOverlay overlay,
                                   VectorOverlayProvider provider)

      更新矢量图层
      参数:
        `provider` -

    - #### addGroundOverlay

          GroundOverlay addGroundOverlay(GroundOverlayOptions options)

      添加 GroundOverlay
      参数:
        `options` -
      返回:

    - #### addVisualLayer

          VisualLayer addVisualLayer(VisualLayerOptions options)

      添加可视化数据图层
      参数:
        `options` - 数据图层选项
      返回:
        可视化数据图层对象

    - #### executeVisualLayerCommand

          java.lang.String executeVisualLayerCommand(VisualLayer visualLayer,
                                                     java.lang.String commandJson)

    - #### addAoiLayer

          AoiLayer addAoiLayer(java.lang.String poiId,
                               AoiLayerOptions options,
                               AoiLayer.OnAoiLayerLoadListener listener)

      添加标注点的区域面
      参数:
        `poiId` - 标注点ID
        `options` - 区域面配置项
        `listener` - 加载回调，返回添加的结果和区域面对象
      返回:
        区域面对象

    - #### setBaseMapEnabled

          void setBaseMapEnabled(boolean enabled)

      底图展示开关。如果期望控制 poi 的展示，参见 `setPoisEnabled(boolean)`
      参数:
        `enabled` - `true`，展示底图；`false`，关闭底图
      从以下版本开始:
        v4.3.9.2 不再控制建筑物的展示，请查阅 `showBuilding(boolean)`

    - #### setOverSeaTileProvider

          void setOverSeaTileProvider(OverSeaTileProvider provider)

      设置海外图图源提供
      参数:
        `provider` - 海外图图源提供

    - #### setMapFrameRate

          void setMapFrameRate(float frameRate)

      设置地图刷新帧率
      参数:
        `frameRate` - 刷新帧率，建议设置30-60帧内效果最好，有效取值范围(0,)

    - #### setOverSeaEnable

          void setOverSeaEnable(boolean enable)

      是否开启海外图 如果鉴权不允许，则此开关设置无效
      参数:
        `enable` - true-开启，false-关闭，默认true