java.lang.Object
- com.naver.maps.map.overlay.Overlay
- - com.naver.maps.map.overlay.Marker

All Implemented Interfaces:

Pickable
```
public final class Marker
extends Overlay
```
아이콘과 캡션을 이용해 지도 위의 한 지점을 표시하는 오버레이.

Nested Class Summary
- Nested classes/interfaces inherited from class com.naver.maps.map.overlay.Overlay
  Overlay.InvalidBoundsException, Overlay.InvalidCoordinateException, Overlay.OnClickListener

Field Summary

Fields
Modifier and Type	Field	Description
`static android.graphics.PointF`	`DEFAULT_ANCHOR`	기본 앵커.
`static Align[]`	`DEFAULT_CAPTION_ALIGNS`	기본 캡션 정렬 방향.
`static float`	`DEFAULT_CAPTION_TEXT_SIZE`	기본 캡션 크기.
`static int`	`DEFAULT_GLOBAL_Z_INDEX`	기본 전역 Z 인덱스.
`static OverlayImage`	`DEFAULT_ICON`	기본 아이콘.
`static int`	`SIZE_AUTO`	너비 또는 높이가 자동임을 나타내는 상수.

Constructor Summary

Constructors
Constructor	Description
`Marker()`	기본 생성자.
`Marker(LatLng position)`	위치를 지정하는 생성자.
`Marker(LatLng position, OverlayImage icon)`	위치와 아이콘을 지정하는 생성자.
`Marker(OverlayImage icon)`	아이콘을 지정하는 생성자.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	Description
`float`	`getAlpha()`	불투명도를 `0`~`1`로 반환합니다.
`android.graphics.PointF`	`getAnchor()`	앵커를 반환합니다.
`float`	`getAngle()`	아이콘의 각도를 반환합니다.
`Align`	`getCaptionAlign()`	Deprecated. `getCaptionAligns()`를 사용하세요.
`Align[]`	`getCaptionAligns()`	캡션을 아이콘의 어느 방향에 위치시킬지를 반환합니다.
`int`	`getCaptionColor()`	캡션의 텍스트 색상을 반환합니다.
`int`	`getCaptionHaloColor()`	캡션의 외곽 색상을 반환합니다.
`double`	`getCaptionMaxZoom()`	캡션이 보이는 최대 줌 레벨을 반환합니다.
`double`	`getCaptionMinZoom()`	캡션이 보이는 최소 줌 레벨을 반환합니다.
`int`	`getCaptionOffset()`	아이콘과 캡션 간의 여백을 반환합니다.
`int`	`getCaptionRequestedWidth()`	캡션의 너비를 반환합니다.
`java.lang.String`	`getCaptionText()`	캡션의 텍스트를 반환합니다.
`float`	`getCaptionTextSize()`	캡션의 텍스트 크기를 반환합니다.
`int`	`getGlobalZIndex()`	전역 Z 인덱스를 반환합니다.
`int`	`getHeight()`	아이콘의 높이를 반환합니다.
`OverlayImage`	`getIcon()`	아이콘을 반환합니다.
`int`	`getIconTintColor()`	아이콘에 덧입힐 색상을 반환합니다.
`InfoWindow`	`getInfoWindow()`	마커에 열려 있는 정보 창을 반환합니다.
`LatLng`	`getPosition()`	좌표를 반환합니다.
`int`	`getSubCaptionColor()`	보조 캡션의 텍스트 색상을 반환합니다.
`int`	`getSubCaptionHaloColor()`	보조 캡션의 외곽 색상을 반환합니다.
`double`	`getSubCaptionMaxZoom()`	보조 캡션이 보이는 최대 줌 레벨을 반환합니다.
`double`	`getSubCaptionMinZoom()`	보조 캡션이 보이는 최소 줌 레벨을 반환합니다.
`int`	`getSubCaptionRequestedWidth()`	보조 캡션의 너비를 반환합니다.
`java.lang.String`	`getSubCaptionText()`	보조 캡션의 텍스트를 반환합니다.
`float`	`getSubCaptionTextSize()`	보조 캡션의 텍스트 크기를 반환합니다.
`int`	`getWidth()`	아이콘의 너비를 반환합니다.
`boolean`	`hasInfoWindow()`	마커에 열려 있는 정보 창이 있는지 여부를 반환합니다.
`boolean`	`isCaptionPerspectiveEnabled()`	캡션에 원근 효과를 적용할지 여부를 반환합니다.
`boolean`	`isFlat()`	마커가 평평한지 여부를 반환합니다.
`boolean`	`isForceShowCaption()`	마커가 `isHideCollidedCaptions()`이 `true`인 다른 마커와 겹치더라도 캡션을 무조건 표시할지 여부를 반환합니다.
`boolean`	`isForceShowIcon()`	마커가 `isHideCollidedMarkers()`이 `true`인 다른 마커와 겹치더라도 아이콘을 무조건 표시할지 여부를 반환합니다.
`boolean`	`isHideCollidedCaptions()`	마커와 다른 마커의 캡션이 겹칠 경우 다른 마커의 캡션을 숨길지 여부를 반환합니다.
`boolean`	`isHideCollidedMarkers()`	마커와 다른 마커가 겹칠 경우 다른 마커를 숨길지 여부를 반환합니다.
`boolean`	`isHideCollidedSymbols()`	마커와 지도 심벌이 겹칠 경우 지도 심벌을 숨길지 여부를 반환합니다.
`boolean`	`isIconPerspectiveEnabled()`	아이콘에 원근 효과를 적용할지 여부를 반환합니다.
`void`	`setAlpha(float alpha)`	불투명도를 `0`~`1`로 지정합니다.
`void`	`setAnchor(android.graphics.PointF anchor)`	앵커를 지정합니다.
`void`	`setAngle(float angle)`	아이콘의 각도를 지정합니다.
`void`	`setCaptionAlign(Align align)`	Deprecated. `setCaptionAligns(Align...)`를 사용하세요.
`void`	`setCaptionAligns(Align... aligns)`	캡션을 아이콘의 어느 방향에 위치시킬지를 지정합니다.
`void`	`setCaptionColor(int color)`	캡션의 텍스트 색상을 지정합니다.
`void`	`setCaptionHaloColor(int strokeColor)`	캡션의 외곽 색상을 지정합니다.
`void`	`setCaptionMaxZoom(double maxZoom)`	캡션이 보이는 최대 줌 레벨을 지정합니다.
`void`	`setCaptionMinZoom(double minZoom)`	캡션이 보이는 최소 줌 레벨을 지정합니다.
`void`	`setCaptionOffset(int offset)`	아이콘과 캡션 간의 여백을 지정합니다.
`void`	`setCaptionPerspectiveEnabled(boolean enabled)`	캡션에 원근 효과를 적용할지 여부를 반환합니다.
`void`	`setCaptionRequestedWidth(int requestedWidth)`	캡션의 희망 너비를 지정합니다.
`void`	`setCaptionText(java.lang.String caption)`	캡션의 텍스트를 지정합니다.
`void`	`setCaptionTextSize(float size)`	캡션의 텍스트 크기를 지정합니다.
`void`	`setFlat(boolean flat)`	마커를 평평하게 설정할지 여부를 지정합니다.
`void`	`setForceShowCaption(boolean forceShowCaption)`	마커가 `isHideCollidedCaptions()`이 `true`인 다른 마커와 겹치더라도 캡션을 무조건 표시할지 여부를 지정합니다.
`void`	`setForceShowIcon(boolean forceShowIcon)`	마커가 `isHideCollidedMarkers()`이 `true`인 다른 마커와 겹치더라도 아이콘을 무조건 표시할지 여부를 지정합니다.
`void`	`setGlobalZIndex(int globalZIndex)`	전역 Z 인덱스를 지정합니다.
`void`	`setHeight(int height)`	아이콘의 높이를 지정합니다.
`void`	`setHideCollidedCaptions(boolean hide)`	마커와 다른 마커의 캡션이 겹칠 경우 다른 마커의 캡션을 숨길지 여부를 지정합니다.
`void`	`setHideCollidedMarkers(boolean hide)`	마커와 다른 마커가 겹칠 경우 다른 마커를 숨길지 여부를 지정합니다.
`void`	`setHideCollidedSymbols(boolean hide)`	마커와 지도 심벌이 겹칠 경우 지도 심벌을 숨길지 여부를 지정합니다.
`void`	`setIcon(OverlayImage icon)`	아이콘을 지정합니다.
`void`	`setIconPerspectiveEnabled(boolean enabled)`	아이콘에 원근 효과를 적용할지 여부를 반환합니다.
`void`	`setIconTintColor(int color)`	아이콘에 덧입힐 색상을 지정합니다.
`void`	`setMap(NaverMap map)`	오버레이를 `map`에 추가합니다.
`void`	`setPosition(LatLng position)`	좌표를 지정합니다.
`void`	`setSubCaptionColor(int color)`	보조 캡션의 텍스트 색상을 지정합니다.
`void`	`setSubCaptionHaloColor(int strokeColor)`	보조 캡션의 외곽 색상을 지정합니다.
`void`	`setSubCaptionMaxZoom(double maxZoom)`	보조 캡션이 보이는 최대 줌 레벨을 지정합니다.
`void`	`setSubCaptionMinZoom(double minZoom)`	보조 캡션이 보이는 최소 줌 레벨을 지정합니다.
`void`	`setSubCaptionRequestedWidth(int requestedWidth)`	보조 캡션의 너비를 지정합니다.
`void`	`setSubCaptionText(java.lang.String caption)`	보조 캡션의 텍스트를 지정합니다.
`void`	`setSubCaptionTextSize(float size)`	보조 캡션의 텍스트 크기를 지정합니다.
`void`	`setWidth(int width)`	아이콘의 너비를 지정합니다.

