Marker (shell-vector-api API)

All Superinterfaces:: IOverlay

public interface Marker
extends IOverlay

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method and Description
`float`	`getAlpha()` 获取标注的透明度
`float`	`getAnchorU()` 获取沿x轴的锚点
`float`	`getAnchorV()` 获取沿y轴的锚点
`java.lang.String`	`getContentDescription()` 获取此Marker的无障碍相关的描述信息
`int`	`getDisplayLevel()` Deprecated. 废弃，请使用`getLevel()`
`int`	`getHeight(Context ctx)` 获取marker纹理高度
`java.lang.String`	`getId()` 获取这个标注的id编号
`int`	`getLevel()` 获取Marker显示层级，详见 `OverlayLevel`
`TencentMap.OnMarkerDragListener`	`getOnDragListener()` Deprecated. 废弃，请使用`TencentMap.setOnMarkerDragListener(TencentMap.OnMarkerDragListener)`
`MarkerOptions`	`getOptions()` 获取该marker对应的配置
`LatLng`	`getPosition()` 获取标注的位置
`float`	`getRotation()` 获得标注的旋转角度
`java.lang.String`	`getSnippet()` 获取标注的InfoWindow(气泡)的内容
`java.lang.Object`	`getTag()` 获取tag
`java.lang.String`	`getTitle()` 获得标注的InfoWindow(气泡)的标题
`int`	`getWidth(Context ctx)` 获取marker纹理宽度
`float`	`getZIndex()` 获取标注的层级关系
`void`	`hideInfoWindow()` 让标注隐藏InfoWindow(气泡)
`boolean`	`isClickable()` 获取标注是否可以响应点击事件
`boolean`	`isDraggable()` 获取标注是否可以被拖动
`boolean`	`isFastLoad()` 当前 marker 是否已打开快速加载
`boolean`	`isInfoWindowAutoOverturn()` Deprecated. 废弃，暂不支持
`boolean`	`isInfoWindowEnable()` 获取标注的InfoWindow是否可以弹出气泡
`boolean`	`isInfoWindowShown()` 获取让标注InfoWindow(气泡)是否正在显示
`boolean`	`isInMapCenterState()` Deprecated. 废弃
`boolean`	`isVisible()` 获得标注是否可见
`boolean`	`onTapMapViewBubbleHidden()` Deprecated. 废弃
`void`	`refreshInfoWindow()` 更新infowindow
`void`	`remove()` 将这个标注从地图上移除
`void`	`setAlpha(float alpha)` 设置Marker的透明度。[0.0-1.0]
`void`	`setAnchor(float anchorU, float anchorV)` 设置标注的锚点
`void`	`setAnimation(Animation animation)` 设置标注的动画
`void`	`setClickable(boolean clickable)` 设置标注是否可以响应点击事件
`void`	`setContentDescription(java.lang.String contentDescription)` 为此Marker设置无障碍相关描述信息，也可通过`MarkerOptions`在添加Marker的时候设置
`void`	`setDraggable(boolean flag)` 设置标注是否可以被拖动
`void`	`setFastLoad(boolean fastLoad)` 设置是否允许 marker 快速加载，默认此选项为 true 如果当前屏幕内有大量 marker 同时动态修改其 icon 可能会有性能问题, 可以尝试关闭不需要此功能的 marker，关闭此功能后可能导致 marker 切换 icon 时闪烁
`void`	`setFixingPoint(int x, int y)` 设置这个Marker固定在屏幕上的坐标点。
`void`	`setFixingPointEnable(boolean boFix)` 设置这个Marker是否可以固定在屏幕上不动
`void`	`setIcon(BitmapDescriptor icon)` 设置标注的显示样式
`void`	`setInfoWindowAnchor(float anchorU, float anchorV)` 设置 infowindow 的锚点，默认 (0.5f, 1)
`void`	`setInfoWindowEnable(boolean enabled)` 设置标注是否可以弹出InfoWindow(气泡)
`void`	`setInfoWindowOffset(int offsetX, int offsetY)` 设置 infowindow 坐标偏移
`void`	`setInMapCenterState(boolean boInMap)` Deprecated. 废弃，请通过`TencentMap.moveCamera(CameraUpdate)`和更新position的接口组合来实现
`void`	`setLevel(int level)` 修改Marker的显示Level，level用于控制Marker与楼块，道路，POI的显示层级关系。相同Level内的显示层级关系通过`setZIndex(float)`来控制，zIndex越大越靠上显示。默认为`OverlayLevel.OverlayLevelAboveLabels`POI之上 Level优先级高于zIndex
`void`	`setMarkerOptions(MarkerOptions opt)` 更新标注的属性
`void`	`setOnTapMapViewBubbleHidden(boolean hidden)` Deprecated. 废弃
`void`	`setPosition(LatLng latlng)` 设置标注的位置
`void`	`setRotation(float rotation)` 设置标注的旋转角度
`void`	`setSnippet(java.lang.String snippet)` 设置标注的InfoWindow(气泡)的内容，如果设置了 `TencentMap.setInfoWindowAdapter(TencentMap.InfoWindowAdapter)` 则失效
`void`	`setTag(java.lang.Object tag)` 设置tag
`void`	`setTitle(java.lang.String s)` 设置标注的InfoWindow(气泡)的标题，如果设置了 `TencentMap.setInfoWindowAdapter(TencentMap.InfoWindowAdapter)` 则失效
`void`	`setVisible(boolean flag)` 设置标注是否可见
`void`	`setZIndex(float zIndex)` 设置相同显示Level下的 `setLevel(int)` 的Marker的堆叠顺序，相同显示level，zIndex越大越靠上显示 level优先级大于zIndex
`void`	`showInfoWindow()` 让标注显示InfoWindow(气泡)
`boolean`	`startAnimation()` 开发播放设置好的动画参见 `setAnimation(Animation)`

