public interface

TencentMap

implements IIndoor IMyLocation
com.tencent.tencentmap.mapsdk.maps.TencentMap
Known Indirect Subclasses

Summary

Nested Classes
interface TencentMap.AddAgileMarkerCallback 添加百变Marker结果的回调接口

参见 addAgileMarker(AgileMarkerOptions, AddAgileMarkerCallback)

 
enum TencentMap.AddAgileMarkerResult 添加百变Marker的结果枚举  
interface TencentMap.AsyncOperateCallback<T> 异步操作回调 
interface TencentMap.CancelableCallback 地图变换相关操作的状态回调接口

参见 animateCamera(CameraUpdate, CancelableCallback)

参见 animateCamera(CameraUpdate, long, CancelableCallback)

 
interface TencentMap.IClickedObject 被点击对象的抽象接口  
interface TencentMap.InfoWindowAdapter 自定义 Marker气泡样式接口

参见 setInfoWindowAdapter(InfoWindowAdapter)

 
interface TencentMap.OnAgileMarkerClickListener 当 AgileMarker 被点击时回调接口

参见 setOnAgileMarkerClickListener(OnAgileMarkerClickListener)

 
interface TencentMap.OnAuthResultCallback 地图鉴权结果的回调接口  
interface TencentMap.OnCameraChangeFullyListener 当地图状态全程变化时回调接口

参见 setOnCameraChangeFullyListener(OnCameraChangeFullyListener)

 
interface TencentMap.OnCameraChangeListener 当地图发生变化时的调用接口

参见 setOnCameraChangeListener(OnCameraChangeListener)

 
interface TencentMap.OnCameraRestrictListener 当设置限制区域 setRestrictBounds(LatLngBounds, RestrictBoundsFitMode) 后，相机移动到限制区域边缘会回调

参见 setOnCameraRestrictListener(OnCameraRestrictListener)

 
interface TencentMap.OnCompassClickedListener 当地图的罗盘被点击时的回调接口

参见 setOnCompassClickedListener(OnCompassClickedListener)

 
interface TencentMap.OnDismissCallback  
interface TencentMap.OnIndoorStateChangeListener 室内图回调

参见 setOnIndoorStateChangeListener(OnIndoorStateChangeListener)

 
interface TencentMap.OnInfoWindowClickListener 当 Marker 气泡窗口被点击时的回调

参见 setInfoWindowAdapter(InfoWindowAdapter)

 
interface TencentMap.OnMapClickListener 当地图被点击时回调接口

参见 setOnMapClickListener(OnMapClickListener)

 
interface TencentMap.OnMapFirstFrameCallback 地图完成首屏渲染回调 
interface TencentMap.OnMapFrameFinishCallback 地图完成首屏渲染回调，仅依赖当前资源的渲染完成 
interface TencentMap.OnMapLoadedCallback 地图加载完成的回调接口,设置之后只回调一次，如果需要再获取，则需要重新设置回调

参见 setOnMapLoadedCallback(OnMapLoadedCallback)

 
interface TencentMap.OnMapLongClickListener 当地图被长按时回调接口

参见 setOnMapLongClickListener(OnMapLongClickListener)

 
interface TencentMap.OnMapPoiClickListener poi点击listener

参见 setOnMapPoiClickListener(OnMapPoiClickListener)

 
interface TencentMap.OnMarkerClickListener 当 Marker 被点击时回调接口

参见 setOnMarkerClickListener(OnMarkerClickListener)

 
interface TencentMap.OnMarkerCollisionStatusListener 当 Marker 触发碰撞时，显示和隐藏的状态回调

参见 setOnMarkerCollisionStatusListener(OnMarkerCollisionStatusListener)

 
interface TencentMap.OnMarkerDragListener 当 Marker 被拖动时回调接口

参见 setOnMarkerDragListener(OnMarkerDragListener)

 
interface TencentMap.OnMyLocationChangeListener 地图接收到我的位置发生变化时，回调接口

参见 setOnMyLocationChangeListener(OnMyLocationChangeListener)

 
interface TencentMap.OnMyLocationClickListener 点击我的位置时的回调接口  
interface TencentMap.OnPolygonClickListener 当一个多边形被点击时的回调。

参见 setOnPolygonClickListener(OnPolygonClickListener)

 
interface TencentMap.OnPolylineClickListener 当一条折线被点击时的回调。

参见 setOnPolylineClickListener(OnPolylineClickListener)

 
interface TencentMap.OnScaleViewChangedListener 当比例尺级别变化时回调接口