Methods inherited from class com.naver.maps.map.overlay.Overlay
getMap, getMaxZoom, getMinZoom, getOnClickListener, getTag, getZIndex, isAdded, isMaxZoomInclusive, isMinZoomInclusive, isVisible, performClick, setMaxZoom, setMaxZoomInclusive, setMinZoom, setMinZoomInclusive, setOnClickListener, setTag, setVisible, setZIndex

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - DEFAULT_GLOBAL_Z_INDEX
```
public static final int DEFAULT_GLOBAL_Z_INDEX
```
    기본 전역 Z 인덱스.
    
    See Also:
    
    setGlobalZIndex(int), Constant Field Values
  - SIZE_AUTO
```
public static final int SIZE_AUTO
```
    너비 또는 높이가 자동임을 나타내는 상수. 너비 또는 높이가 자동일 경우 아이콘 이미지의 크기에 맞춰집니다.
    
    See Also:
    
    setWidth(int), setHeight(int), Constant Field Values
  - DEFAULT_ICON
```
@NonNull
public static final OverlayImage DEFAULT_ICON
```
    기본 아이콘. MarkerIcons.GREEN과 동일합니다.
    
    See Also:
    
    setIcon(OverlayImage)
  - DEFAULT_ANCHOR
```
@NonNull
public static final android.graphics.PointF DEFAULT_ANCHOR
```
    기본 앵커. 가운데 아래를 가리킵니다.
    
    See Also:
    
    setAnchor(PointF)
  - DEFAULT_CAPTION_TEXT_SIZE
```
@Dimension(unit=0)
public static final float DEFAULT_CAPTION_TEXT_SIZE
```
    기본 캡션 크기. DP 단위.
    
    See Also:
    
    setCaptionTextSize(float), Constant Field Values
  - DEFAULT_CAPTION_ALIGNS
