Package com.naver.maps.map.overlay
Class InfoWindow
- java.lang.Object
-
- com.naver.maps.map.overlay.Overlay
-
- com.naver.maps.map.overlay.InfoWindow
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
InfoWindow.Adapter
정보 창의 이미지를 지정하는 어댑터.static class
InfoWindow.DefaultTextAdapter
기본 배경 말풍선 이미지와 콘텐츠 텍스트를 사용해 정보 창의 이미지를 지정하는 어댑터.static class
InfoWindow.DefaultViewAdapter
기본 배경 말풍선 이미지와 콘텐츠View
를 사용해 정보 창의 이미지를 지정하는 어댑터.static class
InfoWindow.ViewAdapter
View
를 사용해 정보 창의 이미지를 지정하는 어댑터.-
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 InfoWindow.Adapter
DEFAULT_ADAPTER
기본 어댑터.static android.graphics.PointF
DEFAULT_ANCHOR
기본 앵커.static int
DEFAULT_GLOBAL_Z_INDEX
기본 전역 Z 인덱스.
-
Constructor Summary
Constructors Constructor Description InfoWindow()
기본 생성자.InfoWindow(InfoWindow.Adapter adapter)
어댑터를 지정하는 생성자.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
close()
정보 창을 닫습니다.InfoWindow.Adapter
getAdapter()
이미지 어댑터를 반환합니다.Align
getAlign()
정보 창이 마커에 열려 있는 경우 열린 방향을 반환합니다.float
getAlpha()
불투명도를0
~1
로 반환합니다.android.graphics.PointF
getAnchor()
앵커를 반환합니다.int
getGlobalZIndex()
전역 Z 인덱스를 반환합니다.Marker
getMarker()
정보 창이 열려 있는 마커를 반환합니다.int
getOffsetX()
정보 창과 좌표 또는 마커 간의 X축 방향 여백을 반환합니다.int
getOffsetY()
정보 창과 좌표 또는 마커 간의 Y축 방향 여백을 반환합니다.LatLng
getPosition()
좌표를 반환합니다.void
invalidate()
이미지를 다시 그립니다.void
open(NaverMap map)
정보 창을setPosition(LatLng)
으로 지정한 지점에 엽니다.void
open(Marker marker)
정보 창을marker
의 위에 엽니다.void
open(Marker marker, Align align)
정보 창을marker
에 엽니다.void
setAdapter(InfoWindow.Adapter adapter)
이미지 어댑터를 지정합니다.void
setAlpha(float alpha)
불투명도를0
~1
로 지정합니다.void
setAnchor(android.graphics.PointF anchor)
앵커를 지정합니다.void
setGlobalZIndex(int globalZIndex)
전역 Z 인덱스를 지정합니다.void
setMap(NaverMap map)
void
setOffsetX(int offset)
정보 창과 좌표 또는 마커 간의 X축 방향 여백을 지정합니다.void
setOffsetY(int offset)
정보 창과 좌표 또는 마커 간의 Y축 방향 여백을 지정합니다.void
setPosition(LatLng position)
좌표를 지정합니다.-
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_ADAPTER
@NonNull public static final InfoWindow.Adapter DEFAULT_ADAPTER
기본 어댑터. 빈 말풍선이 나타납니다.- See Also:
setAdapter(Adapter)
-
DEFAULT_GLOBAL_Z_INDEX
public static final int DEFAULT_GLOBAL_Z_INDEX
기본 전역 Z 인덱스.- See Also:
setGlobalZIndex(int)
, Constant Field Values
-
DEFAULT_ANCHOR
@NonNull public static final android.graphics.PointF DEFAULT_ANCHOR
기본 앵커. 가운데 아래를 가리킵니다.- See Also:
setAnchor(PointF)
-
-
Constructor Detail
-
InfoWindow
public InfoWindow()
기본 생성자.
-
InfoWindow
public InfoWindow(@NonNull InfoWindow.Adapter adapter)
어댑터를 지정하는 생성자.- Parameters:
adapter
- 어댑터.
-
-
Method Detail
-
open
@UiThread public void open(@NonNull Marker marker)
정보 창을marker
의 위에 엽니다.open(marker, Align.Top)
과 동일합니다.- Parameters:
marker
- 정보 창을 열 마커.
-
open
@UiThread public void open(@NonNull Marker marker, @NonNull Align align)
정보 창을marker
에 엽니다. 정보 창을 열 마커는 반드시 지도에 추가된 상태여야 하며, 그렇지 않을 경우 무시됩니다.align
을 이용하면 마커의 어느 방향에 정보 창의 앵커를 위치시킬지를 지정할 수 있습니다.- Parameters:
marker
- 정보 창을 열 마커.align
- 정보 창을 열 방향.
-
open
@UiThread public void open(@NonNull NaverMap map)
정보 창을setPosition(LatLng)
으로 지정한 지점에 엽니다.
정보 창을 특정 지점에 열기 전에는 반드시setPosition(LatLng)
로 좌표를 지정해야 합니다. 그렇지 않을 경우Overlay.InvalidCoordinateException
이 발생합니다.- Parameters:
map
- 정보 창을 열 지도 객체.- Throws:
Overlay.InvalidCoordinateException
-position
을 지정하지 않은 경우 발생.
-
close
@UiThread public void close()
정보 창을 닫습니다. 정보 창이 열려 있지 않은 경우 무시됩니다.
-
getMarker
@Nullable @UiThread public Marker getMarker()
정보 창이 열려 있는 마커를 반환합니다.- Returns:
- 정보 창이 열려 있는 마커. 정보 창이 마커에 열려 있지 않은 경우
null
.
-
getAlign
@NonNull @UiThread public Align getAlign()
정보 창이 마커에 열려 있는 경우 열린 방향을 반환합니다.- Returns:
- 정렬 방향. 마커에 열려 있지 않은 경우 무의미한 값.
-
setMap
public void setMap(@Nullable NaverMap map)
-
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()
좌표를 반환합니다. 좌표는open(NaverMap)
을 호출해 정보 창을 여는 경우 사용되며,open(Marker)
을 호출해 여는 경우에는 마커의 위치에 정보 창이 열리므로 무시됩니다.
기본값은 유효하지 않은(LatLng.isValid()
가false
인) 좌표입니다.- Returns:
- 좌표.
-
setPosition
@UiThread public void setPosition(@NonNull LatLng position)
좌표를 지정합니다. 좌표는open(NaverMap)
을 호출해 정보 창을 여는 경우 사용되며,open(Marker)
을 호출해 여는 경우에는 마커의 위치에 정보 창이 열리므로 무시됩니다.
따라서open(NaverMap)
을 호출하기 전에는 반드시 이 메서드를 호출해 좌표를 지정해야 합니다. 만약position
이 유효하지 않은(LatLng.isValid()
가false
인) 좌표라면Overlay.InvalidCoordinateException
이 발생합니다.- Parameters:
position
- 좌표.- Throws:
Overlay.InvalidCoordinateException
-position
이 유효하지 않은 경우 발생.
-
getAdapter
@NonNull @UiThread public InfoWindow.Adapter getAdapter()
- Returns:
- 어댑터.
-
setAdapter
@UiThread public void setAdapter(@NonNull InfoWindow.Adapter adapter)
- Parameters:
adapter
- 어댑터.
-
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
- 앵커.
-
getOffsetX
@Px @UiThread public int getOffsetX()
정보 창과 좌표 또는 마커 간의 X축 방향 여백을 반환합니다.
기본값은0
입니다.- Returns:
- 여백. 픽셀 단위.
-
setOffsetX
@UiThread public void setOffsetX(@Px int offset)
정보 창과 좌표 또는 마커 간의 X축 방향 여백을 지정합니다.
기본값은0
입니다.- Parameters:
offset
- 여백. 픽셀 단위.
-
getOffsetY
@Px @UiThread public int getOffsetY()
정보 창과 좌표 또는 마커 간의 Y축 방향 여백을 반환합니다.
기본값은0
입니다.- Returns:
- 여백. 픽셀 단위.
-
setOffsetY
@UiThread public void setOffsetY(@Px int offset)
정보 창과 좌표 또는 마커 간의 Y축 방향 여백을 지정합니다.
기본값은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
- 불투명도.
-
invalidate
@UiThread public void invalidate()
이미지를 다시 그립니다.
-
-