参见 setOnScaleViewChangedListener(OnScaleViewChangedListener)

 
interface TencentMap.OnSetBuildingLightListener 设置建筑点亮回调监听  
interface TencentMap.OnTrafficEventClickListener 事件点击回调监听  
interface TencentMap.OnVectorOverlayClickListener  
interface TencentMap.SnapshotReadyCallback 地图截图的回调接口,回调是在主线程中运行的。  
Constants
int MAP_MODE_NAV This constant is deprecated. 从4.1.2弃用，请使用 MAP_TYPE_NAVI
int MAP_MODE_NAV_NIGHT This constant is deprecated. 从4.1.2弃用，请使用 MAP_TYPE_NIGHT
int MAP_MODE_NAV_TRAFFIC This constant is deprecated. 从4.1.2弃用，请使用 MAP_TYPE_TRAFFIC_NAVI
int MAP_MODE_NORMAL This constant is deprecated. 从4.1.2弃用，请使用 MAP_TYPE_NORMAL
int MAP_MODE_NORMAL_TRAFFIC This constant is deprecated. 从4.1.2弃用，请使用 setTrafficEnabled(boolean)
int MAP_TYPE_DARK 暗色模式
int MAP_TYPE_NAVI 导航模式
int MAP_TYPE_NEW_3D_IMMERSIVE 新3D沉浸图
int MAP_TYPE_NIGHT 夜间模式
int MAP_TYPE_NONE 默认的地图类型
int MAP_TYPE_NORMAL 普通地图
int MAP_TYPE_SATELLITE 卫星图
int MAP_TYPE_TRAFFIC_NAVI 导航白天 + 路况样式
用于腾讯导航 sdk
int MAP_TYPE_TRAFFIC_NIGHT 导航夜间 + 路况样式
用于腾讯导航 sdk
Public Methods
abstract void addAgileMarker(AgileMarkerOptions options, TencentMap.AddAgileMarkerCallback callback)
添加百变Marker
abstract AoiLayer addAoiLayer(String poiId, AoiLayerOptions options, AoiLayer.OnAoiLayerLoadListener listener)
添加标注点的区域面
abstract Arc addArc(ArcOptions options)
添加弧线
abstract Circle addCircle(CircleOptions options)
添加圆
abstract CustomLayer addCustomLayer(CustomLayerOptions options)
添加个性化图层
abstract GroundOverlay addGroundOverlay(GroundOverlayOptions options)
添加 GroundOverlay
abstract MaskingLayer addMaskingLayer(MaskingLayerOptions options)
添加蒙层
abstract void addOnMapLoadedCallback(TencentMap.OnMapLoadedCallback onMapLoadedCallback)
设置地图加载完成回调接口
abstract Polygon addPolygon(PolygonOptions options)
添加多边形
abstract List<Polygon> addPolygons(List<PolygonOptions> options)
批量添加简单多边形，不支持描边和带洞的多边形
abstract Polyline addPolyline(PolylineOptions options)
添加线
abstract void addTencentMapGestureListener(TencentMapGestureListener listener)
添加一个腾讯地图手势监听接口
abstract TileOverlay addTileOverlay(TileOverlayOptions options)
添加瓦片图层
abstract VectorHeatOverlay addVectorHeatOverlay(VectorHeatOverlayOptions options)
This method is deprecated. 请使用 addVectorOverlay(VectorOverlayProvider)
abstract <L extends VectorOverlay> L addVectorOverlay(VectorOverlayProvider provider)
添加矢量图层
abstract VisualLayer addVisualLayer(VisualLayerOptions options)
添加可视化数据图层
abstract void animateCamera(CameraUpdate cameraUpdate, long duration, TencentMap.CancelableCallback cancelableCallback)
以动画的方式把地图变换到指定的状态
abstract void animateCamera(CameraUpdate cameraUpdate, TencentMap.CancelableCallback cancelableCallback)
以动画的方式把地图变换到指定的状态
abstract void animateCamera(CameraUpdate cameraUpdate)
把地图变换到指定的状态,带动画
abstract CameraPosition calculateMapOverLook(LatLngBounds bounds, RectF screen, float skew, float rotate, int paddingLeft, int paddingTop, int paddingRight, int paddingBottom)
计算可视范围
abstract CameraPosition calculateZoomToSpanLevel(List<IOverlay> elements, List<LatLng> points, int leftPadding, int rightPadding, int topPadding, int bottomPadding)
计算出要在当前底图可视区域内显示一组元素及一组点的比例尺和中心点（有填边）
目前只有在 bearing == 0 且 tilt == 0 时才能获取到正确的值
abstract void clear()
This method is deprecated. 从4.3.0弃用，建议使用 {clearAllOverlays()}
abstract void clearAllOverlays()
清除地图上所有的标注类（Marker、Polyline、Polygon，TileOverlay除外）
abstract void clearCache()
清理缓存 将自定义瓦片、卫星图、底图等缓存数据进行清理

建议在线程中执行