```
public static final Align[] DEFAULT_CAPTION_ALIGNS
```
    기본 캡션 정렬 방향. Align.Bottom.
    
    See Also:
    
    setCaptionAligns(Align[])
- Constructor Detail
  - Marker
```
public Marker()
```
    기본 생성자.
  - Marker
```
public Marker(@NonNull
              LatLng position)
```
    위치를 지정하는 생성자. 만약 position이 유효하지 않은(LatLng.isValid()가 false인) 좌표라면 Overlay.InvalidCoordinateException이 발생합니다.
    
    Parameters:
    
    position - 좌표.
    
    Throws:
    
    Overlay.InvalidCoordinateException - position이 유효하지 않은 경우 발생.
  - Marker
```
public Marker(@NonNull
              OverlayImage icon)
```
    아이콘을 지정하는 생성자.
    
    Parameters:
    
    icon - 아이콘.
  - Marker
```
public Marker(@NonNull
              LatLng position,
              @NonNull
              OverlayImage icon)
```
    위치와 아이콘을 지정하는 생성자. 만약 position이 유효하지 않은(LatLng.isValid()가 false인) 좌표라면 Overlay.InvalidCoordinateException이 발생합니다.
    
    Parameters:
    
    position - 좌표.
    
    icon - 아이콘.
    
    Throws:
    
    Overlay.InvalidCoordinateException - position이 유효하지 않은 경우 발생.
- Method Detail
  - setMap
```
public void setMap(@Nullable
                   NaverMap map)
```
    오버레이를 map에 추가합니다. map에 null을 지정하면 지도에서 제거됩니다.
    
    마커를 지도에 추가하기 전에는 반드시 setPosition(LatLng)으로 좌표를 지정해야 합니다. 그렇지 않을 경우 Overlay.InvalidCoordinateException이 발생합니다.
    
    Overrides:
    
    setMap in class Overlay
    
    Parameters:
    
    map - 오버레이를 추가할 지도 객체.
    
    Throws:
    
    Overlay.InvalidCoordinateException - position을 지정하지 않은 경우 발생.
  - getGlobalZIndex
```
public int getGlobalZIndex()
```
    전역 Z 인덱스를 반환합니다. 여러 오버레이가 화면에서 겹쳐지면 전역 Z 인덱스가 큰 오버레이가 작은 오버레이를 덮습니다. 또한 값이 0 이상이면 오버레이가 심벌 위에, 0 미만이면 심벌 아래에 그려집니다.
    
    기본값은 DEFAULT_GLOBAL_Z_INDEX입니다.
    
    Overrides:
    
    getGlobalZIndex in class Overlay
    
    Returns:
    
    전역 Z 인덱스.
  - setGlobalZIndex
```
public void setGlobalZIndex(int globalZIndex)
```
    전역 Z 인덱스를 지정합니다. 여러 오버레이가 화면에서 겹쳐지면 전역 Z 인덱스가 큰 오버레이가 작은 오버레이를 덮습니다. 또한 값이 0 이상이면 오버레이가 심벌 위에, 0 미만이면 심벌 아래에 그려집니다.
    
    기본값은 DEFAULT_GLOBAL_Z_INDEX입니다.
    
    Overrides:
    
    setGlobalZIndex in class Overlay
    
    Parameters:
    
    globalZIndex - 전역 Z 인덱스.
  - getPosition
```
@NonNull
@UiThread
public LatLng getPosition()
```
    좌표를 반환합니다.
    
    기본값은 유효하지 않은(LatLng.isValid()가 false인) 좌표입니다.
    
    Returns:
    
    좌표.
  - setPosition
```
@UiThread
public void setPosition(@NonNull
                        LatLng position)
```
    좌표를 지정합니다. 마커를 지도에 추가하기 전에 반드시 이 메서드를 호출해 좌표를 지정해야 합니다. 만약 position이 유효하지 않은(LatLng.isValid()가 false인) 좌표라면 Overlay.InvalidCoordinateException이 발생합니다.
    
    Parameters:
    
    position - 좌표.
    
    Throws:
    
    Overlay.InvalidCoordinateException - position이 유효하지 않은 경우 발생.
  - getIcon
```
@NonNull
@UiThread
public OverlayImage getIcon()
```
    아이콘을 반환합니다.
    
    Returns:
    
    아이콘.
  - setIcon
```
@UiThread
public void setIcon(@NonNull
                    OverlayImage icon)
```
    아이콘을 지정합니다.
    
    Parameters:
    
    icon - 아이콘.
  - getIconTintColor
```
@ColorInt
@UiThread
public int getIconTintColor()
```
    아이콘에 덧입힐 색상을 반환합니다. 덧입힐 색상을 지정하면 덧입힐 색상이 아이콘 이미지의 색상과 가산 혼합됩니다. 단, 덧입힐 색상의 알파는 무시됩니다.
    
    기본값은 Color.TRANSPARENT입니다.
    
    Returns:
    
    아이콘에 덧입힐 색상.
  - setIconTintColor
```
@UiThread
public void setIconTintColor(@ColorInt
                             int color)
```
    아이콘에 덧입힐 색상을 지정합니다. 덧입힐 색상을 지정하면 덧입힐 색상이 아이콘 이미지의 색상과 가산 혼합됩니다. 단, 덧입힐 색상의 알파는 무시됩니다.
    
    기본값은 Color.TRANSPARENT입니다.
    
    Parameters:
    
    color - 아이콘에 덧입힐 색상.
  - getWidth
```
@Px
@UiThread
public int getWidth()
```
    아이콘의 너비를 반환합니다. SIZE_AUTO일 경우 이미지의 너비를 따릅니다.
    
    기본값은 SIZE_AUTO입니다.
    
    Returns:
    
    아이콘의 너비. 픽셀 단위.
  - setWidth