- Method Detail
  - setOnTapMapViewBubbleHidden
```
void setOnTapMapViewBubbleHidden(boolean hidden)
```
    Deprecated. 废弃
  - onTapMapViewBubbleHidden
```
boolean onTapMapViewBubbleHidden()
```
    Deprecated. 废弃
  - remove
```
void remove()
```
    将这个标注从地图上移除
  - getId
```
java.lang.String getId()
```
    获取这个标注的id编号
    
    Returns:
    
    Id编号
  - setPosition
```
void setPosition(LatLng latlng)
```
    设置标注的位置
    
    Parameters:
    
    latlng - 经纬度
  - setInfoWindowEnable
```
void setInfoWindowEnable(boolean enabled)
```
    设置标注是否可以弹出InfoWindow(气泡)
    
    Parameters:
    
    enabled - 是否可以弹出infowindow
  - isInfoWindowEnable
```
boolean isInfoWindowEnable()
```
    获取标注的InfoWindow是否可以弹出气泡
    
    Returns:
    
    是否可以弹出infowindow
  - setInMapCenterState
```
void setInMapCenterState(boolean boInMap)
```
    Deprecated. 废弃，请通过TencentMap.moveCamera(CameraUpdate)和更新position的接口组合来实现
    
    设置marker是否显示在map center位置
  - isInMapCenterState
```
boolean isInMapCenterState()
```
    Deprecated. 废弃
    
    marker是否需要显示在map center 此接口已不支持
  - getPosition
```
LatLng getPosition()
```
    获取标注的位置
    
    Returns:
    
    坐标
  - setTitle
```
void setTitle(java.lang.String s)
```
    设置标注的InfoWindow(气泡)的标题，如果设置了 TencentMap.setInfoWindowAdapter(TencentMap.InfoWindowAdapter) 则失效
    
    Parameters:
    
    s - 标题
  - getTitle
```
java.lang.String getTitle()
```
    获得标注的InfoWindow(气泡)的标题
    
    Returns:
    
    标题
  - setSnippet
```
void setSnippet(java.lang.String snippet)
```
    设置标注的InfoWindow(气泡)的内容，如果设置了 TencentMap.setInfoWindowAdapter(TencentMap.InfoWindowAdapter) 则失效
    
    Parameters:
    
    snippet - 描述信息
  - getSnippet
```
java.lang.String getSnippet()
```
    获取标注的InfoWindow(气泡)的内容
    
    Returns:
    
    描述信息
  - getAlpha
```
float getAlpha()
```
    获取标注的透明度
    
    Returns:
    
    透明度
  - setDraggable
```
void setDraggable(boolean flag)
```
    设置标注是否可以被拖动
    
    Parameters:
    
    flag - 是否可以被拖动
  - isDraggable