abstract void enableAutoMaxSkew(boolean enabled)
允许最大俯仰角跟随缩放级别变化，默认关闭
abstract void enableMultipleInfowindow(boolean enable)
设置地图是否允许多InfoWindow模式，默认是false(只允许显示一个InfoWindow) 注意：此方法需要在addMarker之前调用。
abstract String executeVisualLayerCommand(VisualLayer visualLayer, String commandJson)
abstract List<LatLng> getBounderPoints(Marker marker)
获取marker外包点集
abstract CameraPosition getCameraPosition()
获取当前地图的状态（包括中心点、比例尺、旋转角、倾斜角）
abstract String getCityName(LatLng latLng)
获得当前经纬度所在的城市名称
abstract String getDebugError()
获取地图引擎的Debug日志，在出现问题时用于日志分析
abstract Language getLanguage()
地图当前的语言
abstract <T extends TencentMapComponent.Component> T getMapComponent(Class<T> t)
获取地图组件
abstract TencentMapContext getMapContext()
获取地图上下文
abstract int getMapHeight()
获取 mapview 高度
abstract Rect getMapPadding()
获取底图相对上、下、左、右的边距
abstract int getMapStyle()
获取当前地图的样式
abstract int getMapType()
获取地图类型
abstract int getMapWidth()
获取 mapview 宽度
abstract int getMarkerCollisionMaxRetainCount()
获取当前设置的碰撞检测后最大保留 Marker 数量。
abstract float getMaxZoomLevel()
获取地图最大的支持的缩放级别
abstract float getMinZoomLevel()
获取地图最小的支持的缩放级别
abstract Projection getProjection()
获取坐标转换操作对象
abstract List<Marker> getScreenMarkers()
获取屏幕范围内的全部标注(Marker)@param
abstract long getTencentMapHandle()
获得地图句柄
abstract TrafficStyle getTrafficStyle()
获取路况样式
abstract UiSettings getUiSettings()
获取地图界面操作对象
abstract String getVersion()
获取当前地图SDK的版本号
abstract VisualSettings getVisualSettings()
获取可视化图层配置对象
abstract float getZoomToSpanLevel(LatLng leftUpper, LatLng rightDown)
根据两个经纬度指定一个范围，计算出当前屏幕如果要显示这个指定范围所要的缩放级别（需要等地图加载完成再调用）
abstract boolean isBlockRouteEnabled()
This method is deprecated. 从4.3.5起，此功能废弃
abstract boolean isDestroyed()
判断当前这个地图是不是已经被销毁了
abstract boolean isHandDrawMapEnable()
当前手绘图是否处于开启状态
abstract boolean isSateLiteEnable()
返回卫星图状态
abstract boolean isTrafficEnabled()
获取地图当前是否开启实时交通路况
abstract void loadKMLFile(String filePath)
加载 KML 文件
abstract void moveCamera(CameraUpdate cameraUpdate)
把地图变换到指定的状态
abstract void removeOnMapLoadedCallback(TencentMap.OnMapLoadedCallback onMapLoadedCallback)
设置地图加载完成回调接口
abstract void removeTencentMapGestureListener(TencentMapGestureListener listener)
移除一个腾讯地图手势监听接口
abstract void setBaseMapEnabled(boolean enabled)
底图展示开关。如果期望控制 poi 的展示，参见 setPoisEnabled(boolean)
abstract void setBlockRouteEnabled(boolean enable)
This method is deprecated. 从4.3.5起，此功能废弃
abstract void setBuilding3dEffectEnable(boolean enableEffect)
设置是否显示3D建筑
abstract void setBuildingBlackList(List<LatLngBounds> latLngBounds)
设置区域内3D建筑物拍平
abstract void setBuildingEnable(boolean use3DStyle)
This method is deprecated. use setBuilding3dEffectEnable(boolean) instead
abstract void setBuildingLight(BuildingLightInfo buildingLightInfo, TencentMap.OnSetBuildingLightListener listener)
指定屏幕中的地理位置点亮3D建筑物
abstract void setCameraCenterProportion(float x, float y)
设置camera变换的中心点并将变换中心点设置为地图当前的中心点
abstract void setCameraCenterProportion(float x, float y, boolean moveMap)
设置camera变换的中心点
abstract void setCustomRender(CustomRender render)
设置基于gles2.0的渲染器 该方法可以在地图上添加自定义的3D模型
abstract void setDrawPillarWith2DStyle(boolean use2DStyle)
This method is deprecated. 从4.2.4弃用，建议使用 setBuildingEnable(boolean) 替代
abstract void setForeignLanguage(Language foreignLanguage)
设置海外图优先显示的语言，默认优先显示中文（在创建地图时设置，不支持动态切换）
abstract void setHandDrawMapEnable(boolean enable)
设置是否开启手绘图
abstract void setInfoWindowAdapter(TencentMap.InfoWindowAdapter infoWindowAdapter)
设置气泡样式接口
abstract void setLanguage(Language language)
设置底图语言，默认为中文简体
abstract void setLocationCompassHidden(boolean hidden)
设置隐藏定位罗盘
abstract void setLocationNavigationGravityLineHidden(boolean hidden)
设置隐藏导航引导线
abstract void setMapCenterAndScale(float centerX, float centerY, float targetScale)
设置底图中心点及scale， 屏幕左上角为 (0.0f, 0.0f), 右下角（1.0f, 1.0f)
abstract void setMapFontSize(MapFontSize fontSize)
设置地图文字大小
abstract void setMapFrameRate(float frameRate)
设置地图刷新帧率
abstract void setMapStyle(int styleType)
设置当前地图的样式
根据自己在腾讯地图样式配置平台配置的样式对应的样式序号, 目前开放给用户自定义样式的值为 1 ~ 3 之间的整数
只有在 MAP_TYPE_NORMAL 时，才修改地图样式
abstract void setMapType(int mapType)
设置地图类型
abstract void setMarkerCollisionMaxRetainCount(int maxRetainCount)
设置碰撞检测后最大保留 Marker 数量。

碰撞检测完成后，系统会按优先级（zIndex 降序）保留前 maxRetainCount 个 Marker， 超出数量的 Marker 将被隐藏并触发 onCollisionHidden(Marker, List) 回调。

仅作用于参与碰撞检测的 Marker（即设置了 collisionBy 属性的 Marker）， 未参与碰撞检测的 Marker 不受此限制。

abstract void setMaxZoomLevel(int zoomLevel)
设置地图的最大缩放级别
abstract void setMinZoomLevel(int zoomLevel)
设置地图的最小缩放级别
abstract void setMyLocationStyle(MyLocationStyle myLocationStyle)
This method is deprecated. 请使用 setMyLocationConfig(MyLocationConfig)
abstract void setOnAgileMarkerClickListener(TencentMap.OnAgileMarkerClickListener listener)
设置百变Marker点击事件的监听接口
abstract void setOnCameraChangeFullyListener(TencentMap.OnCameraChangeFullyListener onCameraChangeFullyListener)
设置地图全程变换的监听接口
abstract void setOnCameraChangeListener(TencentMap.OnCameraChangeListener onCameraChangeListener)
设置地图变换的监听接口
abstract void setOnCameraRestrictListener(TencentMap.OnCameraRestrictListener listener)
设置相机移动到限制区域边缘回调接口
abstract void setOnCompassClickedListener(TencentMap.OnCompassClickedListener onCompassClickedListener)
设置罗盘位按钮监听接口
abstract void setOnInfoWindowClickListener(TencentMap.OnInfoWindowClickListener listener)
设置Marker气泡点击事件监听接口
abstract void setOnMapClickListener(TencentMap.OnMapClickListener onMapClickListener)
设置地图点击事件的监听接口
abstract void setOnMapFirstFrameCallback(TencentMap.OnMapFirstFrameCallback onMapFirstFrameCallback)
设置地图首个渲染帧回调
abstract void setOnMapFrameFinished(TencentMap.OnMapFrameFinishCallback onMapFrameFinished)
This method is deprecated. 设置地图渲染帧回调接口建议使用 setOnMapFirstFrameCallback(OnMapFirstFrameCallback)
abstract void setOnMapLoadedCallback(TencentMap.OnMapLoadedCallback onMapLoadedCallback)
This method is deprecated. 添加监听建议使用 addOnMapLoadedCallback(OnMapLoadedCallback)

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