```
@UiThread
public void setWidth(@Px
                     int width)
```
    아이콘의 너비를 지정합니다. SIZE_AUTO일 경우 이미지의 너비를 따릅니다.
    
    기본값은 SIZE_AUTO입니다.
    
    Parameters:
    
    width - 아이콘의 너비. 픽셀 단위.
  - getHeight
```
@Px
@UiThread
public int getHeight()
```
    아이콘의 높이를 반환합니다. SIZE_AUTO일 경우 이미지의 높이를 따릅니다.
    
    기본값은 SIZE_AUTO입니다.
    
    Returns:
    
    px 아이콘의 높이. 픽셀 단위.
  - setHeight
```
@UiThread
public void setHeight(@Px
                      int height)
```
    아이콘의 높이를 지정합니다. SIZE_AUTO일 경우 이미지의 높이를 따릅니다.
    
    기본값은 SIZE_AUTO입니다.
    
    Parameters:
    
    height - 아이콘의 높이. 픽셀 단위.
  - getAnchor
```
@NonNull
@UiThread
public android.graphics.PointF getAnchor()
```
    앵커를 반환합니다. 앵커는 아이콘 이미지에서 기준이 되는 지점을 의미합니다. 앵커로 지정된 지점이 마커의 좌표에 위치합니다. 값의 범위는 (0, 0)~(1, 1)이며, (0, 0)일 경우 이미지의 왼쪽 위, (1, 1)일 경우 이미지의 오른쪽 아래를 의미합니다.
    
    기본값은 DEFAULT_ANCHOR입니다.
    
    Returns:
    
    앵커.
  - setAnchor
```
@UiThread
public void setAnchor(@NonNull
                      android.graphics.PointF anchor)
```
    앵커를 지정합니다. 앵커는 아이콘 이미지에서 기준이 되는 지점을 의미합니다. 앵커로 지정된 지점이 마커의 좌표에 위치합니다. 값의 범위는 (0, 0)~(1, 1)이며, (0, 0)일 경우 이미지의 왼쪽 위, (1, 1)일 경우 이미지의 오른쪽 아래를 의미합니다.
    
    기본값은 DEFAULT_ANCHOR입니다.
    
    Parameters:
    
    anchor - 앵커.
  - getCaptionText
```
@NonNull
@UiThread
public java.lang.String getCaptionText()
```
    캡션의 텍스트를 반환합니다. 빈 문자열일 경우 캡션이 그려지지 않습니다.
    
    기본값은 빈 문자열입니다.
    
    Returns:
    
    텍스트.
  - setCaptionText
```
@UiThread
public void setCaptionText(@NonNull
                           java.lang.String caption)
```
    캡션의 텍스트를 지정합니다. 빈 문자열일 경우 캡션이 그려지지 않습니다.
    
    기본값은 빈 문자열입니다.
    
    Parameters:
    
    caption - 텍스트.
  - getCaptionTextSize
```
@Dimension(unit=0)
@UiThread
public float getCaptionTextSize()
```
    캡션의 텍스트 크기를 반환합니다.
    
    기본값은 DEFAULT_CAPTION_TEXT_SIZE입니다.
    
    Returns:
    
    텍스트 크기. DP 단위.
  - setCaptionTextSize
```
@UiThread
public void setCaptionTextSize(@Dimension(unit=0)
                               float size)
```
    캡션의 텍스트 크기를 지정합니다.
    
    기본값은 DEFAULT_CAPTION_TEXT_SIZE입니다.
    
    Parameters:
    
    size - 텍스트 크기. DP 단위.
  - getCaptionColor
```
@ColorInt
@UiThread
public int getCaptionColor()
```
    캡션의 텍스트 색상을 반환합니다.
    
    기본값은 Color.BLACK입니다.
    
    Returns:
    
    텍스트 색상.
  - setCaptionColor
```
@UiThread
public void setCaptionColor(@ColorInt
                            int color)
```
    캡션의 텍스트 색상을 지정합니다.
    
    기본값은 Color.BLACK입니다.
    
    Parameters:
    
    color - 텍스트 색상.
  - getCaptionHaloColor
```
@ColorInt
@UiThread
public int getCaptionHaloColor()
```
    캡션의 외곽 색상을 반환합니다.
    
    기본값은 Color.WHITE입니다.
    
    Returns:
    
    외곽 색상.
  - setCaptionHaloColor
```
@UiThread
public void setCaptionHaloColor(@ColorInt
                                int strokeColor)
```
    캡션의 외곽 색상을 지정합니다.
    
    기본값은 Color.WHITE입니다.
    
    Parameters:
    
    strokeColor - 외곽 색상.
  - getCaptionRequestedWidth
```
@Px
@UiThread
public int getCaptionRequestedWidth()
```
    캡션의 너비를 반환합니다. 지정할 경우 한 줄의 너비가 희망 너비를 초과하는 캡션 텍스트가 자동으로 개행됩니다. 자동 개행은 어절 단위로 이루어지므로, 하나의 어절이 길 경우 캡션의 너비가 희망 너비를 초과할 수 있습니다. 0일 경우 너비를 제한하지 않습니다.
    
    기본값은 0입니다.
    
    Returns:
    
    캡션의 너비. 픽셀 단위.
  - setCaptionRequestedWidth
```
@UiThread
public void setCaptionRequestedWidth(@Px
                                     int requestedWidth)
```
    캡션의 희망 너비를 지정합니다. 지정할 경우 한 줄의 너비가 희망 너비를 초과하는 캡션 텍스트가 자동으로 개행됩니다. 자동 개행은 어절 단위로 이루어지므로, 하나의 어절이 길 경우 캡션의 너비가 희망 너비를 초과할 수 있습니다. 0일 경우 너비를 제한하지 않습니다.
    
    기본값은 0입니다.
    
    Parameters:
    
    requestedWidth - 캡션의 너비. 픽셀 단위.
  - getCaptionMinZoom
