Package com.kakao.vectormap
Class KakaoMap
- java.lang.Object
-
- com.kakao.vectormap.KakaoMap
-
public final class KakaoMap extends java.lang.ObjectKakaoMaps SDK for Android 의 메인 클래스이며 지도와 관련 된 모든 함수와 연결 된 진입점 이다. KakaoMap 객체는 직접 생성 할 수 없으며,MapView#start(KakaoMapReadyCallback)을 통해 가져 올 수 있다.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceKakaoMap.OnCameraMoveEndListener카메라의 이동 종료 이벤트 리스너static interfaceKakaoMap.OnCameraMoveStartListener카메라의 이동 시작 이벤트 리스너static interfaceKakaoMap.OnCameraPositionListener지도 중심을 바라보는 가장 최신의 카메라 위치 값을 수신하는 리스너static interfaceKakaoMap.OnCompassClickListenerCompass를 클릭했을 때 클릭 이벤트를 수신하는 리스너static interfaceKakaoMap.OnInfoWindowClickListenerInfoWindow를 클릭했을 때 이벤트를 수신하는 리스너static interfaceKakaoMap.OnLabelClickListenerLabel을 클릭했을 때 이벤트를 수신하는 리스너.static interfaceKakaoMap.OnLodLabelClickListenerLodLabel을 클릭했을 때 이벤트를 수신하는 리스너static interfaceKakaoMap.OnMapClickListener지도판을 클릭 했을 때 이벤트를 수신하는 리스너.static interfaceKakaoMap.OnMapViewInfoChangeListenerMapViewInfo또는MapType변경 됐을 때 이벤트를 수신하는 리스너static interfaceKakaoMap.OnMapWidgetClickListenerMapWidget를 클릭했을 때 이벤트를 수신하는 리스너static interfaceKakaoMap.OnPaddingChangeListenerViewport 의 Padding 이 변경 됐을 때 이벤트를 수신하는 리스너static interfaceKakaoMap.OnPoiClickListener지도판의 POI 를 클릭했을 때 이벤트를 수신하는 리스너.static interfaceKakaoMap.OnTerrainClickListener지도의 바닥(POI 가 아닌 부분) 부분을 클릭했을 때 이벤트를 수신하는 리스너.static interfaceKakaoMap.OnTerrainLongClickListener지도의 바닥(POI 가 아닌 부분) 부분을 롱 클릭했을 때 이벤트를 수신하는 리스너.static interfaceKakaoMap.OnViewportChangeListenerViewport 의 크기가 변경됐을 때 이벤트를 수신하는 리스너.static interfaceKakaoMap.OnViewportClickListenerViewport 를 클릭 했을 때 이벤트를 수신하는 리스너.static interfaceKakaoMap.OnVisibleChangeListener지도의 visible 변경이 있을 때 이벤트를 수신하는 리스너.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description booleancanShowMapPoints(int zoomLevel, LatLng... points)특정 ZoomLevel 에서 좌표들이 다 보여질 수 있는지 확인인다.voidchangeMapType(MapType mapType)지도의MapType을 바꾼다.voidchangeMapViewInfo(MapViewInfo mapViewInfo)지도의MapViewInfo를 바꾼다.voidclearAllCache()캐쉬 된 지도 데이터를 삭제한다.voidclearDiskCache()캐쉬 된 지도 데이터를 삭제한다.LatLngfromScreenPoint(int x, int y)지도화면(viewport) 스크린 상 위치에 해당하는 지리적 좌표를 가져온다.floatgetBuildingHeightScale()설정 된 건물 높이 비율을 가져온다.CameraPositiongetCameraPosition()API 를 호출한 시점 이전에 진행 중인 카메라 관련 작업이 있어도 무시하고, API 를 호출한 시점의 CameraPosition 을 가져온다.voidgetCameraPosition(KakaoMap.OnCameraPositionListener listener)API 를 호출한 시점 이전에 진행 중인 카메라 관련 작업이 있다면, 모두 수행한 후 CameraPosition 을 가져온다.CompassgetCompass()지도의 나침반을 컨트롤 하도록 나침반 객체를 가져온다.DimScreenManagergetDimScreenManager()DimScreen 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.LabelManagergetLabelManager()Label 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.LogogetLogo()지도의 법적 로고를 컨트롤 하도록 로고 객체를 가져온다.floatgetMapDpScale()픽셀 밀도가 서로 다른 화면에서 일정한 UI 크기를 유지하기 위해 지도 내부적으로 사용되는 dp 값을 가져온다.MapViewInfogetMapViewInfo()설정 한MapViewInfo를 가져온다.MapWidgetManagergetMapWidgetManager()MapWidget 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.intgetMaxMapLevel()intgetMaxZoomLevel()지도를 자세히 볼 수 있도록 지도를 최대한 확대(zoom in)할 수 있는 값.intgetMinMapLevel()intgetMinZoomLevel()가장 멀리서 지도를 볼 수 있도록 지도를 최대한 축소할 수 있는 값.PaddinggetPadding()setPadding(int, int, int, int)에 의해 설정 된 Padding 값을 가져온다.RouteLineManagergetRouteLineManager()RouteLine 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.ScaleBargetScaleBar()지도의 축척을 컨트롤 하도록 축척 객체를 가져온다.ShapeManagergetShapeManager()Shape 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.java.lang.String[]getSupportedLanguages()지도에서 지원하는 POI 언어 배열을 가져온다.java.lang.ObjectgetTag()KakaoMap객체에 사용자가 설정한 태그를 가져온다.TrackingManagergetTrackingManager()Tracking 과 관련 된 모든 컨트롤을 할 수 있는 매니저를 가져온다.java.lang.StringgetViewName()KakaoMap객체를 구분하는 고유한 이름이다.RectgetViewport()지도가 보여지는 영역인 Viewport 영역을 Rect 로 가져온다.intgetZoomLevel()현재 지도의 줌(zoom) 레벨 값을 가져온다.voidhideOverlay(MapOverlay overlay)지도에서 제공하는 오버레이를 끈다.voidhideOverlay(java.lang.String overlayId)지도에서 제공하는 오버레이를 끈다.booleanisDev()현재 API 가 테스트를 위한 개발용으로 설정되어 있는지 여부를 가져온다.booleanisMapClickable()지도의 클릭 가능 여부를 가져온다.booleanisVisible()현재 지도의 visible 설정을 가져온다.voidmoveCamera(CameraUpdate cameraUpdate)애니메이션 없이 카메라를 이동시켜 지도를 움직인다.voidmoveCamera(CameraUpdate cameraUpdate, CameraAnimation cameraAnimation)이동 애니메이션을 가지고 카메라를 이동시켜 지도를 움직인다.voidsetBuildingHeightScale(float scale)Scale(0.0 ~ 1.0) 값을 조절해서 건물 높이를 변경한다.voidsetCameraAnimateEnable(boolean enable)카메라의 애니메이션 여부를 설정한다.voidsetFixedCenter(boolean enable, GestureType... gestureTypes)제스쳐의 동작 기준점을 지도의 가운데로 고정시킨다.voidsetGestureEnable(GestureType gestureType, boolean enable)지도에서 사용할 수 있는 제스쳐 여부를 설정한다.voidsetOnCameraMoveEndListener(KakaoMap.OnCameraMoveEndListener listener)카메라 움직임이 끝난 후 이벤트를 수신하는 리스너를 등록한다.voidsetOnCameraMoveStartListener(KakaoMap.OnCameraMoveStartListener listener)카메라 움직임을 시작할 때 이벤트를 수신하는 리스너를 등록한다.voidsetOnCompassClickListener(KakaoMap.OnCompassClickListener listener)Compass를 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.voidsetOnInfoWindowClickListener(KakaoMap.OnInfoWindowClickListener listener)InfoWindow를 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.voidsetOnLabelClickListener(KakaoMap.OnLabelClickListener listener)Label을 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.voidsetOnLodLabelClickListener(KakaoMap.OnLodLabelClickListener listener)LodLabel을 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.voidsetOnMapClickListener(KakaoMap.OnMapClickListener listener)지도의 Terrain 또는 POI 를 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.voidsetOnMapViewInfoChangeListener(KakaoMap.OnMapViewInfoChangeListener listener)voidsetOnMapWidgetClickListener(KakaoMap.OnMapWidgetClickListener listener)MapWidget을 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.voidsetOnPaddingChangeListener(KakaoMap.OnPaddingChangeListener listener)지도의 가장자리에 Padding 의 크기가 변경되면 이벤트를 수신하는 리스너를 등록한다.voidsetOnPoiClickListener(KakaoMap.OnPoiClickListener listener)지도의 POI 를 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.voidsetOnTerrainClickListener(KakaoMap.OnTerrainClickListener listener)지도의 POI 가 아닌 바닥을 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.voidsetOnTerrainLongClickListener(KakaoMap.OnTerrainLongClickListener listener)지도의 POI 가 아닌 바닥을 롱 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.voidsetOnViewportChangeListener(KakaoMap.OnViewportChangeListener listener)지도가 보여지는 Viewport 의 크기가 변경되면 이벤트를 수신하는 리스너를 등록한다.voidsetOnViewportClickListener(KakaoMap.OnViewportClickListener listener)지도가 보여지는 Viewport 영역을 클릭했을 때 클릭 이벤트를 수신하는 리스너를 등록한다.voidsetOnVisibleChangeListener(KakaoMap.OnVisibleChangeListener listener)setVisible(boolean)을 통해 지도의 visible 변경됐을 때 이벤트를 수신하는 리스너를 등록한다.voidsetPadding(int left, int top, int right, int bottom)지도의 viewport 가장자리에 padding 을 설정한다.voidsetPoiClickable(boolean clickable)지도의 POI 클릭 여부를 설정한다.booleansetPoiLanguage(java.lang.String language)지도의 POI 언어를 변경한다.voidsetPoiScale(PoiScale scale)지도 POI 의 크기를 변경한다.voidsetPoiVisible(boolean visible)지도 POI 의 visible 여부를 설정한다.voidsetTag(java.lang.Object tag)KakaoMap객체에 사용자가 필요한 태그를 설정한다.voidsetViewport(int width, int height)지도가 보여지는 영역인 Viewport 의 width, height 를 변경한다.voidsetViewport(int x, int y, int width, int height)지도가 보여지는 영역인 Viewport 의 시작위치 x, y 와 width, height 를 변경한다.voidsetViewport(Rect rect)지도가 보여지는 영역인 Viewport 를 변경한다.voidsetVisible(boolean visible)지도의 visible 을 설정한다.voidshowOverlay(MapOverlay overlay)지도에서 제공하는 오버레이를 켠다.voidshowOverlay(java.lang.String overlayId)지도에서 제공하는 오버레이를 켠다.PointtoScreenPoint(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()
캐쉬 된 지도 데이터를 삭제한다.
-
-