```
boolean isDraggable()
```
    获取标注是否可以被拖动
    
    Returns:
    
    是否可以被拖动
  - showInfoWindow
```
void showInfoWindow()
```
    让标注显示InfoWindow(气泡)
  - refreshInfoWindow
```
void refreshInfoWindow()
```
    更新infowindow
  - hideInfoWindow
```
void hideInfoWindow()
```
    让标注隐藏InfoWindow(气泡)
  - isInfoWindowShown
```
boolean isInfoWindowShown()
```
    获取让标注InfoWindow(气泡)是否正在显示
  - setAnchor
```
void setAnchor(float anchorU,
               float anchorV)
```
    设置标注的锚点
    
    Parameters:
    
    anchorU - 取值为[0.0 ~ 1.0] 表示锚点从 marker 图标最左边到最右边的百分比
    
    anchorV - 取值为[0.0 ~ 1.0] 表示锚点从 marker 图标最上边到最下边的百分比
  - setVisible
```
void setVisible(boolean flag)
```
    设置标注是否可见
    
    Parameters:
    
    flag - 是否可见
  - setIcon
```
void setIcon(BitmapDescriptor icon)
```
    设置标注的显示样式
    
    Parameters:
    
    icon - 纹理
  - setRotation
```
void setRotation(float rotation)
```
    设置标注的旋转角度
    
    Parameters:
    
    rotation - 旋转角度
  - getRotation
```
float getRotation()
```
    获得标注的旋转角度
    
    Returns:
    
    旋转角度
  - isVisible
```
boolean isVisible()
```
    获得标注是否可见
    
    Returns:
    
    是否可见
  - setAnimation
```
void setAnimation(Animation animation)
```
    设置标注的动画
    
    Parameters:
    
    animation - 动画
  - startAnimation
```
boolean startAnimation()
```
    开发播放设置好的动画参见 setAnimation(Animation)
    
    Returns:
    
    是否启动
  - setAlpha
```
void setAlpha(float alpha)
```
    设置Marker的透明度。[0.0-1.0]
    
    Parameters:
    
    alpha - 透明度
  - setClickable
```
void setClickable(boolean clickable)
```
    设置标注是否可以响应点击事件
    
    Parameters:
    
    clickable - 是否可点击
  - isClickable
```
boolean isClickable()
```
    获取标注是否可以响应点击事件
    
    Returns:
    
    是否可点击
  - setFixingPointEnable
```
void setFixingPointEnable(boolean boFix)
```
    设置这个Marker是否可以固定在屏幕上不动
    
    Parameters:
    
    boFix - 是否固定在屏幕上
  - setFixingPoint
```
void setFixingPoint(int x,
                    int y)
```
    设置这个Marker固定在屏幕上的坐标点。
    
    Parameters:
    
    x - 像素值（左上角为0)
    
    y - 像素值（左上角为0)
  - setMarkerOptions
```
void setMarkerOptions(MarkerOptions opt)
```
    更新标注的属性
    
    Parameters:
    
    opt - 属性
  - getOptions
```
MarkerOptions getOptions()
```
    获取该marker对应的配置
    
    Returns:
    
    属性
  - setZIndex
```
void setZIndex(float zIndex)
```
    设置相同显示Level下的 setLevel(int) 的Marker的堆叠顺序，相同显示level，zIndex越大越靠上显示 level优先级大于zIndex
    
    Parameters:
    
    zIndex - z轴层级这里只能填写 int 类型的数据
  - getZIndex
```
float getZIndex()
```
    获取标注的层级关系
    
    Returns:
  - setFastLoad
```
void setFastLoad(boolean fastLoad)
```
    设置是否允许 marker 快速加载，默认此选项为 true 如果当前屏幕内有大量 marker 同时动态修改其 icon 可能会有性能问题, 可以尝试关闭不需要此功能的 marker，关闭此功能后可能导致 marker 切换 icon 时闪烁
    
    Parameters:
    
    fastLoad - 默认true
  - isFastLoad
```
boolean isFastLoad()
```
    当前 marker 是否已打开快速加载
    
    Returns:
    
    是否开启
  - getWidth
```
int getWidth(Context ctx)
```
    获取marker纹理宽度
    
    Parameters:
    
    ctx - 上下文
    
    Returns:
    
    纹理高度
  - getHeight