```
@FloatRange(from=0.0,
            to=21.0)
@UiThread
public double getCaptionMinZoom()
```
    캡션이 보이는 최소 줌 레벨을 반환합니다. 지도의 줌 레벨이 캡션의 최소 줌 레벨보다 작을 경우 아이콘만 나타나고 주 캡션 및 보조 캡션이 나타나지 않습니다.
    
    기본값은 NaverMap.MINIMUM_ZOOM입니다.
    
    Returns:
    
    캡션이 보이는 최소 줌 레벨.
  - setCaptionMinZoom
```
@UiThread
public void setCaptionMinZoom(@FloatRange(from=0.0,to=21.0)
                              double minZoom)
```
    캡션이 보이는 최소 줌 레벨을 지정합니다. 지도의 줌 레벨이 캡션의 최소 줌 레벨보다 작을 경우 아이콘만 나타나고 주 캡션 및 보조 캡션은 나타나지 않습니다.
    
    기본값은 NaverMap.MINIMUM_ZOOM입니다.
    
    Parameters:
    
    minZoom - 캡션이 보이는 최소 줌 레벨.
  - getCaptionMaxZoom
```
@FloatRange(from=0.0,
            to=21.0)
@UiThread
public double getCaptionMaxZoom()
```
    캡션이 보이는 최대 줌 레벨을 반환합니다. 지도의 줌 레벨이 캡션의 최대 줌 레벨보다 클 경우 아이콘만 나타나고 주 캡션 및 보조 캡션은 나타나지 않습니다.
    
    기본값은 NaverMap.MINIMUM_ZOOM입니다.
    
    Returns:
    
    캡션이 보이는 최대 줌 레벨.
  - setCaptionMaxZoom
```
@UiThread
public void setCaptionMaxZoom(@FloatRange(from=0.0,to=21.0)
                              double maxZoom)
```
    캡션이 보이는 최대 줌 레벨을 지정합니다. 지도의 줌 레벨이 캡션의 최대 줌 레벨보다 클 경우 아이콘만 나타나고 주 캡션 및 보조 캡션은 나타나지 않습니다.
    
    기본값은 NaverMap.MINIMUM_ZOOM입니다.
    
    Parameters:
    
    maxZoom - 캡션이 보이는 최대 줌 레벨.
  - getSubCaptionText
```
@NonNull
@UiThread
public java.lang.String getSubCaptionText()
```
    보조 캡션의 텍스트를 반환합니다. 보조 캡션은 주 캡션의 하단에 나타납니다. 빈 문자열일 경우 보조 캡션이 그려지지 않습니다.
    
    기본값은 빈 문자열입니다.
    
    Returns:
    
    텍스트.
  - setSubCaptionText
```
@UiThread
public void setSubCaptionText(@NonNull
                              java.lang.String caption)
```
    보조 캡션의 텍스트를 지정합니다. 보조 캡션은 주 캡션의 하단에 나타납니다. 빈 문자열일 경우 보조 캡션이 그려지지 않습니다.
    
    기본값은 빈 문자열입니다.
    
    Parameters:
    
    caption - 텍스트. null일 경우 빈 문자열로 간주됩니다.
  - getSubCaptionTextSize
```
@Dimension(unit=0)
@UiThread
public float getSubCaptionTextSize()
```
    보조 캡션의 텍스트 크기를 반환합니다.
    
    기본값은 DEFAULT_CAPTION_TEXT_SIZE입니다.
    
    Returns:
    
    텍스트 크기. DP 단위.
  - setSubCaptionTextSize
```
@UiThread
public void setSubCaptionTextSize(@Dimension(unit=0)
                                  float size)
```
    보조 캡션의 텍스트 크기를 지정합니다.
    
    기본값은 DEFAULT_CAPTION_TEXT_SIZE입니다.
    
    Parameters:
    
    size - 텍스트 크기. DP 단위.
  - getSubCaptionColor
```
@ColorInt
@UiThread
public int getSubCaptionColor()
```
    보조 캡션의 텍스트 색상을 반환합니다.
    
    기본값은 Color.BLACK입니다.
    
    Returns:
    
    텍스트 색상.
  - setSubCaptionColor
```
@UiThread
public void setSubCaptionColor(@ColorInt
                               int color)
```
    보조 캡션의 텍스트 색상을 지정합니다.
    
    기본값은 Color.BLACK입니다.
    
    Parameters:
    
    color - 텍스트 색상.
  - getSubCaptionHaloColor
```
@ColorInt
@UiThread
public int getSubCaptionHaloColor()
```
    보조 캡션의 외곽 색상을 반환합니다.
    
    기본값은 Color.WHITE입니다.
    
    Returns:
    
    외곽 색상.
  - setSubCaptionHaloColor
```
@UiThread
public void setSubCaptionHaloColor(@ColorInt
                                   int strokeColor)
```
    보조 캡션의 외곽 색상을 지정합니다.
    
    기본값은 Color.WHITE입니다.
    
    Parameters:
    
    strokeColor - 외곽 색상.
  - getSubCaptionRequestedWidth
```
@Px
@UiThread
public int getSubCaptionRequestedWidth()
```
    보조 캡션의 너비를 반환합니다. 지정할 경우 한 줄의 너비가 희망 너비를 초과하는 캡션 텍스트는 자동으로 개행됩니다. 자동 개행은 어절 단위로 이루어지므로, 하나의 어절이 길 경우 캡션의 너비가 희망 너비를 초과할 수 있습니다. 0일 경우 너비를 제한하지 않습니다.
    
    기본값은 0입니다.
    
    Returns:
    
    캡션의 너비. 픽셀 단위.
  - setSubCaptionRequestedWidth