abstract void setOnMapLongClickListener(TencentMap.OnMapLongClickListener onMapLongClickListener)
设置地图长按事件的监听接口
abstract void setOnMapPoiClickListener(TencentMap.OnMapPoiClickListener listener)
设置地图标注点点击回调
abstract void setOnMarkerClickListener(TencentMap.OnMarkerClickListener listener)
设置Marker点击事件的监听接口
abstract void setOnMarkerCollisionStatusListener(TencentMap.OnMarkerCollisionStatusListener listener)
设置Marker触发碰撞时的状态回调接口
abstract void setOnMarkerDragListener(TencentMap.OnMarkerDragListener listener)
设置Marker拖动事件的监听接口
abstract void setOnPolygonClickListener(TencentMap.OnPolygonClickListener onPolygonClickListener)
设置多边形被点击时的回调接口
abstract void setOnPolylineClickListener(TencentMap.OnPolylineClickListener onPolylineClickListener)
设置线被点击时的回调接口
abstract void setOnScaleViewChangedListener(TencentMap.OnScaleViewChangedListener onScaleViewChangedListener)
设置比例尺级别变化的监听接口
abstract void setOnTapMapViewInfoWindowHidden(boolean enable)
点击地图其他区域时，InfoWindow是否需要隐藏
abstract void setOnTrafficEventClickListener(TencentMap.OnTrafficEventClickListener listener)
事件点击回调
abstract void setOnVectorOverlayClickListener(TencentMap.OnVectorOverlayClickListener listener)
设置地图可视化图层点击回调
abstract void setOverSeaEnable(boolean enable)
是否开启海外图 如果鉴权不允许，则此开关设置无效
abstract void setOverSeaTileProvider(OverSeaTileProvider provider)
设置海外图图源提供
abstract void setPadding(int left, int top, int right, int bottom, boolean moveCenter)
设置底图相对上、下、左、右的边距，并移动地图中心点
abstract void setPadding(int left, int top, int right, int bottom)
设置底图相对上、下、左、右的边距
abstract void setPointToCenter(int x, int y)
设置屏幕上的某个像素点为中心
abstract void setPoisEnabled(boolean enabled)
底图 poi 开关
abstract void setRestrictBounds(LatLngBounds restrictBounds, RestrictBoundsFitMode fitMode)
限制地图的显示范围。此接口同时会限制地图的最小缩放级别，用户还可以通过 setMinZoomLevel(int) 修改自己需要的最小缩放级别获取需要的展示效果
abstract void setSatelliteEnabled(boolean enable)
开启或关闭实时卫星视图的功能 注： 1、开启卫星图状态下,用户调用setMapStyle(int) / setMapType(int)切换样式将不生效 2、关闭卫星图，则恢复到开启卫星图之前设置的样式
abstract void setSceneByTag(String tag)
abstract void setTencentMapGestureListener(TencentMapGestureListener listener)
This method is deprecated. 弃用，建议使用{addTencentMapGestureListener(TencentMapGestureListener)}
abstract void setTrafficEnabled(boolean enable)
开启或关闭实时交通路况的功能
abstract void setTrafficMode(int mode, int zoomLevel)
设置路况状态模式
abstract void setTrafficStyle(TrafficStyle trafficStyle)
设置路况样式
abstract void showBuilding(boolean shown)
是否展示建筑物，不同于 setBuilding3dEffectEnable(boolean),这个接口用于控制建筑物是否能够展示，默认 true
abstract void snapshot(TencentMap.SnapshotReadyCallback callback, Bitmap.Config config, int timeOut)
获取地图当前截图
如果调用了 animateCamera 接口，请在 CameraChangeFinished 回调后再进行截图
abstract void snapshot(TencentMap.SnapshotReadyCallback callback)
获取地图当前截图
如果调用了 animateCamera 接口，请在 CameraChangeFinished 回调后再进行截图
abstract void snapshot(TencentMap.SnapshotReadyCallback callback, Bitmap.Config config)
获取地图当前截图
如果调用了 animateCamera 接口，请在 CameraChangeFinished 回调后再进行截图
abstract void stopAnimation()
停止地图所有正在进行的动画
abstract void updateVectorOverlay(VectorOverlay overlay, VectorOverlayProvider provider)
更新矢量图层
[Expand]
Inherited Methods
From interface com.tencent.map.sdk.comps.indoor.IIndoor
From interface com.tencent.map.sdk.comps.mylocation.IMyLocation

Constants

public static final int MAP_MODE_NAV

This constant is deprecated.
从4.1.2弃用，请使用 MAP_TYPE_NAVI

Constant Value: 12 (0x0000000c)

public static final int MAP_MODE_NAV_NIGHT

This constant is deprecated.
从4.1.2弃用，请使用 MAP_TYPE_NIGHT

Constant Value: 1013 (0x000003f5)

public static final int MAP_MODE_NAV_TRAFFIC

This constant is deprecated.
从4.1.2弃用，请使用 MAP_TYPE_TRAFFIC_NAVI

Constant Value: 1009 (0x000003f1)

public static final int MAP_MODE_NORMAL

This constant is deprecated.
从4.1.2弃用，请使用 MAP_TYPE_NORMAL

Constant Value: 0 (0x00000000)

public static final int MAP_MODE_NORMAL_TRAFFIC

This constant is deprecated.
从4.1.2弃用，请使用 setTrafficEnabled(boolean)

Constant Value: 5 (0x00000005)

public static final int MAP_TYPE_DARK

暗色模式

Constant Value: 1008 (0x000003f0)

public static final int MAP_TYPE_NAVI

导航模式

Constant Value: 1012 (0x000003f4)

public static final int MAP_TYPE_NEW_3D_IMMERSIVE

新3D沉浸图

Constant Value: 1016 (0x000003f8)

public static final int MAP_TYPE_NIGHT

夜间模式

Constant Value: 1013 (0x000003f5)

public static final int MAP_TYPE_NONE

默认的地图类型

Constant Value: 0 (0x00000000)

public static final int MAP_TYPE_NORMAL

