Package com.naver.maps.map.overlay
Class Marker
- java.lang.Object
-
- com.naver.maps.map.overlay.Overlay
-
- com.naver.maps.map.overlay.Marker
-
-
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
-
-
-
-
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 classOverlay
- Parameters:
map
- 오버레이를 추가할 지도 객체.- Throws:
Overlay.InvalidCoordinateException
-position
을 지정하지 않은 경우 발생.
-
getGlobalZIndex
public int getGlobalZIndex()
전역 Z 인덱스를 반환합니다. 여러 오버레이가 화면에서 겹쳐지면 전역 Z 인덱스가 큰 오버레이가 작은 오버레이를 덮습니다. 또한 값이0
이상이면 오버레이가 심벌 위에,0
미만이면 심벌 아래에 그려집니다.
기본값은DEFAULT_GLOBAL_Z_INDEX
입니다.- Overrides:
getGlobalZIndex
in classOverlay
- Returns:
- 전역 Z 인덱스.
-
setGlobalZIndex
public void setGlobalZIndex(int globalZIndex)
전역 Z 인덱스를 지정합니다. 여러 오버레이가 화면에서 겹쳐지면 전역 Z 인덱스가 큰 오버레이가 작은 오버레이를 덮습니다. 또한 값이0
이상이면 오버레이가 심벌 위에,0
미만이면 심벌 아래에 그려집니다.
기본값은DEFAULT_GLOBAL_Z_INDEX
입니다.- Overrides:
setGlobalZIndex
in classOverlay
- Parameters:
globalZIndex
- 전역 Z 인덱스.
-
getPosition
@NonNull @UiThread public LatLng getPosition()
- 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
@UiThread public int getIconTintColor()
아이콘에 덧입힐 색상을 반환합니다. 덧입힐 색상을 지정하면 덧입힐 색상이 아이콘 이미지의 색상과 가산 혼합됩니다. 단, 덧입힐 색상의 알파는 무시됩니다.
기본값은Color.TRANSPARENT
입니다.- Returns:
- 아이콘에 덧입힐 색상.
-
setIconTintColor
@UiThread public void setIconTintColor(int color)
아이콘에 덧입힐 색상을 지정합니다. 덧입힐 색상을 지정하면 덧입힐 색상이 아이콘 이미지의 색상과 가산 혼합됩니다. 단, 덧입힐 색상의 알파는 무시됩니다.
기본값은Color.TRANSPARENT
입니다.- Parameters:
color
- 아이콘에 덧입힐 색상.
-
getWidth
@Px @UiThread public int getWidth()
- Returns:
- 아이콘의 너비. 픽셀 단위.
-
setWidth
@UiThread public void setWidth(@Px int width)
- Parameters:
width
- 아이콘의 너비. 픽셀 단위.
-
getHeight
@Px @UiThread public int getHeight()
- Returns:
- px 아이콘의 높이. 픽셀 단위.
-
setHeight
@UiThread public void setHeight(@Px int height)
- 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()
- Returns:
- 텍스트 크기. DP 단위.
-
setCaptionTextSize
@UiThread public void setCaptionTextSize(@Dimension(unit=0) float size)
- Parameters:
size
- 텍스트 크기. DP 단위.
-
getCaptionColor
@UiThread public int getCaptionColor()
캡션의 텍스트 색상을 반환합니다.
기본값은Color.BLACK
입니다.- Returns:
- 텍스트 색상.
-
setCaptionColor
@UiThread public void setCaptionColor(int color)
캡션의 텍스트 색상을 지정합니다.
기본값은Color.BLACK
입니다.- Parameters:
color
- 텍스트 색상.
-
getCaptionHaloColor
@UiThread public int getCaptionHaloColor()
캡션의 외곽 색상을 반환합니다.
기본값은Color.WHITE
입니다.- Returns:
- 외곽 색상.
-
setCaptionHaloColor
@UiThread public void setCaptionHaloColor(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
@UiThread public double getCaptionMinZoom()
캡션이 보이는 최소 줌 레벨을 반환합니다. 지도의 줌 레벨이 캡션의 최소 줌 레벨보다 작을 경우 아이콘만 나타나고 주 캡션 및 보조 캡션이 나타나지 않습니다.
기본값은NaverMap.MINIMUM_ZOOM
입니다.- Returns:
- 캡션이 보이는 최소 줌 레벨.
-
setCaptionMinZoom
@UiThread public void setCaptionMinZoom(double minZoom)
캡션이 보이는 최소 줌 레벨을 지정합니다. 지도의 줌 레벨이 캡션의 최소 줌 레벨보다 작을 경우 아이콘만 나타나고 주 캡션 및 보조 캡션은 나타나지 않습니다.
기본값은NaverMap.MINIMUM_ZOOM
입니다.- Parameters:
minZoom
- 캡션이 보이는 최소 줌 레벨.
-
getCaptionMaxZoom
@UiThread public double getCaptionMaxZoom()
캡션이 보이는 최대 줌 레벨을 반환합니다. 지도의 줌 레벨이 캡션의 최대 줌 레벨보다 클 경우 아이콘만 나타나고 주 캡션 및 보조 캡션은 나타나지 않습니다.
기본값은NaverMap.MINIMUM_ZOOM
입니다.- Returns:
- 캡션이 보이는 최대 줌 레벨.
-
setCaptionMaxZoom
@UiThread public void setCaptionMaxZoom(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()
- Returns:
- 텍스트 크기. DP 단위.
-
setSubCaptionTextSize
@UiThread public void setSubCaptionTextSize(@Dimension(unit=0) float size)
- Parameters:
size
- 텍스트 크기. DP 단위.
-
getSubCaptionColor
@UiThread public int getSubCaptionColor()
보조 캡션의 텍스트 색상을 반환합니다.
기본값은Color.BLACK
입니다.- Returns:
- 텍스트 색상.
-
setSubCaptionColor
@UiThread public void setSubCaptionColor(int color)
보조 캡션의 텍스트 색상을 지정합니다.
기본값은Color.BLACK
입니다.- Parameters:
color
- 텍스트 색상.
-
getSubCaptionHaloColor
@UiThread public int getSubCaptionHaloColor()
보조 캡션의 외곽 색상을 반환합니다.
기본값은Color.WHITE
입니다.- Returns:
- 외곽 색상.
-
setSubCaptionHaloColor
@UiThread public void setSubCaptionHaloColor(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
@UiThread public double getSubCaptionMinZoom()
보조 캡션이 보이는 최소 줌 레벨을 반환합니다. 지도의 줌 레벨이 보조 캡션의 최소 줌 레벨보다 작을 경우 아이콘 및 주 캡션만 나타나고 보조 캡션은 나타나지 않습니다.
기본값은NaverMap.MINIMUM_ZOOM
입니다.- Returns:
- 보조 캡션이 보이는 최소 줌 레벨.
-
setSubCaptionMinZoom
@UiThread public void setSubCaptionMinZoom(double minZoom)
보조 캡션이 보이는 최소 줌 레벨을 지정합니다. 지도의 줌 레벨이 보조 캡션의 최소 줌 레벨보다 작을 경우 아이콘 및 주 캡션만 나타나고 보조 캡션은 나타나지 않습니다.
기본값은NaverMap.MINIMUM_ZOOM
입니다.- Parameters:
minZoom
- 보조 캡션이 보이는 최소 줌 레벨.
-
getSubCaptionMaxZoom
@UiThread public double getSubCaptionMaxZoom()
보조 캡션이 보이는 최대 줌 레벨을 반환합니다. 지도의 줌 레벨이 보조 캡션의 최대 줌 레벨보다 클 경우 아이콘 및 주 캡션만 나타나고 보조 캡션은 나타나지 않습니다.
기본값은NaverMap.MINIMUM_ZOOM
입니다.- Returns:
- 보조 캡션이 보이는 최대 줌 레벨.
-
setSubCaptionMaxZoom
@UiThread public void setSubCaptionMaxZoom(double maxZoom)
보조 캡션이 보이는 최대 줌 레벨을 지정합니다. 지도의 줌 레벨이 보조 캡션의 최대 줌 레벨보다 클 경우 아이콘 및 주 캡션만 나타나고 보조 캡션은 나타나지 않습니다.
기본값은NaverMap.MINIMUM_ZOOM
입니다.- Parameters:
maxZoom
- 보조 캡션이 보이는 최대 줌 레벨.
-
getCaptionAlign
@Deprecated @NonNull @UiThread public Align getCaptionAlign()
Deprecated.getCaptionAligns()
를 사용하세요.- Returns:
- 캡션의 정렬 방향.
-
setCaptionAlign
@Deprecated @UiThread public void setCaptionAlign(@NonNull Align align)
Deprecated.setCaptionAligns(Align...)
를 사용하세요.- Parameters:
align
- 캡션의 정렬 방향.
-
getCaptionAligns
@NonNull @UiThread public Align[] getCaptionAligns()
캡션을 아이콘의 어느 방향에 위치시킬지를 반환합니다. 캡션은setCaptionAligns(Align...)
로 지정된 순서대로 우선적으로 위치합니다. 만약 캡션이 다른 마커와 겹치지 않거나 겹치더라도 해당 마커의isHideCollidedCaptions()
가false
라면 캡션은 반드시 첫 번째 방향에 위치합니다. 그렇지 않을 경우 겹치지 않은 다음 방향에 위치하며, 어느 방향으로 위치시켜도 다른 마커와 겹칠 경우 캡션이 숨겨집니다.
기본값은DEFAULT_CAPTION_ALIGNS
입니다.- Returns:
- 캡션의 정렬 방향.
-
setCaptionAligns
@UiThread public void setCaptionAligns(@NonNull 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
@UiThread public float getAlpha()
불투명도를0
~1
로 반환합니다.0
일 경우 완전히 투명,1
일 경우 완전히 불투명함을 의미합니다. 아이콘과 캡션 모두에 적용됩니다.
기본값은1
입니다.- Returns:
- 불투명도.
-
setAlpha
@UiThread public void setAlpha(float alpha)
불투명도를0
~1
로 지정합니다.0
일 경우 완전히 투명,1
일 경우 완전히 불투명함을 의미합니다. 아이콘과 캡션 모두에 적용됩니다.
기본값은1
입니다.- Parameters:
alpha
- 불투명도.
-
getAngle
@UiThread public float getAngle()
아이콘의 각도를 반환합니다. 각도를 지정하면 아이콘이 해당 각도만큼 시계 방향으로 회전합니다.
기본값은0
입니다.- Returns:
- 아이콘의 각도. 도 단위.
-
setAngle
@UiThread public void setAngle(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()
- Returns:
- 아이콘을 무조건 표시할 경우
true
, 그렇지 않을 경우false
.
-
setForceShowIcon
@UiThread public void setForceShowIcon(boolean forceShowIcon)
- Parameters:
forceShowIcon
- 아이콘을 무조건 표시할 경우true
, 그렇지 않을 경우false
.
-
isForceShowCaption
@UiThread public boolean isForceShowCaption()
- Returns:
- 캡션을 무조건 표시할 경우
true
, 그렇지 않을 경우false
.
-
setForceShowCaption
@UiThread public void setForceShowCaption(boolean forceShowCaption)
- 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)
-
-