```
@UiThread
public void setSubCaptionRequestedWidth(@Px
                                        int requestedWidth)
```
    보조 캡션의 너비를 지정합니다. 지정할 경우 한 줄의 너비가 희망 너비를 초과하는 캡션 텍스트는 자동으로 개행됩니다. 자동 개행은 어절 단위로 이루어지므로, 하나의 어절이 길 경우 캡션의 너비가 희망 너비를 초과할 수 있습니다. 0일 경우 너비를 제한하지 않습니다.
    
    기본값은 0입니다.
    
    Parameters:
    
    requestedWidth - 캡션의 너비. 픽셀 단위.
  - getSubCaptionMinZoom
```
@FloatRange(from=0.0,
            to=21.0)
@UiThread
public double getSubCaptionMinZoom()
```
    보조 캡션이 보이는 최소 줌 레벨을 반환합니다. 지도의 줌 레벨이 보조 캡션의 최소 줌 레벨보다 작을 경우 아이콘 및 주 캡션만 나타나고 보조 캡션은 나타나지 않습니다.
    
    기본값은 NaverMap.MINIMUM_ZOOM입니다.
    
    Returns:
    
    보조 캡션이 보이는 최소 줌 레벨.
  - setSubCaptionMinZoom
```
@UiThread
public void setSubCaptionMinZoom(@FloatRange(from=0.0,to=21.0)
                                 double minZoom)
```
    보조 캡션이 보이는 최소 줌 레벨을 지정합니다. 지도의 줌 레벨이 보조 캡션의 최소 줌 레벨보다 작을 경우 아이콘 및 주 캡션만 나타나고 보조 캡션은 나타나지 않습니다.
    
    기본값은 NaverMap.MINIMUM_ZOOM입니다.
    
    Parameters:
    
    minZoom - 보조 캡션이 보이는 최소 줌 레벨.
  - getSubCaptionMaxZoom
```
@FloatRange(from=0.0,
            to=21.0)
@UiThread
public double getSubCaptionMaxZoom()
```
    보조 캡션이 보이는 최대 줌 레벨을 반환합니다. 지도의 줌 레벨이 보조 캡션의 최대 줌 레벨보다 클 경우 아이콘 및 주 캡션만 나타나고 보조 캡션은 나타나지 않습니다.
    
    기본값은 NaverMap.MINIMUM_ZOOM입니다.
    
    Returns:
    
    보조 캡션이 보이는 최대 줌 레벨.
  - setSubCaptionMaxZoom
```
@UiThread
public void setSubCaptionMaxZoom(@FloatRange(from=0.0,to=21.0)
                                 double maxZoom)
```
    보조 캡션이 보이는 최대 줌 레벨을 지정합니다. 지도의 줌 레벨이 보조 캡션의 최대 줌 레벨보다 클 경우 아이콘 및 주 캡션만 나타나고 보조 캡션은 나타나지 않습니다.
    
    기본값은 NaverMap.MINIMUM_ZOOM입니다.
    
    Parameters:
    
    maxZoom - 보조 캡션이 보이는 최대 줌 레벨.
  - getCaptionAlign
```
@Deprecated
@NonNull
@UiThread
public Align getCaptionAlign()
```
    Deprecated.
    getCaptionAligns()를 사용하세요.
    
    캡션이 아이콘의 어느 방향에 위치해 있는지를 반환합니다. getCaptionAligns()[0]과 동일합니다.
    
    기본값은 Align.Bottom입니다.
    
    Returns:
    
    캡션의 정렬 방향.
  - setCaptionAlign
```
@Deprecated
@UiThread
public void setCaptionAlign(@NonNull
                            Align align)
```
    Deprecated.
    setCaptionAligns(Align...)를 사용하세요.
    
    캡션을 아이콘의 어느 방향에 위치시킬지를 지정합니다. setCaptionAligns(align)과 동일합니다.
    
    기본값은 Align.Bottom입니다.
    
    Parameters:
    
    align - 캡션의 정렬 방향.
  - getCaptionAligns
```
@NonNull
@Size(min=1L)
@UiThread
public Align[] getCaptionAligns()
```
    캡션을 아이콘의 어느 방향에 위치시킬지를 반환합니다. 캡션은 setCaptionAligns(Align...)로 지정된 순서대로 우선적으로 위치합니다. 만약 캡션이 다른 마커와 겹치지 않거나 겹치더라도 해당 마커의 isHideCollidedCaptions()가 false라면 캡션은 반드시 첫 번째 방향에 위치합니다. 그렇지 않을 경우 겹치지 않은 다음 방향에 위치하며, 어느 방향으로 위치시켜도 다른 마커와 겹칠 경우 캡션이 숨겨집니다.
    
    기본값은 DEFAULT_CAPTION_ALIGNS입니다.
    
    Returns:
    
    캡션의 정렬 방향.
  - setCaptionAligns
```
@UiThread
public void setCaptionAligns(@NonNull @Size(min=1L)
                             Align... aligns)
```
    캡션을 아이콘의 어느 방향에 위치시킬지를 지정합니다. 캡션은 aligns에 지정된 순서대로 우선적으로 위치합니다. 만약 캡션이 다른 마커와 겹치지 않거나 겹치더라도 해당 마커의 isHideCollidedCaptions()가 false라면 캡션은 반드시 aligns[0]에 위치합니다. 그렇지 않을 경우 겹치지 않은 다음 방향에 위치하며, 어느 방향으로 위치시켜도 다른 마커와 겹칠 경우 캡션이 숨겨집니다.
    
    만약 파라메터 없이 메서드를 호출하거나 aligns의 크기가 0이면 IllegalArgumentException이 발생합니다. aligns에 null이 있다면 NullPointerException이 발생합니다.
    
    기본값은 DEFAULT_CAPTION_ALIGNS입니다.
    
    Parameters:
    
    aligns - 캡션의 정렬 방향.
    
    Throws:
    
    java.lang.IllegalArgumentException - 파라메터 없이 메서드를 호출하거나 aligns의 크기가 0일 경우 발생.
    
    java.lang.NullPointerException - aligns에 null이 있을 경우 발생.
  - getCaptionOffset
