Package com.kakao.vectormap
Class KakaoMap
- java.lang.Object
-
- com.kakao.vectormap.KakaoMap
-
public final class KakaoMap extends java.lang.Object
KakaoMaps SDK for Android 의 메인 클래스이며 지도와 관련 된 모든 함수와 연결 된 진입점 이다. KakaoMap 객체는 직접 생성 할 수 없으며,MapView#start(KakaoMapReadyCallback)
을 통해 가져 올 수 있다.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interface
KakaoMap.OnCameraMoveEndListener
카메라의 이동 종료 이벤트 리스너static interface
KakaoMap.OnCameraMoveStartListener
카메라의 이동 시작 이벤트 리스너static interface
KakaoMap.OnCameraPositionListener
지도 중심을 바라보는 가장 최신의 카메라 위치 값을 수신하는 리스너static interface
KakaoMap.OnCompassClickListener
Compass
를 클릭했을 때 클릭 이벤트를 수신하는 리스너static interface
KakaoMap.OnInfoWindowClickListener
InfoWindow
를 클릭했을 때 이벤트를 수신하는 리스너static interface
KakaoMap.OnLabelClickListener
Label
을 클릭했을 때 이벤트를 수신하는 리스너.static interface
KakaoMap.OnLodLabelClickListener
LodLabel
을 클릭했을 때 이벤트를 수신하는 리스너static interface
KakaoMap.OnMapClickListener
지도판을 클릭 했을 때 이벤트를 수신하는 리스너.static interface
KakaoMap.OnMapViewInfoChangeListener
MapViewInfo
또는MapType
변경 됐을 때 이벤트를 수신하는 리스너static interface
KakaoMap.OnMapWidgetClickListener
MapWidget
를 클릭했을 때 이벤트를 수신하는 리스너static interface
KakaoMap.OnPaddingChangeListener
Viewport 의 Padding 이 변경 됐을 때 이벤트를 수신하는 리스너static interface
KakaoMap.OnPoiClickListener
지도판의 POI 를 클릭했을 때 이벤트를 수신하는 리스너.static interface
KakaoMap.OnTerrainClickListener
지도의 바닥(POI 가 아닌 부분) 부분을 클릭했을 때 이벤트를 수신하는 리스너.static interface
KakaoMap.OnTerrainLongClickListener
지도의 바닥(POI 가 아닌 부분) 부분을 롱 클릭했을 때 이벤트를 수신하는 리스너.static interface
KakaoMap.OnViewportChangeListener
Viewport 의 크기가 변경됐을 때 이벤트를 수신하는 리스너.static interface
KakaoMap.OnViewportClickListener
Viewport 를 클릭 했을 때 이벤트를 수신하는 리스너.static interface
KakaoMap.OnVisibleChangeListener
지도의 visible 변경이 있을 때 이벤트를 수신하는 리스너.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
canShowMapPoints(int zoomLevel, LatLng... points)
특정 ZoomLevel 에서 좌표들이 다 보여질 수 있는지 확인인다.void
changeMapType(MapType mapType)
지도의MapType
을 바꾼다.void
changeMapViewInfo(MapViewInfo mapViewInfo)
지도의MapViewInfo
를 바꾼다.void
clearAllCache()
캐쉬 된 지도 데이터를 삭제한다.void
clearDiskCache()
캐쉬 된 지도 데이터를 삭제한다.LatLng
fromScreenPoint(int x, int y)
지도화면(viewport) 스크린 상 위치에 해당하는 지리적 좌표를 가져온다.float
getBuildingHeightScale()
설정 된 건물 높이 비율을 가져온다.CameraPosition
getCameraPosition()
API 를 호출한 시점 이전에 진행 중인 카메라 관련 작업이 있어도 무시하고, API 를 호출한 시점의 CameraPosition 을 가져온다.void
getCameraPosition(KakaoMap.OnCameraPositionListener listener)
API 를 호출한 시점 이전에 진행 중인 카메라 관련 작업이 있다면, 모두 수행한 후 CameraPosition 을 가져온다.Compass
getCompass()
지도의 나침반을 컨트롤 하도록 나침반 객체를 가져온다.DimScreenManager
getDimScreenManager()
DimScreen 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.LabelManager
getLabelManager()
Label 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.Logo
getLogo()
지도의 법적 로고를 컨트롤 하도록 로고 객체를 가져온다.float
getMapDpScale()
픽셀 밀도가 서로 다른 화면에서 일정한 UI 크기를 유지하기 위해 지도 내부적으로 사용되는 dp 값을 가져온다.MapViewInfo
getMapViewInfo()
설정 한MapViewInfo
를 가져온다.MapWidgetManager
getMapWidgetManager()
MapWidget 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.int
getMaxMapLevel()
int
getMaxZoomLevel()
지도를 자세히 볼 수 있도록 지도를 최대한 확대(zoom in)할 수 있는 값.int
getMinMapLevel()
int
getMinZoomLevel()
가장 멀리서 지도를 볼 수 있도록 지도를 최대한 축소할 수 있는 값.Padding
getPadding()
setPadding(int, int, int, int)
에 의해 설정 된 Padding 값을 가져온다.RouteLineManager
getRouteLineManager()
RouteLine 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.ScaleBar
getScaleBar()
지도의 축척을 컨트롤 하도록 축척 객체를 가져온다.ShapeManager
getShapeManager()
Shape 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.java.lang.String[]
getSupportedLanguages()
지도에서 지원하는 POI 언어 배열을 가져온다.java.lang.Object
getTag()
KakaoMap
객체에 사용자가 설정한 태그를 가져온다.TrackingManager
getTrackingManager()
Tracking 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.java.lang.String
getViewName()
KakaoMap
객체를 구분하는 고유한 이름이다.Rect
getViewport()
지도가 보여지는 영역인 Viewport 영역을 Rect 로 가져온다.int
getZoomLevel()
현재 지도의 줌(zoom) 레벨 값을 가져온다.void
hideOverlay(MapOverlay overlay)
지도에서 제공하는 오버레이를 끈다.void
hideOverlay(java.lang.String overlayId)
지도에서 제공하는 오버레이를 끈다.boolean
isDev()
현재 API 가 테스트를 위한 개발용으로 설정되어 있는지 여부를 가져온다.boolean
isMapClickable()
지도의 클릭 가능 여부를 가져온다.boolean
isVisible()
현재 지도의 visible 설정을 가져온다.void
moveCamera(CameraUpdate cameraUpdate)
애니메이션 없이 카메라를 이동시켜 지도를 움직인다.void
moveCamera(CameraUpdate cameraUpdate, CameraAnimation cameraAnimation)
이동 애니메이션을 가지고 카메라를 이동시켜 지도를 움직인다.void
setBuildingHeightScale(float scale)
Scale(0.0 ~ 1.0) 값을 조절해서 건물 높이를 변경한다.void
setCameraAnimateEnable(boolean enable)
카메라의 애니메이션 여부를 설정한다.void
setFixedCenter(boolean enable, GestureType... gestureTypes)
제스쳐의 동작 기준점을 지도의 가운데로 고정시킨다.void
setGestureEnable(GestureType gestureType, boolean enable)
지도에서 사용할 수 있는 제스쳐 여부를 설정한다.void
setOnCameraMoveEndListener(KakaoMap.OnCameraMoveEndListener listener)
카메라 움직임이 끝난 후 이벤트를 수신하는 리스너를 등록한다.void
setOnCameraMoveStartListener(KakaoMap.OnCameraMoveStartListener listener)
카메라 움직임을 시작할 때 이벤트를 수신하는 리스너를 등록한다.void
setOnCompassClickListener(KakaoMap.OnCompassClickListener listener)
Compass
를 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.void
setOnInfoWindowClickListener(KakaoMap.OnInfoWindowClickListener listener)
InfoWindow
를 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.void
setOnLabelClickListener(KakaoMap.OnLabelClickListener listener)
Label
을 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.void
setOnLodLabelClickListener(KakaoMap.OnLodLabelClickListener listener)
LodLabel
을 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.void
setOnMapClickListener(KakaoMap.OnMapClickListener listener)
지도의 Terrain 또는 POI 를 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.void
setOnMapViewInfoChangeListener(KakaoMap.OnMapViewInfoChangeListener listener)
void
setOnMapWidgetClickListener(KakaoMap.OnMapWidgetClickListener listener)
MapWidget
을 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.void
setOnPaddingChangeListener(KakaoMap.OnPaddingChangeListener listener)
지도의 가장자리에 Padding 의 크기가 변경되면 이벤트를 수신하는 리스너를 등록한다.void
setOnPoiClickListener(KakaoMap.OnPoiClickListener listener)
지도의 POI 를 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.void
setOnTerrainClickListener(KakaoMap.OnTerrainClickListener listener)
지도의 POI 가 아닌 바닥을 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.void
setOnTerrainLongClickListener(KakaoMap.OnTerrainLongClickListener listener)
지도의 POI 가 아닌 바닥을 롱 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.void
setOnViewportChangeListener(KakaoMap.OnViewportChangeListener listener)
지도가 보여지는 Viewport 의 크기가 변경되면 이벤트를 수신하는 리스너를 등록한다.void
setOnViewportClickListener(KakaoMap.OnViewportClickListener listener)
지도가 보여지는 Viewport 영역을 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.void
setOnVisibleChangeListener(KakaoMap.OnVisibleChangeListener listener)
setVisible(boolean)
을 통해 지도의 visible 변경됐을 때 이벤트를 수신하는 리스너를 등록한다.void
setPadding(int left, int top, int right, int bottom)
지도의 viewport 가장자리에 padding 을 설정한다.void
setPoiClickable(boolean clickable)
지도의 POI 클릭 여부를 설정한다.boolean
setPoiLanguage(java.lang.String language)
지도의 POI 언어를 변경한다.void
setPoiScale(PoiScale scale)
지도 POI 의 크기를 변경한다.void
setPoiVisible(boolean visible)
지도 POI 의 visible 여부를 설정한다.void
setTag(java.lang.Object tag)
KakaoMap
객체에 사용자가 필요한 태그를 설정한다.void
setViewport(int width, int height)
지도가 보여지는 영역인 Viewport 의 width, height 를 변경한다.void
setViewport(int x, int y, int width, int height)
지도가 보여지는 영역인 Viewport 의 시작위치 x, y 와 width, height 를 변경한다.void
setViewport(Rect rect)
지도가 보여지는 영역인 Viewport 를 변경한다.void
setVisible(boolean visible)
지도의 visible 을 설정한다.void
showOverlay(MapOverlay overlay)
지도에서 제공하는 오버레이를 켠다.void
showOverlay(java.lang.String overlayId)
지도에서 제공하는 오버레이를 켠다.Point
toScreenPoint(LatLng position)
지리적 좌표(LatLng
)에 해당하는 지도화면(viewport) 스크린 상 위치를 가져온다.
-
-
-
Method Detail
-
isDev
public boolean isDev()
현재 API 가 테스트를 위한 개발용으로 설정되어 있는지 여부를 가져온다.- Returns:
- 기본값은 false 이다
-
getTag
@Nullable public java.lang.Object getTag()
KakaoMap
객체에 사용자가 설정한 태그를 가져온다.- Returns:
- 아무것도 설정 안했을 때, 기본값은 "" 빈 문자열이다
-
setTag
public void setTag(@Nullable java.lang.Object tag)
KakaoMap
객체에 사용자가 필요한 태그를 설정한다. 아무타입이나 넣을 수 있다.- Parameters:
tag
- 사용자가 설정한 태그 값
-
getViewName
@NonNull public java.lang.String getViewName()
KakaoMap
객체를 구분하는 고유한 이름이다.MapReadyCallback.getViewName()
을 통해 설정 할 수 있다. 따로 설정하지 않는다면, 자동으로 이름은 부여된다.- Returns:
KakaoMap
에 설정 된 고유한 이름. 기본값은 "" 빈 문자열이다
-
setVisible
public void setVisible(boolean visible)
지도의 visible 을 설정한다. 지도의 visible 설정 결과는KakaoMap.OnVisibleChangeListener
를 통해서 확인 할 수 있다. setVisible 호출하고 바로 getVisible 을 호출하면 설정한 대로 값이 안나올 수 있으니, visible 설정의 결과값을 확인할 때는KakaoMap.OnVisibleChangeListener
를 이용한다.- Parameters:
visible
- true 인 경우 지도가 나오고, false 인 경우 지도가 나오지 않는다
-
isVisible
@NonNull public boolean isVisible()
현재 지도의 visible 설정을 가져온다.- Returns:
- 지도의 visible 여부
-
setViewport
public void setViewport(int width, int height)
지도가 보여지는 영역인 Viewport 의 width, height 를 변경한다. 단위는 pixel 이다. Viewport 의 최대 width, height 값은MapView
의 width, height 이다. Viewport 의 최소 width, height 값은 1 이다. Viewport 는MapView
의 영역을 벗어나서 그려질 수 없다. 변경 된 Viewport 값은 바로getViewport()
로 확인할 수 없고,KakaoMap.OnViewportChangeListener
를 통해서 확인할 수 있다.
-
setViewport
public void setViewport(int x, int y, int width, int height)
지도가 보여지는 영역인 Viewport 의 시작위치 x, y 와 width, height 를 변경한다. 단위는 pixel 이다. Viewport 의 최대 width, height 값은MapView
의 width, height 이다. Viewport 의 최소 width, height 값은 1 이다. Viewport 의 시작위치 x, y 의 최소값은 0 이다. Viewport 의 시작위치 x, y 의 최대값은MapView
의 width-1, height-1 이다. Viewport 는MapView
의 영역을 벗어나서 그려질 수 없다. 변경 된 Viewport 값은 바로getViewport()
로 확인할 수 없고,KakaoMap.OnViewportChangeListener
를 통해서 확인할 수 있다.- Parameters:
x
- Viewport 영역의 x 시작 위치.MapView
의 left 가 기준점이다. 최소값은 0, 최대값은MapView
의 width - 1 이다.y
- Viewport 영역의 y 시작 위치.MapView
의 top 이 기준점이다. 최소값은 0, 최대값은MapView
의 height - 1 이다.width
- Viewport 의 가로 길이(px)를 변경한다. 최소값은 1, 최대값은MapView
의 width.height
- Viewport 의 세로 길이(px)를 변경한다. 최소값은 1, 최대값은MapView
의 height.
-
setViewport
public void setViewport(@NonNull Rect rect)
지도가 보여지는 영역인 Viewport 를 변경한다. 단위는 pixel 이다. Rect 의 left 와 top 은 Viewport 의 시작위치 x, y 와 같다.MapView
의 left, top 이 기준점이다. Rect 의 (right - left) 은 Viewport 가로 width 길이와 같다. Rect 의 (bottom - top) 은 Viewport 세로 height 길이와 같다. Viewport 는MapView
의 영역을 벗어나서 그려질 수 없다. 변경 된 Viewport 값은 바로getViewport()
로 확인할 수 없고,KakaoMap.OnViewportChangeListener
를 통해서 확인할 수 있다.- Parameters:
rect
- 변경하려는 Viewport 의 영역. 단위는 pixel 이다. Rect 의 left 와 top 은 Viewport 의 시작위치 x, y 와 같다. Rect 의 (right - left) 은 Viewport 가로 width 길이와 같다. Rect 의 (bottom - top) 은 Viewport 세로 height 길이와 같다.
-
getViewport
@NonNull public Rect getViewport()
지도가 보여지는 영역인 Viewport 영역을 Rect 로 가져온다. 단위는 pixel 이다.setPadding(int, int, int, int)
으로 패딩이 설정되어 있다면, 패딩 처리 된 영역으로 가져온다. Rect 의 left 와 top 은 Viewport 의 시작위치 x, y 와 같다.MapView
의 left, top 이 기준점이다. Rect 의 (right - left) 은 Viewport 가로 width 길이와 같다. Rect 의 (bottom - top) 은 Viewport 세로 height 길이와 같다. 예외 발생 시, Rect(0, 0, 0, 0) 값으로 대체된다. 변경 된 Viewport 값은 바로getViewport()
로 확인할 수 없고,KakaoMap.OnViewportChangeListener
를 통해서 확인할 수 있다.- Returns:
- 지도가 보여지는 영역인 Viewport 영역. 예외 발생 시, Rect(0, 0, 0, 0) 값으로 대체된다.
-
setPadding
public void setPadding(int left, int top, int right, int bottom)
지도의 viewport 가장자리에 padding 을 설정한다. 지도에 Padding 영역을 지정하면 패딩 처리된 영역의 중심이 카메라의 중심이 된다.Logo
,Compass
,ScaleBar
의 위치는 패딩의 영향을 받는다. Padding 의 크기는 Viewport 의 전체 크기를 넘을 수 없고, padding 값의 단위는 px 이다.- Parameters:
left
- viewport 의 왼쪽에 padding 을 준다. 단위는 px.top
- viewport 의 위쪽에 padding 을 준다. 단위는 px.right
- viewport 의 오른쪽에 padding 을 준다. 단위는 px.bottom
- viewport 의 아래쪽에 padding 을 준다. 단위는 px.
-
getPadding
@NonNull public Padding getPadding()
setPadding(int, int, int, int)
에 의해 설정 된 Padding 값을 가져온다. 아무것도 설정하지 않았다면 기본값은 left = 0, top = 0, right = 0, bottom = 0 이다.- Returns:
- Padding 값. 예외 발생 시 기본값인 left = 0, top = 0, right = 0, bottom = 0 으로 된다.
-
getZoomLevel
@NonNull public int getZoomLevel()
현재 지도의 줌(zoom) 레벨 값을 가져온다. 값이 높을수록 지도가 확대(zoom in)되고, 값이 낮을수록 지도가 축소(zoom out)된다.- Returns:
- 현재 지도의 줌(zoom) 레벨 값.
-
getMaxMapLevel
@NonNull public int getMaxMapLevel()
-
getMinMapLevel
@NonNull public int getMinMapLevel()
-
getMaxZoomLevel
@NonNull public int getMaxZoomLevel()
지도를 자세히 볼 수 있도록 지도를 최대한 확대(zoom in)할 수 있는 값. 값이 높을수록 지도가 확대(zoom in)되고, 값이 낮을수록 지도가 축소(zoom out)된다.- Returns:
- 지도를 최대한 확대(zoom in) 할 수 있는 값.
-
getMinZoomLevel
@NonNull public int getMinZoomLevel()
가장 멀리서 지도를 볼 수 있도록 지도를 최대한 축소할 수 있는 값. 값이 높을수록 지도가 확대(zoom in)되고, 값이 낮을수록 지도가 축소(zoom out)된다.- Returns:
- 지도의 최대로 축소(zoom out) 될 수 있는 값.
-
fromScreenPoint
@Nullable public LatLng fromScreenPoint(int x, int y)
지도화면(viewport) 스크린 상 위치에 해당하는 지리적 좌표를 가져온다.- Parameters:
x
- 지도화면 지도화면(viewport) 스크린 상의 x 위치 값.y
- 지도화면 지도화면(viewport) 스크린 상의 y 위치 값.- Returns:
- 지도화면 지도화면(viewport) 스크린 상의 x, y 에 해당하는 지리적 좌표 값(
LatLng
). 예외 발생 시, null 이 반환된다.
-
toScreenPoint
@Nullable public Point toScreenPoint(LatLng position)
지리적 좌표(LatLng
)에 해당하는 지도화면(viewport) 스크린 상 위치를 가져온다.- Parameters:
position
- 지도 상의 지리적 좌표 값.- Returns:
- 스크린 상의 위치 값(x, y). 예외 발생 시, null 이 반환된다.
-
getCameraPosition
@Nullable public CameraPosition getCameraPosition()
API 를 호출한 시점 이전에 진행 중인 카메라 관련 작업이 있어도 무시하고, API 를 호출한 시점의 CameraPosition 을 가져온다.- Returns:
- API 를 호출한 시점의 CameraPosition. 예외 발생 시, null 이 반환된다.
-
getCameraPosition
public void getCameraPosition(@NonNull KakaoMap.OnCameraPositionListener listener)
API 를 호출한 시점 이전에 진행 중인 카메라 관련 작업이 있다면, 모두 수행한 후 CameraPosition 을 가져온다.- Parameters:
listener
-CameraPosition
값을 전달 받을 리스너.
-
moveCamera
public void moveCamera(@NonNull CameraUpdate cameraUpdate)
애니메이션 없이 카메라를 이동시켜 지도를 움직인다. 카메라 이동이 진행 중인게 있다면 바로 취소되고 새롭게 이동된다.- Parameters:
cameraUpdate
- 이동 할 CameraUpdate 객체.CameraUpdateFactory
를 통해서 생성한다.
-
moveCamera
public void moveCamera(@NonNull CameraUpdate cameraUpdate, @Nullable CameraAnimation cameraAnimation)
이동 애니메이션을 가지고 카메라를 이동시켜 지도를 움직인다.- Parameters:
cameraUpdate
-CameraUpdateFactory
를 통해서 생성 된 이동 할 CameraUpdate 객체cameraAnimation
- 설정 할 카메라의 이동 애니메이션 객체
-
setBuildingHeightScale
public void setBuildingHeightScale(float scale)
Scale(0.0 ~ 1.0) 값을 조절해서 건물 높이를 변경한다. Scale 기본값은 1 이다. 0 으로 갈 수록 작아지고 1로 갈 수록 높아진다.- Parameters:
scale
- 조절 할 건물 높이 비율 (0.1 ~ 1.0)
-
getBuildingHeightScale
@NonNull public float getBuildingHeightScale()
설정 된 건물 높이 비율을 가져온다.- Returns:
- 건물 높이 비율 (0.1 ~ 1.0), 예외 발생 시 기본값인 1 이 반환
-
getCompass
@Nullable public Compass getCompass()
지도의 나침반을 컨트롤 하도록 나침반 객체를 가져온다.- Returns:
- 지도의 나침반을 컨트롤 할 수 있는 나침반 객체, 예외 발생 시 null
-
getLogo
@Nullable public Logo getLogo()
지도의 법적 로고를 컨트롤 하도록 로고 객체를 가져온다.- Returns:
- 지도의 법적 로고를 컨트롤 할 수 있는 로고 객체, 예외 발생 시 null
-
getScaleBar
@Nullable public ScaleBar getScaleBar()
지도의 축척을 컨트롤 하도록 축척 객체를 가져온다.- Returns:
- 지도의 축척을 컨트롤 할 수 있는 축척 객체, 예외 발생 시 null
-
setOnViewportClickListener
public void setOnViewportClickListener(@Nullable KakaoMap.OnViewportClickListener listener)
지도가 보여지는 Viewport 영역을 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.- Parameters:
listener
- 지도가 보여지는 Viewport 영역을 클릭했을 때 클릭 이벤트를 수신하는 리스너, null 을 넣으면 리스너 해제
-
setOnPoiClickListener
public void setOnPoiClickListener(@Nullable KakaoMap.OnPoiClickListener listener)
지도의 POI 를 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.- Parameters:
listener
- 지도의 POI 를 클릭했을 때 클릭 이벤트를 수신하는 리스너, null 을 넣으면 리스너 해제
-
setOnViewportChangeListener
public void setOnViewportChangeListener(@Nullable KakaoMap.OnViewportChangeListener listener)
지도가 보여지는 Viewport 의 크기가 변경되면 이벤트를 수신하는 리스너를 등록한다.- Parameters:
listener
- 지도가 보여지는 Viewport 의 크기가 변경되면 이벤트를 수신하는 리스너, null 을 넣으면 리스너 해제
-
setOnPaddingChangeListener
public void setOnPaddingChangeListener(@Nullable KakaoMap.OnPaddingChangeListener listener)
지도의 가장자리에 Padding 의 크기가 변경되면 이벤트를 수신하는 리스너를 등록한다.- Parameters:
listener
- 지도의 가장자리에 Padding 의 크기가 변경되면 이벤트를 수신하는 리스너, null 을 넣으면 리스너 해제
-
setOnMapClickListener
public void setOnMapClickListener(@Nullable KakaoMap.OnMapClickListener listener)
지도의 Terrain 또는 POI 를 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.- Parameters:
listener
- 지도의 Terrain 또는 POI 를 클릭했을 때 클릭 이벤트를 수신하는 리스너, null 을 넣으면 리스너 해제
-
setOnTerrainClickListener
public void setOnTerrainClickListener(@Nullable KakaoMap.OnTerrainClickListener listener)
지도의 POI 가 아닌 바닥을 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.- Parameters:
listener
- 지도의 POI 가 아닌 바닥을 클릭했을 때 클릭 이벤트를 수신하는 리스너, null 을 넣으면 리스너 해제
-
setOnTerrainLongClickListener
public void setOnTerrainLongClickListener(@Nullable KakaoMap.OnTerrainLongClickListener listener)
지도의 POI 가 아닌 바닥을 롱 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.- Parameters:
listener
- 지도의 POI 가 아닌 바닥을 롱 클릭했을 때 클릭 이벤트를 수신하는 리스너, null 을 넣으면 리스너 해제
-
setOnVisibleChangeListener
public void setOnVisibleChangeListener(@Nullable KakaoMap.OnVisibleChangeListener listener)
setVisible(boolean)
을 통해 지도의 visible 변경됐을 때 이벤트를 수신하는 리스너를 등록한다.- Parameters:
listener
-setVisible(boolean)
을 통해 지도의 visible 변경됐을 때 이벤트를 수신하는 리스너, null 을 넣으면 리스너 해제
-
setOnCameraMoveStartListener
public void setOnCameraMoveStartListener(@Nullable KakaoMap.OnCameraMoveStartListener listener)
카메라 움직임을 시작할 때 이벤트를 수신하는 리스너를 등록한다.- Parameters:
listener
- 카메라가 움직임을 시작할 때 이벤트를 수신하는 리스너, null 을 넣으면 리스너 해제
-
setOnCameraMoveEndListener
public void setOnCameraMoveEndListener(@Nullable KakaoMap.OnCameraMoveEndListener listener)
카메라 움직임이 끝난 후 이벤트를 수신하는 리스너를 등록한다.- Parameters:
listener
- 카메라 움직임이 끝난 후 이벤트를 수신하는 리스너, null 을 넣으면 리스너 해제
-
setOnLabelClickListener
public void setOnLabelClickListener(@Nullable KakaoMap.OnLabelClickListener listener)
Label
을 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.- Parameters:
listener
-Label
을 클릭했을 때 클릭 이벤트를 수신하는 리스너, null 을 넣으면 리스너 해제
-
setOnLodLabelClickListener
public void setOnLodLabelClickListener(@Nullable KakaoMap.OnLodLabelClickListener listener)
LodLabel
을 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.- Parameters:
listener
-LodLabel
을 클릭했을 때 클릭 이벤트를 수신하는 리스너, null 을 넣으면 리스너 해제
-
setOnInfoWindowClickListener
public void setOnInfoWindowClickListener(@Nullable KakaoMap.OnInfoWindowClickListener listener)
InfoWindow
를 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.- Parameters:
listener
-InfoWindow
를 클릭했을 때 클릭 이벤트를 수신하는 리스너, null 을 넣으면 리스너 해제
-
setOnMapWidgetClickListener
public void setOnMapWidgetClickListener(@Nullable KakaoMap.OnMapWidgetClickListener listener)
MapWidget
을 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.- Parameters:
listener
-MapWidget
을 클릭했을 때 클릭 이벤트를 수신하는 리스너, null 을 넣으면 리스너 해제
-
setOnCompassClickListener
public void setOnCompassClickListener(@Nullable KakaoMap.OnCompassClickListener listener)
Compass
를 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.- Parameters:
listener
-Compass
를 클릭했을 때 클릭 이벤트를 수신하는 리스너, null 을 넣으면 리스너 해제
-
setOnMapViewInfoChangeListener
public void setOnMapViewInfoChangeListener(@Nullable KakaoMap.OnMapViewInfoChangeListener listener)
-
getRouteLineManager
@Nullable public RouteLineManager getRouteLineManager()
RouteLine 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.- Returns:
- RouteLine 과 관련된 모든 컨트롤을 할 수 있는 매니저, 예외 발생 시 null
-
getLabelManager
@Nullable public LabelManager getLabelManager()
Label 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.- Returns:
- Label 과 관련된 모든 컨트롤을 할 수 있는 매니저, 예외 발생 시 null
-
getShapeManager
@Nullable public ShapeManager getShapeManager()
Shape 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.- Returns:
- Shape 과 관련된 모든 컨트롤을 할 수 있는 매니저, 예외 발생 시 null
-
getDimScreenManager
@Nullable public DimScreenManager getDimScreenManager()
DimScreen 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.- Returns:
- DimScreen 과 관련 된 모든 컨트롤을 할 수 있는 매니저, 예외 발생 시 null
-
getTrackingManager
@Nullable public TrackingManager getTrackingManager()
Tracking 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.- Returns:
- Tracking 과 관련 된 모든 컨트롤을 할 수 있는 매니저, 예외 발생 시 null
-
setFixedCenter
public void setFixedCenter(boolean enable, GestureType... gestureTypes)
제스쳐의 동작 기준점을 지도의 가운데로 고정시킨다.- Parameters:
enable
- 지도의 가운데로 고정시킬지 여부gestureTypes
- 제스쳐 타입 배열
-
setCameraAnimateEnable
public void setCameraAnimateEnable(boolean enable)
카메라의 애니메이션 여부를 설정한다.- Parameters:
enable
- 카메라의 애니메이션 여부
-
setGestureEnable
public void setGestureEnable(@NonNull GestureType gestureType, boolean enable)
지도에서 사용할 수 있는 제스쳐 여부를 설정한다.- Parameters:
gestureType
- 설정 할 제스쳐 타입enable
- 지도에서 사용할지 여부
-
canShowMapPoints
@NonNull public boolean canShowMapPoints(int zoomLevel, LatLng... points)
특정 ZoomLevel 에서 좌표들이 다 보여질 수 있는지 확인인다.- Parameters:
zoomLevel
- 지도의 ZoomLevel 값points
- 확인하고자 하는 위치 좌표 배열
-
getMapDpScale
@NonNull public float getMapDpScale()
픽셀 밀도가 서로 다른 화면에서 일정한 UI 크기를 유지하기 위해 지도 내부적으로 사용되는 dp 값을 가져온다.- Returns:
- 지도 내부적으로 사용되는 dp 값, 예외 발생 시 -1
-
getMapWidgetManager
@Nullable public MapWidgetManager getMapWidgetManager()
MapWidget 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.- Returns:
- MapWidget 과 관련 된 모든 컨트롤을 할 수 있는 매니저, 예외 발생 시 null
-
showOverlay
public void showOverlay(@NonNull java.lang.String overlayId)
지도에서 제공하는 오버레이를 켠다. 오버레이(id)에는 교통정보("traffic_info"), 로드뷰라인("roadview_line"), 자전거도로("bicycle_road"), 지형도("hill_shading") 이 있다.- Parameters:
overlayId
- 오버레이 Id
-
showOverlay
public void showOverlay(@NonNull MapOverlay overlay)
지도에서 제공하는 오버레이를 켠다.- Parameters:
overlay
-MapOverlay
-
hideOverlay
public void hideOverlay(@NonNull java.lang.String overlayId)
지도에서 제공하는 오버레이를 끈다. 오버레이(id)에는 교통정보("traffic_info"), 로드뷰라인("roadview_line"), 자전거도로("bicycle_road"), 지형도("hill_shading") 이 있다.- Parameters:
overlayId
- 오버레이 Id
-
hideOverlay
public void hideOverlay(@NonNull MapOverlay overlay)
지도에서 제공하는 오버레이를 끈다.- Parameters:
overlay
-MapOverlay
-
changeMapViewInfo
public void changeMapViewInfo(@NonNull MapViewInfo mapViewInfo)
지도의MapViewInfo
를 바꾼다.- Parameters:
mapViewInfo
- 바꾸려는 mapViewInfo. null 일 경우, 에러 로그 출력 후 더이상 진행하지 않는다
-
changeMapType
public void changeMapType(@NonNull MapType mapType)
지도의MapType
을 바꾼다. 앱 이름(appName)은 기존의 설정된 대로 따른다.- Parameters:
mapType
- 바꾸려는 MapType
-
getMapViewInfo
@Nullable public MapViewInfo getMapViewInfo()
설정 한MapViewInfo
를 가져온다.- Returns:
- 설정 한 MapViewInfo
-
setPoiClickable
public void setPoiClickable(boolean clickable)
지도의 POI 클릭 여부를 설정한다.- Parameters:
clickable
- 클릭 여부
-
setPoiVisible
public void setPoiVisible(boolean visible)
지도 POI 의 visible 여부를 설정한다.- Parameters:
visible
- visible 여부
-
setPoiLanguage
public boolean setPoiLanguage(@NonNull java.lang.String language)
지도의 POI 언어를 변경한다. 한국어는 "ko", 영어는 "en"- Parameters:
language
- 변경 할 POI 언어
-
getSupportedLanguages
@Nullable public java.lang.String[] getSupportedLanguages()
지도에서 지원하는 POI 언어 배열을 가져온다.- Returns:
- 지도에서 지원하는 POI 언어 배열
-
setPoiScale
public void setPoiScale(@NonNull PoiScale scale)
지도 POI 의 크기를 변경한다.- Parameters:
scale
- 변경 할 POI 의 크기 값
-
isMapClickable
@NonNull public boolean isMapClickable()
지도의 클릭 가능 여부를 가져온다.- Returns:
- 지도의 클릭 여부
-
clearDiskCache
public void clearDiskCache()
캐쉬 된 지도 데이터를 삭제한다.
-
clearAllCache
public void clearAllCache()
캐쉬 된 지도 데이터를 삭제한다.
-
-