普通地图

Constant Value: 1000 (0x000003e8)

public static final int MAP_TYPE_SATELLITE

卫星图

Constant Value: 1011 (0x000003f3)

public static final int MAP_TYPE_TRAFFIC_NAVI

导航白天 + 路况样式
用于腾讯导航 sdk

Constant Value: 1009 (0x000003f1)

public static final int MAP_TYPE_TRAFFIC_NIGHT

导航夜间 + 路况样式
用于腾讯导航 sdk

Constant Value: 1010 (0x000003f2)

Public Methods

public abstract void addAgileMarker (AgileMarkerOptions options, TencentMap.AddAgileMarkerCallback callback)

添加百变Marker

Parameters
options 百变Marker属性,参见AgileMarkerOptions
callback 添加结果回调,参见TencentMap.AddAgileMarkerCallback

public abstract AoiLayer addAoiLayer (String poiId, AoiLayerOptions options, AoiLayer.OnAoiLayerLoadListener listener)

添加标注点的区域面

Parameters
poiId 标注点ID
options 区域面配置项
listener 加载回调，返回添加的结果和区域面对象
Returns
  • 区域面对象

public abstract Arc addArc (ArcOptions options)

添加弧线

Parameters
options 弧属性, 参见ArcOptions

public abstract Circle addCircle (CircleOptions options)

添加圆

Parameters
options 折线的参数,参见CircleOptions
Returns
  • 新创建的圆

public abstract CustomLayer addCustomLayer (CustomLayerOptions options)

添加个性化图层

Parameters
options 图层选项
Returns
  • 新创建的图层

public abstract GroundOverlay addGroundOverlay (GroundOverlayOptions options)

添加 GroundOverlay

public abstract MaskingLayer addMaskingLayer (MaskingLayerOptions options)

添加蒙层

public abstract void addOnMapLoadedCallback (TencentMap.OnMapLoadedCallback onMapLoadedCallback)

设置地图加载完成回调接口

Parameters
onMapLoadedCallback 参见TencentMap.OnMapLoadedCallback

public abstract Polygon addPolygon (PolygonOptions options)

添加多边形

Parameters
options 多边形属性,参见PolygonOptions
Returns
  • 新创建的多边形

public abstract List<Polygon> addPolygons (List<PolygonOptions> options)

批量添加简单多边形，不支持描边和带洞的多边形

Parameters
options 多边形属性,参见PolygonOptions
Returns
  • 新创建的简单多边形

public abstract Polyline addPolyline (PolylineOptions options)

添加线

Parameters
options 线属性,参见PolylineOptions
Returns
  • 新创建的线

public abstract void addTencentMapGestureListener (TencentMapGestureListener listener)

添加一个腾讯地图手势监听接口

Parameters
listener 参见TencentMapGestureListener

public abstract TileOverlay addTileOverlay (TileOverlayOptions options)

添加瓦片图层

Parameters
options 瓦片选项
Returns
  • 新创建的瓦片图层

public abstract VectorHeatOverlay addVectorHeatOverlay (VectorHeatOverlayOptions options)

This method is deprecated.
请使用 addVectorOverlay(VectorOverlayProvider)

添加矢量热力图图层

public abstract L addVectorOverlay (VectorOverlayProvider provider)

添加矢量图层

Returns
  • 矢量图层

public abstract VisualLayer addVisualLayer (VisualLayerOptions options)

添加可视化数据图层

Parameters
options 数据图层选项
Returns
  • 可视化数据图层对象

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

以动画的方式把地图变换到指定的状态

Parameters
cameraUpdate 状态对象 参见CameraUpdate
duration 动画执行时间（单位：ms）
cancelableCallback 动画状态监听器TencentMap.CancelableCallback

public abstract void animateCamera (CameraUpdate cameraUpdate, TencentMap.CancelableCallback cancelableCallback)

以动画的方式把地图变换到指定的状态

Parameters
cameraUpdate 状态对象 参见CameraUpdate
cancelableCallback 动画状态监听器TencentMap.CancelableCallback

public abstract void animateCamera (CameraUpdate cameraUpdate)

把地图变换到指定的状态,带动画

Parameters
cameraUpdate 状态对象 参见CameraUpdate

public abstract CameraPosition calculateMapOverLook (LatLngBounds bounds, RectF screen, float skew, float rotate, int paddingLeft, int paddingTop, int paddingRight, int paddingBottom)

计算可视范围

Parameters
bounds 地理位置范围
screen 屏幕范围
skew 俯仰角
rotate 旋转角
paddingLeft padding
Returns
  • Camera参数

public abstract CameraPosition calculateZoomToSpanLevel (List<IOverlay> elements, List<LatLng> points, int leftPadding, int rightPadding, int topPadding, int bottomPadding)

计算出要在当前底图可视区域内显示一组元素及一组点的比例尺和中心点（有填边）
目前只有在 bearing == 0 且 tilt == 0 时才能获取到正确的值