```
@Px
@UiThread
public int getCaptionOffset()
```
    아이콘과 캡션 간의 여백을 반환합니다.
    
    기본값은 0입니다.
    
    Returns:
    
    여백. 픽셀 단위.
  - setCaptionOffset
```
@UiThread
public void setCaptionOffset(@Px
                             int offset)
```
    아이콘과 캡션 간의 여백을 지정합니다.
    
    기본값은 0입니다.
    
    Parameters:
    
    offset - 여백. 픽셀 단위.
  - getAlpha
```
@FloatRange(from=0.0,
            to=1.0)
@UiThread
public float getAlpha()
```
    불투명도를 0~1로 반환합니다. 0일 경우 완전히 투명, 1일 경우 완전히 불투명함을 의미합니다. 아이콘과 캡션 모두에 적용됩니다.
    
    기본값은 1입니다.
    
    Returns:
    
    불투명도.
  - setAlpha
```
@UiThread
public void setAlpha(@FloatRange(from=0.0,to=1.0)
                     float alpha)
```
    불투명도를 0~1로 지정합니다. 0일 경우 완전히 투명, 1일 경우 완전히 불투명함을 의미합니다. 아이콘과 캡션 모두에 적용됩니다.
    
    기본값은 1입니다.
    
    Parameters:
    
    alpha - 불투명도.
  - getAngle
```
@FloatRange(from=0.0,
            to=360.0)
@UiThread
public float getAngle()
```
    아이콘의 각도를 반환합니다. 각도를 지정하면 아이콘이 해당 각도만큼 시계 방향으로 회전합니다.
    
    기본값은 0입니다.
    
    Returns:
    
    아이콘의 각도. 도 단위.
  - setAngle
```
@UiThread
public void setAngle(@FloatRange(from=0.0,to=360.0)
                     float angle)
```
    아이콘의 각도를 지정합니다. 각도를 지정하면 아이콘이 해당 각도만큼 시계 방향으로 회전합니다.
    
    기본값은 0입니다.
    
    Parameters:
    
    angle - 아이콘의 각도. 도 단위.
  - isFlat
```
@UiThread
public boolean isFlat()
```
    마커가 평평한지 여부를 반환합니다. 마커가 평평할 경우 지도가 회전하거나 기울어지면 마커 이미지도 함께 회전하거나 기울어집니다. 단, 마커가 평평하더라도 이미지의 크기는 항상 동일하게 유지됩니다.
    
    기본값은 false입니다.
    
    Returns:
    
    마커가 평평하면 true, 그렇지 않을 경우 false.
  - setFlat
```
@UiThread
public void setFlat(boolean flat)
```
    마커를 평평하게 설정할지 여부를 지정합니다. 마커가 평평할 경우 지도가 회전하거나 기울어지면 마커 이미지도 함께 회전하거나 기울어집니다. 단, 마커가 평평하더라도 이미지의 크기는 항상 동일하게 유지됩니다.
    
    기본값은 false입니다.
    
    Parameters:
    
    flat - 마커가 평평한지 여부.
  - isHideCollidedSymbols
```
@UiThread
public boolean isHideCollidedSymbols()
```
    마커와 지도 심벌이 겹칠 경우 지도 심벌을 숨길지 여부를 반환합니다.
    
    기본값은 false입니다.
    
    Returns:
    
    지도 심벌을 숨길 경우 true, 그렇지 않을 경우 false.
  - setHideCollidedSymbols
```
@UiThread
public void setHideCollidedSymbols(boolean hide)
```
    마커와 지도 심벌이 겹칠 경우 지도 심벌을 숨길지 여부를 지정합니다.
    
    기본값은 false입니다.
    
    Parameters:
    
    hide - 지도 심벌을 숨길 경우 true, 그렇지 않을 경우 false.
  - isHideCollidedMarkers
```
@UiThread
public boolean isHideCollidedMarkers()
```
    마커와 다른 마커가 겹칠 경우 다른 마커를 숨길지 여부를 반환합니다.
    
    기본값은 false입니다.
    
    Returns:
    
    다른 마커를 숨길 경우 true, 그렇지 않을 경우 false.
  - setHideCollidedMarkers
```
@UiThread
public void setHideCollidedMarkers(boolean hide)
```
    마커와 다른 마커가 겹칠 경우 다른 마커를 숨길지 여부를 지정합니다.
    
    기본값은 false입니다.
    
    Parameters:
    
    hide - 다른 마커를 숨길 경우 true, 그렇지 않을 경우 false.
  - isHideCollidedCaptions
```
@UiThread
public boolean isHideCollidedCaptions()
```
    마커와 다른 마커의 캡션이 겹칠 경우 다른 마커의 캡션을 숨길지 여부를 반환합니다.
    
    기본값은 false입니다.
    
    Returns:
    
    다른 마커의 캡션을 숨길 경우 true, 그렇지 않을 경우 false.
  - setHideCollidedCaptions
```
@UiThread
public void setHideCollidedCaptions(boolean hide)
```
    마커와 다른 마커의 캡션이 겹칠 경우 다른 마커의 캡션을 숨길지 여부를 지정합니다.
    
    기본값은 false입니다.
    
    Parameters:
    
    hide - 다른 마커의 캡션을 숨길 경우 true, 그렇지 않을 경우 false.
  - isForceShowIcon
