Package com.naver.maps.map.overlay
Class LocationOverlay
- java.lang.Object
-
- com.naver.maps.map.overlay.Overlay
-
- com.naver.maps.map.overlay.LocationOverlay
-
- All Implemented Interfaces:
Pickable
public final class LocationOverlay extends Overlay
사용자의 현재 위치를 나타내는 오버레이. 이 오버레이는 지도에 단 하나만 존재하며, 인스턴스를 직접 생성할 수 없고NaverMap.getLocationOverlay()
를 이용해서 가져올 수 있습니다.
위치 오버레이는 주 아이콘과 보조 아이콘, 원으로 구성됩니다.- 주 아이콘: 반드시 필요합니다. 이벤트를 받을 수 있습니다.
- 보조 아이콘: 생략할 수 있습니다. 주 아이콘보다 약간 아래에 그려집니다. 이벤트를 받을 수 없습니다.
- 원: 생략할 수 있습니다. 강조 효과를 위해 사용되며, 보조 아이콘 아래에 그려집니다. 이벤트를 받을 수 없습니다.
-
-
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 int
DEFAULT_CIRCLE_COLOR
기본 원 색상.static int
DEFAULT_CIRCLE_RADIUS_DP
기본 원 반경.static int
DEFAULT_GLOBAL_Z_INDEX
기본 전역 Z 인덱스.static OverlayImage
DEFAULT_ICON
기본 아이콘.static android.graphics.PointF
DEFAULT_SUB_ANCHOR
기본 서브 앵커.static OverlayImage
DEFAULT_SUB_ICON_ARROW
화살표가 있는 서브 아이콘.static OverlayImage
DEFAULT_SUB_ICON_CONE
콘이 있는 서브 아이콘.static int
SIZE_AUTO
너비 또는 높이가 자동임을 나타내는 상수.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description android.graphics.PointF
getAnchor()
아이콘의 앵커를 반환합니다.float
getBearing()
방위를 반환합니다.int
getCircleColor()
원의 색상을 반환합니다.int
getCircleOutlineColor()
원의 테두리 색상을 반환합니다.int
getCircleOutlineWidth()
원의 테두리 두께를 반환합니다.int
getCircleRadius()
원의 반경을 반환합니다.int
getGlobalZIndex()
전역 Z 인덱스를 반환합니다.OverlayImage
getIcon()
아이콘을 반환합니다.int
getIconHeight()
아이콘의 높이를 반환합니다.int
getIconWidth()
아이콘의 너비를 반환합니다.LatLng
getPosition()
오버레이의 좌표를 반환합니다.android.graphics.PointF
getSubAnchor()
보조 아이콘의 앵커를 반환합니다.OverlayImage
getSubIcon()
보조 아이콘을 반환합니다.int
getSubIconHeight()
보조 아이콘의 높이를 반환합니다.int
getSubIconWidth()
보조 아이콘의 너비를 반환합니다.void
setAnchor(android.graphics.PointF anchor)
아이콘의 앵커를 지정합니다.void
setBearing(float bearing)
방위를 지정합니다.void
setCircleColor(int color)
원의 색상을 반환합니다.void
setCircleOutlineColor(int color)
원의 테두리 색상을 지정합니다.void
setCircleOutlineWidth(int width)
원의 테두리 두께를 지정합니다.void
setCircleRadius(int radius)
원의 반경을 지정합니다.void
setGlobalZIndex(int globalZIndex)
전역 Z 인덱스를 지정합니다.void
setIcon(OverlayImage icon)
아이콘을 지정합니다.void
setIconHeight(int height)
아이콘의 높이를 지정합니다.void
setIconWidth(int width)
아이콘의 너비를 지정합니다.void
setMap(NaverMap map)
Deprecated.LocationOverlay
를 보이거나 숨기고 싶은 경우Overlay.setVisible(boolean)
을 호출하세요.void
setPosition(LatLng position)
좌표를 지정합니다.void
setSubAnchor(android.graphics.PointF anchor)
보조 아이콘의 앵커를 지정합니다.void
setSubIcon(OverlayImage subIcon)
보조 아이콘을 지정합니다.void
setSubIconHeight(int height)
보조 아이콘의 높이를 지정합니다.void
setSubIconWidth(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:
setIconWidth(int)
,setIconHeight(int)
, Constant Field Values
-
DEFAULT_ICON
@NonNull public static final OverlayImage DEFAULT_ICON
기본 아이콘.- See Also:
setIcon(OverlayImage)
-
DEFAULT_SUB_ICON_ARROW
@NonNull public static final OverlayImage DEFAULT_SUB_ICON_ARROW
화살표가 있는 서브 아이콘.- See Also:
setSubIcon(OverlayImage)
-
DEFAULT_SUB_ICON_CONE
@NonNull public static final OverlayImage DEFAULT_SUB_ICON_CONE
콘이 있는 서브 아이콘.- See Also:
setSubIcon(OverlayImage)
-
DEFAULT_CIRCLE_COLOR
public static final int DEFAULT_CIRCLE_COLOR
기본 원 색상.#0A1666F0
.
-
DEFAULT_CIRCLE_RADIUS_DP
@Dimension(unit=0) public static final int DEFAULT_CIRCLE_RADIUS_DP
기본 원 반경. DP 단위.- See Also:
- Constant Field Values
-
DEFAULT_ANCHOR
@NonNull public static final android.graphics.PointF DEFAULT_ANCHOR
기본 앵커. 가운데를 가리킵니다.- See Also:
setAnchor(PointF)
-
DEFAULT_SUB_ANCHOR
@NonNull public static final android.graphics.PointF DEFAULT_SUB_ANCHOR
기본 서브 앵커. 가운데 아래를 가리킵니다.- See Also:
setSubAnchor(PointF)
-
-
Method Detail
-
setMap
@Deprecated public void setMap(@Nullable NaverMap map)
Deprecated.LocationOverlay
를 보이거나 숨기고 싶은 경우Overlay.setVisible(boolean)
을 호출하세요.LocationOverlay
는 지도와 1:1 관계이므로 지도에 추가하거나 지도에서 제거할 수 없습니다. 호출하더라도 아무런 변화가 일어나지 않습니다.
-
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
이 유효하지 않은 경우 발생.
-
getBearing
@UiThread public float getBearing()
방위를 반환합니다. 방위가 북쪽일 경우0
도이며, 시계 방향으로 증가합니다.- Returns:
- 방위. 도 단위.
-
setBearing
@UiThread public void setBearing(float bearing)
방위를 지정합니다. 방위가 북쪽일 경우0
도이며, 시계 방향으로 증가합니다.- Parameters:
bearing
- 방위. 도 단위.
-
getIcon
@NonNull @UiThread public OverlayImage getIcon()
아이콘을 반환합니다.- Returns:
- 아이콘.
-
setIcon
@UiThread public void setIcon(@NonNull OverlayImage icon)
아이콘을 지정합니다.- Parameters:
icon
- 아이콘.
-
getIconWidth
@Px @UiThread public int getIconWidth()
- Returns:
- 너비. 픽셀 단위.
-
setIconWidth
@UiThread public void setIconWidth(@Px int width)
- Parameters:
width
- 너비. 픽셀 단위.
-
getIconHeight
@Px @UiThread public int getIconHeight()
- Returns:
- px 높이. 픽셀 단위.
-
setIconHeight
@UiThread public void setIconHeight(@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
- 앵커.
-
getSubIcon
@Nullable @UiThread public OverlayImage getSubIcon()
보조 아이콘을 반환합니다.null
일 경우 보조 아이콘이 그려지지 않습니다.
기본값은null
입니다.- Returns:
- 보조 아이콘.
-
setSubIcon
@UiThread public void setSubIcon(@Nullable OverlayImage subIcon)
보조 아이콘을 지정합니다.null
일 경우 보조 아이콘이 그려지지 않습니다.
기본값은null
입니다.- Parameters:
subIcon
- 보조 아이콘.
-
getSubIconWidth
@Px @UiThread public int getSubIconWidth()
- Returns:
- 너비. 픽셀 단위.
-
setSubIconWidth
@UiThread public void setSubIconWidth(@Px int width)
- Parameters:
width
- 너비. 픽셀 단위.
-
getSubIconHeight
@Px @UiThread public int getSubIconHeight()
- Returns:
- px 높이. 픽셀 단위.
-
setSubIconHeight
@UiThread public void setSubIconHeight(@Px int height)
- Parameters:
height
- 높이. 픽셀 단위.
-
getSubAnchor
@NonNull @UiThread public android.graphics.PointF getSubAnchor()
보조 아이콘의 앵커를 반환합니다. 앵커는 보조 아이콘 이미지에서 기준이 되는 지점을 의미합니다. 앵커로 지정된 지점이 오버레이의 좌표에 위치합니다. 값의 범위는(0, 0)
~(1, 1)
이며,(0, 0)
일 경우 이미지의 왼쪽 위,(1, 1)
일 경우 이미지의 오른쪽 아래를 의미합니다.
기본값은DEFAULT_SUB_ANCHOR
입니다.- Returns:
- 앵커.
-
setSubAnchor
@UiThread public void setSubAnchor(@NonNull android.graphics.PointF anchor)
보조 아이콘의 앵커를 지정합니다. 앵커는 보조 아이콘 이미지에서 기준이 되는 지점을 의미합니다. 앵커로 지정된 지점이 오버레이의 좌표에 위치합니다. 값의 범위는(0, 0)
~(1, 1)
이며,(0, 0)
일 경우 이미지의 왼쪽 위,(1, 1)
일 경우 이미지의 오른쪽 아래를 의미합니다.
기본값은DEFAULT_SUB_ANCHOR
입니다.- Parameters:
anchor
- 앵커.
-
getCircleRadius
@Px @UiThread public int getCircleRadius()
- Returns:
- 원의 반경. 픽셀 단위.
-
setCircleRadius
@UiThread public void setCircleRadius(@Px int radius)
- Parameters:
radius
- 원의 반경. 픽셀 단위.
-
getCircleColor
@UiThread public int getCircleColor()
- Returns:
- 원의 색상.
-
setCircleColor
@UiThread public void setCircleColor(int color)
- Parameters:
color
- 원의 색상.
-
getCircleOutlineWidth
@Px @UiThread public int getCircleOutlineWidth()
원의 테두리 두께를 반환합니다.0
일 경우 테두리가 그려지지 않습니다.
기본값은0
입니다.- Returns:
- 두께. 픽셀 단위.
-
setCircleOutlineWidth
@UiThread public void setCircleOutlineWidth(@Px int width)
원의 테두리 두께를 지정합니다.0
일 경우 테두리가 그려지지 않습니다.
기본값은0
입니다.- Parameters:
width
- 두께. 픽셀 단위.
-
getCircleOutlineColor
@UiThread public int getCircleOutlineColor()
원의 테두리 색상을 반환합니다.
기본값은Color.TRANSPARENT
입니다.- Returns:
- 원의 테두리 색상.
-
setCircleOutlineColor
@UiThread public void setCircleOutlineColor(int color)
원의 테두리 색상을 지정합니다.
기본값은Color.TRANSPARENT
입니다.- Parameters:
color
- 원의 테두리 색상.
-
-