```
int getHeight(Context ctx)
```
    获取marker纹理高度
    
    Parameters:
    
    ctx - 上下文
    
    Returns:
    
    纹理高度
  - getAnchorU
```
float getAnchorU()
```
    获取沿x轴的锚点
    
    Returns:
    
    锚点
  - getAnchorV
```
float getAnchorV()
```
    获取沿y轴的锚点
    
    Returns:
    
    锚点
  - getDisplayLevel
```
int getDisplayLevel()
```
    Deprecated. 废弃，请使用getLevel()
    
    获取显示级别
  - isInfoWindowAutoOverturn
```
boolean isInfoWindowAutoOverturn()
```
    Deprecated. 废弃，暂不支持
    
    获取该marker对应的气泡是否自动翻转
    
    Returns:
    
    是否支持自动翻转
  - getOnDragListener
```
TencentMap.OnMarkerDragListener getOnDragListener()
```
    Deprecated. 废弃，请使用TencentMap.setOnMarkerDragListener(TencentMap.OnMarkerDragListener)
    
    获取marker拖拽监听器
    
    Returns:
    
    拖拽监听器
  - setTag
```
void setTag(java.lang.Object tag)
```
    设置tag
    
    Parameters:
    
    tag - 标签
  - getTag
```
java.lang.Object getTag()
```
    获取tag
    
    Returns:
    
    标签
  - setInfoWindowAnchor
```
void setInfoWindowAnchor(float anchorU,
                         float anchorV)
```
    设置 infowindow 的锚点，默认 (0.5f, 1)
    
    Parameters:
    
    anchorU - 取值为[0.0 ~ 1.0] 表示锚点从 infowindow 最左边到最右边的百分比
    
    anchorV - 取值为[0.0 ~ 1.0] 表示锚点从 infowindow 最上边到最下边的百分比
  - setInfoWindowOffset
```
void setInfoWindowOffset(int offsetX,
                         int offsetY)
```
    设置 infowindow 坐标偏移
    
    Parameters:
    
    offsetX - 水平偏移，单位（px）
    
    offsetY - 纵向偏移，单位（px）
  - setContentDescription
```
void setContentDescription(java.lang.String contentDescription)
```
    为此Marker设置无障碍相关描述信息，也可通过MarkerOptions在添加Marker的时候设置
    
    Parameters:
    
    contentDescription - 描述信息
  - getContentDescription
```
java.lang.String getContentDescription()
```
    获取此Marker的无障碍相关的描述信息
    
    Returns:
    
    描述信息
  - getLevel
```
int getLevel()
```
    获取Marker显示层级，详见 OverlayLevel
    
    Returns:
    
    层级
  - setLevel
```
void setLevel(int level)
```
    修改Marker的显示Level，level用于控制Marker与楼块，道路，POI的显示层级关系。相同Level内的显示层级关系通过setZIndex(float)来控制，zIndex越大越靠上显示。默认为OverlayLevel.OverlayLevelAboveLabelsPOI之上 Level优先级高于zIndex
    
    Parameters:
    
    level - 必须为如下值之一，否则不生效
    OverlayLevel.OverlayLevelAboveRoads
    
    OverlayLevel.OverlayLevelAboveBuildings
    
    OverlayLevel.OverlayLevelAboveLabels

Interface Marker

Method Summary

Method Detail

setOnTapMapViewBubbleHidden

onTapMapViewBubbleHidden

remove

getId

setPosition

setInfoWindowEnable

isInfoWindowEnable

setInMapCenterState

isInMapCenterState

getPosition

setTitle

getTitle

setSnippet

getSnippet

getAlpha

setDraggable

isDraggable

showInfoWindow

refreshInfoWindow

hideInfoWindow

isInfoWindowShown

setAnchor

setVisible

setIcon

setRotation

getRotation

isVisible

setAnimation

startAnimation

setAlpha

setClickable

isClickable

setFixingPointEnable

setFixingPoint

setMarkerOptions

getOptions

setZIndex

getZIndex

setFastLoad

isFastLoad

getWidth

getHeight

getAnchorU

getAnchorV

getDisplayLevel

isInfoWindowAutoOverturn

getOnDragListener

setTag

getTag

setInfoWindowAnchor

setInfoWindowOffset

setContentDescription

getContentDescription

getLevel

setLevel