```
@UiThread
public boolean isForceShowIcon()
```
    마커가 isHideCollidedMarkers()이 true인 다른 마커와 겹치더라도 아이콘을 무조건 표시할지 여부를 반환합니다.
    
    기본값은 false입니다.
    
    Returns:
    
    아이콘을 무조건 표시할 경우 true, 그렇지 않을 경우 false.
  - setForceShowIcon
```
@UiThread
public void setForceShowIcon(boolean forceShowIcon)
```
    마커가 isHideCollidedMarkers()이 true인 다른 마커와 겹치더라도 아이콘을 무조건 표시할지 여부를 지정합니다.
    
    기본값은 false입니다.
    
    Parameters:
    
    forceShowIcon - 아이콘을 무조건 표시할 경우 true, 그렇지 않을 경우 false.
  - isForceShowCaption
```
@UiThread
public boolean isForceShowCaption()
```
    마커가 isHideCollidedCaptions()이 true인 다른 마커와 겹치더라도 캡션을 무조건 표시할지 여부를 반환합니다.
    
    기본값은 false입니다.
    
    Returns:
    
    캡션을 무조건 표시할 경우 true, 그렇지 않을 경우 false.
  - setForceShowCaption
```
@UiThread
public void setForceShowCaption(boolean forceShowCaption)
```
    마커가 isHideCollidedCaptions()이 true인 다른 마커와 겹치더라도 캡션을 무조건 표시할지 여부를 지정합니다.
    
    기본값은 false입니다.
    
    Parameters:
    
    forceShowCaption - 캡션을 무조건 표시할 경우 true, 그렇지 않을 경우 false.
  - isIconPerspectiveEnabled
```
@UiThread
public boolean isIconPerspectiveEnabled()
```
    아이콘에 원근 효과를 적용할지 여부를 반환합니다. 원근 효과를 적용할 경우 가까운 아이콘은 크게, 먼 아이콘은 작게 표시됩니다.
    
    기본값은 false입니다.
    
    Returns:
    
    마커 아이콘에 원근 효과가 적용되었으면 true, 그렇지 않을 경우 false.
  - setIconPerspectiveEnabled
```
@UiThread
public void setIconPerspectiveEnabled(boolean enabled)
```
    아이콘에 원근 효과를 적용할지 여부를 반환합니다. 원근 효과를 적용할 경우 가까운 아이콘은 크게, 먼 아이콘은 작게 표시됩니다.
    
    기본값은 false입니다.
    
    Parameters:
    
    enabled - 아이콘 원근 효과 적용 여부.
  - isCaptionPerspectiveEnabled
```
@UiThread
public boolean isCaptionPerspectiveEnabled()
```
    캡션에 원근 효과를 적용할지 여부를 반환합니다. 원근 효과를 적용할 경우 가까운 캡션은 크게, 먼 캡션은 작게 표시됩니다.
    
    기본값은 false입니다.
    
    Returns:
    
    캡션에 원근 효과가 적용되었으면 true, 그렇지 않을 경우 false.
  - setCaptionPerspectiveEnabled
```
@UiThread
public void setCaptionPerspectiveEnabled(boolean enabled)
```
    캡션에 원근 효과를 적용할지 여부를 반환합니다. 원근 효과를 적용할 경우 가까운 캡션은 크게, 먼 캡션은 작게 표시됩니다.
    
    기본값은 false입니다.
    
    Parameters:
    
    enabled - 캡션 원근 효과 적용 여부.
  - hasInfoWindow
```
@UiThread
public boolean hasInfoWindow()
```
    마커에 열려 있는 정보 창이 있는지 여부를 반환합니다.
    
    Returns:
    
    정보 창이 있으면 true, 그렇지 않을 경우 false.
    
    See Also:
    
    InfoWindow.open(Marker)
  - getInfoWindow
```
@Nullable
@UiThread
public InfoWindow getInfoWindow()
```
    마커에 열려 있는 정보 창을 반환합니다.
    
    Returns:
    
    정보 창 객체. 마커에 열려 있는 정보 창이 없을 경우 null.
    
    See Also:
    
    InfoWindow.open(Marker)

Class Marker

Nested Class Summary

Nested classes/interfaces inherited from class com.naver.maps.map.overlay.Overlay

Field Summary

Constructor Summary

Method Summary

Methods inherited from class com.naver.maps.map.overlay.Overlay

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_GLOBAL_Z_INDEX

SIZE_AUTO

DEFAULT_ICON

DEFAULT_ANCHOR

DEFAULT_CAPTION_TEXT_SIZE

DEFAULT_CAPTION_ALIGNS

Constructor Detail

Marker

Marker

Marker

Marker

Method Detail

setMap

getGlobalZIndex

setGlobalZIndex

getPosition

setPosition

getIcon

setIcon

getIconTintColor

setIconTintColor

getWidth

setWidth

getHeight

setHeight

getAnchor

setAnchor

getCaptionText

setCaptionText

getCaptionTextSize

setCaptionTextSize

getCaptionColor

setCaptionColor

getCaptionHaloColor

setCaptionHaloColor

getCaptionRequestedWidth

setCaptionRequestedWidth

getCaptionMinZoom

setCaptionMinZoom

getCaptionMaxZoom

setCaptionMaxZoom

getSubCaptionText

setSubCaptionText

getSubCaptionTextSize

setSubCaptionTextSize

getSubCaptionColor

setSubCaptionColor

getSubCaptionHaloColor

setSubCaptionHaloColor

getSubCaptionRequestedWidth

setSubCaptionRequestedWidth

getSubCaptionMinZoom

setSubCaptionMinZoom

getSubCaptionMaxZoom

setSubCaptionMaxZoom

getCaptionAlign

setCaptionAlign

getCaptionAligns

setCaptionAligns

getCaptionOffset

setCaptionOffset

getAlpha

setAlpha

getAngle

setAngle

isFlat

setFlat

isHideCollidedSymbols

setHideCollidedSymbols

isHideCollidedMarkers

setHideCollidedMarkers