Parameters
elements 要显示在底图上的元素
points 要显示在底图上的点
leftPadding 要显示的元素和点距离底图左边的边距(必须为正数）
rightPadding 要显示的元素和点距离底图右边的边距(必须为正数）
topPadding 要显示的元素和点距离底图上边的边距(必须为正数）
bottomPadding 要显示的元素和点距离底图下边的边距(必须为正数）
Returns
  • 显示一组元素和一组点的摄像机位置（底图的旋转角和俯仰角保持不变）（如果发生错误 则比例尺返回@link com.tencent.map.lib.ErrorCode中定义的错误代码）

public abstract void clear ()

This method is deprecated.
从4.3.0弃用，建议使用 {clearAllOverlays()}

public abstract void clearAllOverlays ()

清除地图上所有的标注类（Marker、Polyline、Polygon，TileOverlay除外）

public abstract void clearCache ()

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

建议在线程中执行

public abstract void enableAutoMaxSkew (boolean enabled)

允许最大俯仰角跟随缩放级别变化，默认关闭

public abstract void enableMultipleInfowindow (boolean enable)

设置地图是否允许多InfoWindow模式，默认是false(只允许显示一个InfoWindow) 注意：此方法需要在addMarker之前调用。

Parameters
enable 是否开启多窗口InfoWindow

public abstract String executeVisualLayerCommand (VisualLayer visualLayer, String commandJson)

public abstract List<LatLng> getBounderPoints (Marker marker)

获取marker外包点集

Returns
  • 外包点集

public abstract CameraPosition getCameraPosition ()

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

Returns

public abstract String getCityName (LatLng latLng)

获得当前经纬度所在的城市名称

Parameters
latLng 经纬度
Returns
  • 城市的名称

public abstract String getDebugError ()

获取地图引擎的Debug日志，在出现问题时用于日志分析

Returns
  • 错误信息

public abstract Language getLanguage ()

地图当前的语言

public abstract T getMapComponent (Class<T> t)

获取地图组件

Parameters
t 组件类
Returns
  • 组件对象

public abstract TencentMapContext getMapContext ()

获取地图上下文

Returns
  • 地图上下文

public abstract int getMapHeight ()

获取 mapview 高度

Returns
  • 高度

public abstract Rect getMapPadding ()

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

Returns
  • 左、上、右、下

public abstract int getMapStyle ()

获取当前地图的样式

Returns
  • 当前地图样式

public abstract int getMapType ()

获取地图类型

public abstract int getMapWidth ()

获取 mapview 宽度

Returns
  • 宽度

public abstract int getMarkerCollisionMaxRetainCount ()

获取当前设置的碰撞检测后最大保留 Marker 数量。

Returns
  • 当前最大保留数量，默认为 -1（不限制），0 表示全隐藏

public abstract float getMaxZoomLevel ()

获取地图最大的支持的缩放级别

Returns
  • 最大的缩放级别，默认是 20.0

public abstract float getMinZoomLevel ()

获取地图最小的支持的缩放级别

Returns
  • 最上的缩放级别，默认是 3.0

public abstract Projection getProjection ()

获取坐标转换操作对象

Returns
  • 当前地图的坐标转换对象 参见Projection

public abstract List<Marker> getScreenMarkers ()

获取屏幕范围内的全部标注(Marker)@param

Returns
  • 屏幕内的全部标注

public abstract long getTencentMapHandle ()

获得地图句柄

Returns
  • 句柄

public abstract TrafficStyle getTrafficStyle ()

获取路况样式

Returns
  • 路况样式

public abstract UiSettings getUiSettings ()

获取地图界面操作对象

Returns

public abstract String getVersion ()

获取当前地图SDK的版本号

Returns
  • 地图版本号

public abstract VisualSettings getVisualSettings ()

获取可视化图层配置对象

Returns

public abstract float getZoomToSpanLevel (LatLng leftUpper, LatLng rightDown)

根据两个经纬度指定一个范围，计算出当前屏幕如果要显示这个指定范围所要的缩放级别（需要等地图加载完成再调用）

Parameters
leftUpper 左上角要显示的经纬度
rightDown 右下角要显示的经纬度
Returns
  • 缩放级别

public abstract boolean isBlockRouteEnabled ()

This method is deprecated.
从4.3.5起，此功能废弃

获取是否封闭路段展示

Returns
  • true 展示封路；false 不展示封路

public abstract boolean isDestroyed ()

判断当前这个地图是不是已经被销毁了

Returns
  • 地图是否已经被销毁：true 被销毁 false 未销毁

public abstract boolean isHandDrawMapEnable ()

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

Returns
  • 是否开启手绘图

public abstract boolean isSateLiteEnable ()

返回卫星图状态

Returns
  • 是否开启卫星图

public abstract boolean isTrafficEnabled ()

获取地图当前是否开启实时交通路况

Returns
  • 是否开启：true 开启 false 关闭

public abstract void loadKMLFile (String filePath)

加载 KML 文件

Parameters
filePath KML 文件路径

public abstract void moveCamera (CameraUpdate cameraUpdate)

把地图变换到指定的状态

Parameters
cameraUpdate 状态对象 参见CameraUpdate

public abstract void removeOnMapLoadedCallback (TencentMap.OnMapLoadedCallback onMapLoadedCallback)

设置地图加载完成回调接口

Parameters
onMapLoadedCallback 参见TencentMap.OnMapLoadedCallback

public abstract void removeTencentMapGestureListener (TencentMapGestureListener listener)

移除一个腾讯地图手势监听接口

Parameters
listener 参见TencentMapGestureListener

public abstract void setBaseMapEnabled (boolean enabled)

底图展示开关。如果期望控制 poi 的展示，参见 setPoisEnabled(boolean)

Parameters
enabled true，展示底图；false，关闭底图

public abstract void setBlockRouteEnabled (boolean enable)

This method is deprecated.
从4.3.5起，此功能废弃

设置是否展示封闭路段

Parameters
enable true 展示封路；false 不展示封路

public abstract void setBuilding3dEffectEnable (boolean enableEffect)

设置是否显示3D建筑

Parameters
enableEffect 是否使用3D的模式绘制楼块，默认是true

public abstract void setBuildingBlackList (List<LatLngBounds> latLngBounds)

设置区域内3D建筑物拍平

public abstract void setBuildingEnable (boolean use3DStyle)

This method is deprecated.
use setBuilding3dEffectEnable(boolean) instead

设置是否显示3D建筑

Parameters
use3DStyle 是否使用3D的模式绘制楼快，默认是true

public abstract void setBuildingLight (BuildingLightInfo buildingLightInfo, TencentMap.OnSetBuildingLightListener listener)

指定屏幕中的地理位置点亮3D建筑物

Parameters
buildingLightInfo 建筑物灯光信息,传入null则取消点亮
listener 回调监听器

public abstract void setCameraCenterProportion (float x, float y)

设置camera变换的中心点并将变换中心点设置为地图当前的中心点

Parameters
x 变换中心点在 mapView 水平方向的百分比 [0, 1]
y 变换中心点在 mapView 垂直方向的百分比 [0, 1]

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

设置camera变换的中心点

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

public abstract void setCustomRender (CustomRender render)

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

Parameters
render gl渲染器

public abstract void setDrawPillarWith2DStyle (boolean use2DStyle)

This method is deprecated.
从4.2.4弃用，建议使用 setBuildingEnable(boolean) 替代

设置楼块绘制2d, 3d模式，此接口只会影响地图3D态时（地图倾斜角或旋转角不为0）的楼块显示情况，地图2D状态下（地图倾斜角和旋转角都为0）不显示楼块 1、use2DStyle为true时,在地图3D态时,不显示楼块 2、use2DStyle为false时, 在地图3D态时,会显示楼块

Parameters
use2DStyle 是否使用2D模式绘制楼快

public abstract void setForeignLanguage (Language foreignLanguage)

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

Parameters
foreignLanguage 海外图语言

public abstract void setHandDrawMapEnable (boolean enable)

设置是否开启手绘图

Parameters
enable true 开启手绘图

public abstract void setInfoWindowAdapter (TencentMap.InfoWindowAdapter infoWindowAdapter)

设置气泡样式接口

Parameters
infoWindowAdapter 参见 TencentMap.InfoWindowAdapter

public abstract void setLanguage (Language language)

设置底图语言，默认为中文简体

Parameters
language 语言

public abstract void setLocationCompassHidden (boolean hidden)

设置隐藏定位罗盘

Parameters
hidden 默认为true

public abstract void setLocationNavigationGravityLineHidden (boolean hidden)

设置隐藏导航引导线

Parameters
hidden 默认为true

public abstract 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

public abstract void setMapFontSize (MapFontSize fontSize)

设置地图文字大小

Parameters
fontSize 文字大小,支持5种尺寸

public abstract void setMapFrameRate (float frameRate)

设置地图刷新帧率

Parameters
frameRate 刷新帧率，建议设置30-60帧内效果最好，有效取值范围(0,)

public abstract void setMapStyle (int styleType)

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

Parameters
styleType 地图样式

public abstract void setMapType (int mapType)

设置地图类型

Parameters
mapType 仅限设置为：MAP_TYPE_NORMAL、 MAP_TYPE_DARK、 MAP_TYPE_SATELLITE、 MAP_TYPE_NEW_3D_IMMERSIVE、

public abstract void setMarkerCollisionMaxRetainCount (int maxRetainCount)

设置碰撞检测后最大保留 Marker 数量。

碰撞检测完成后，系统会按优先级（zIndex 降序）保留前 maxRetainCount 个 Marker， 超出数量的 Marker 将被隐藏并触发 onCollisionHidden(Marker, List) 回调。

仅作用于参与碰撞检测的 Marker（即设置了 collisionBy 属性的 Marker）， 未参与碰撞检测的 Marker 不受此限制。

Parameters
maxRetainCount 最大保留数量。-1 表示不限制（默认值），0 表示全隐藏， 正整数表示最多保留该数量，小于 -1 的负数静默处理为 -1。

public abstract void setMaxZoomLevel (int zoomLevel)

设置地图的最大缩放级别

Parameters
zoomLevel 缩放级别[3~22]

public abstract void setMinZoomLevel (int zoomLevel)

设置地图的最小缩放级别

Parameters
zoomLevel 缩放级别[3~22]

public abstract void setMyLocationStyle (MyLocationStyle myLocationStyle)

This method is deprecated.
请使用 setMyLocationConfig(MyLocationConfig)

设置定位的样式

Parameters
myLocationStyle MyLocationStyle

public abstract void setOnAgileMarkerClickListener (TencentMap.OnAgileMarkerClickListener listener)

设置百变Marker点击事件的监听接口

Parameters
listener 参见 TencentMap.OnAgileMarkerClickListener

public abstract void setOnCameraChangeFullyListener (TencentMap.OnCameraChangeFullyListener onCameraChangeFullyListener)

设置地图全程变换的监听接口

Parameters
onCameraChangeFullyListener 参见TencentMap.OnCameraChangeFullyListener

public abstract void setOnCameraChangeListener (TencentMap.OnCameraChangeListener onCameraChangeListener)

设置地图变换的监听接口

Parameters
onCameraChangeListener 参见TencentMap.OnCameraChangeListener

public abstract void setOnCameraRestrictListener (TencentMap.OnCameraRestrictListener listener)

设置相机移动到限制区域边缘回调接口

Parameters
listener 监听器

public abstract void setOnCompassClickedListener (TencentMap.OnCompassClickedListener onCompassClickedListener)

设置罗盘位按钮监听接口

Parameters
onCompassClickedListener 参见TencentMap.OnCompassClickedListener

public abstract void setOnInfoWindowClickListener (TencentMap.OnInfoWindowClickListener listener)

设置Marker气泡点击事件监听接口

Parameters
listener 参见 TencentMap.OnInfoWindowClickListener

public abstract void setOnMapClickListener (TencentMap.OnMapClickListener onMapClickListener)

设置地图点击事件的监听接口

Parameters
onMapClickListener 参见TencentMap.OnMapClickListener

public abstract void setOnMapFirstFrameCallback (TencentMap.OnMapFirstFrameCallback onMapFirstFrameCallback)

设置地图首个渲染帧回调

public abstract void setOnMapFrameFinished (TencentMap.OnMapFrameFinishCallback onMapFrameFinished)

This method is deprecated.
设置地图渲染帧回调接口建议使用 setOnMapFirstFrameCallback(OnMapFirstFrameCallback)

设置地图渲染帧回调

public abstract void setOnMapLoadedCallback (TencentMap.OnMapLoadedCallback onMapLoadedCallback)

This method is deprecated.
添加监听建议使用 addOnMapLoadedCallback(OnMapLoadedCallback)

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

设置地图加载完成回调接口

Parameters
onMapLoadedCallback 参见TencentMap.OnMapLoadedCallback

public abstract void setOnMapLongClickListener (TencentMap.OnMapLongClickListener onMapLongClickListener)

设置地图长按事件的监听接口

Parameters
onMapLongClickListener 参见TencentMap.OnMapLongClickListener

public abstract void setOnMapPoiClickListener (TencentMap.OnMapPoiClickListener listener)

设置地图标注点点击回调

Parameters
listener 参见TencentMap.OnMapPoiClickListener

public abstract void setOnMarkerClickListener (TencentMap.OnMarkerClickListener listener)

设置Marker点击事件的监听接口

Parameters
listener 参见 TencentMap.OnMarkerClickListener

public abstract void setOnMarkerCollisionStatusListener (TencentMap.OnMarkerCollisionStatusListener listener)

设置Marker触发碰撞时的状态回调接口

Parameters
listener 参见 TencentMap.OnMarkerCollisionStatusListener

public abstract void setOnMarkerDragListener (TencentMap.OnMarkerDragListener listener)

设置Marker拖动事件的监听接口

Parameters
listener 参见 TencentMap.OnMarkerDragListener

public abstract void setOnPolygonClickListener (TencentMap.OnPolygonClickListener onPolygonClickListener)

设置多边形被点击时的回调接口

Parameters
onPolygonClickListener 参见TencentMap.OnPolygonClickListener

public abstract void setOnPolylineClickListener (TencentMap.OnPolylineClickListener onPolylineClickListener)

设置线被点击时的回调接口

Parameters
onPolylineClickListener 参见TencentMap.OnPolylineClickListener

public abstract void setOnScaleViewChangedListener (TencentMap.OnScaleViewChangedListener onScaleViewChangedListener)

设置比例尺级别变化的监听接口

Parameters
onScaleViewChangedListener 参见 TencentMap.OnScaleViewChangedListener

public abstract void setOnTapMapViewInfoWindowHidden (boolean enable)

点击地图其他区域时，InfoWindow是否需要隐藏

Parameters
enable 隐藏开关

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

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

public abstract void setOnTrafficEventClickListener (TencentMap.OnTrafficEventClickListener listener)

事件点击回调

public abstract void setOnVectorOverlayClickListener (TencentMap.OnVectorOverlayClickListener listener)

设置地图可视化图层点击回调

Parameters
listener 参见TencentMap.OnVectorOverlayClickListener

public abstract void setOverSeaEnable (boolean enable)

是否开启海外图 如果鉴权不允许，则此开关设置无效

Parameters
enable true-开启，false-关闭，默认true

public abstract void setOverSeaTileProvider (OverSeaTileProvider provider)

设置海外图图源提供

Parameters
provider 海外图图源提供

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

设置底图相对上、下、左、右的边距，并移动地图中心点

Parameters
left 左边距
top 上边距
right 右边距
bottom 下边距

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

设置底图相对上、下、左、右的边距

Parameters
left 左边距
top 上边距
right 右边距
bottom 下边距

public abstract void setPointToCenter (int x, int y)

设置屏幕上的某个像素点为中心

Parameters
x X像素坐标
y Y像素坐标

public abstract void setPoisEnabled (boolean enabled)

底图 poi 开关

Parameters
enabled 是否开启POI

public abstract void setRestrictBounds (LatLngBounds restrictBounds, RestrictBoundsFitMode fitMode)

限制地图的显示范围。此接口同时会限制地图的最小缩放级别，用户还可以通过 setMinZoomLevel(int) 修改自己需要的最小缩放级别获取需要的展示效果

Parameters
restrictBounds 地图显示范围将要限制到的区域，如果要取消限制，需要传入一个宽度、高度都为0的区域，比如 new LatLngBounds(new LatLng(0, 0), new LatLng(0, 0))
fitMode 显示范围适配模式, FIT_WIDTH 或者 FIT_HEIGHT

public abstract void setSatelliteEnabled (boolean enable)

开启或关闭实时卫星视图的功能 注： 1、开启卫星图状态下,用户调用setMapStyle(int) / setMapType(int)切换样式将不生效 2、关闭卫星图，则恢复到开启卫星图之前设置的样式

Parameters
enable 是否开启：true 开启 false 关闭

public abstract void setSceneByTag (String tag)

public abstract void setTencentMapGestureListener (TencentMapGestureListener listener)

This method is deprecated.
弃用，建议使用{addTencentMapGestureListener(TencentMapGestureListener)}

public abstract void setTrafficEnabled (boolean enable)

开启或关闭实时交通路况的功能

Parameters
enable 是否开启：true 开启 false 关闭

public abstract void setTrafficMode (int mode, int zoomLevel)

设置路况状态模式

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

public abstract void setTrafficStyle (TrafficStyle trafficStyle)

设置路况样式

Parameters
trafficStyle 路况样式

public abstract void showBuilding (boolean shown)

是否展示建筑物，不同于 setBuilding3dEffectEnable(boolean),这个接口用于控制建筑物是否能够展示，默认 true

Parameters
shown 是否可以展示建筑物， true：展示建筑物；false:不展示

public abstract void snapshot (TencentMap.SnapshotReadyCallback callback, Bitmap.Config config, int timeOut)

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

Parameters
callback 截图回调
config 截图配置
timeOut 超时时间，单位 ms, 当到达设置的超时时间时(这个超时时间并不精确，可能会有不超过 100ms 的延迟)， 无论地图是否完成渲染，都会返回截图，当设置的值小于等于 0 时，忽略这个值，地图渲染完成才进行截图

public abstract void snapshot (TencentMap.SnapshotReadyCallback callback)

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

Parameters
callback 截图回调

public abstract void snapshot (TencentMap.SnapshotReadyCallback callback, Bitmap.Config config)

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

Parameters
callback 截图回调
config 截图配置

public abstract void stopAnimation ()

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

public abstract void updateVectorOverlay (VectorOverlay overlay, VectorOverlayProvider provider)

更新矢量图层