GoogleMap

공개 최종 클래스 GoogleMap Object
확장

Android용 Google Maps SDK의 기본 클래스이며 지도와 관련된 모든 메서드의 진입점입니다. GoogleMap 객체는 직접 인스턴스화할 수 없으며 대신 애플리케이션에 추가한 MapFragment 또는 MapViewgetMapAsync() 메서드에서 가져와야 합니다.

참고: View 객체와 마찬가지로 GoogleMap는 Android UI 스레드에서만 읽고 수정할 수 있습니다. 다른 스레드에서 GoogleMap 메서드를 호출하면 예외가 발생합니다.

지도를 이동하는 대신 카메라의 위치를 변경하여 지도의 시점을 조정할 수 있습니다. 지도의 카메라를 사용하여 위치, 확대/축소 수준, 기울기 각도, 방위와 같은 매개변수를 설정할 수 있습니다. 자세한 내용은 카메라 및 뷰를 참고하세요.

개발자 가이드

시작하려면 Android용 Google Maps SDK 개발자 가이드를 읽어보세요.

중첩된 클래스 요약

인터페이스 GoogleMap.CancelableCallback 작업 완료 또는 취소 시 보고를 위한 콜백 인터페이스입니다. 
인터페이스 GoogleMap.InfoWindowAdapter 정보 창의 맞춤 렌더링을 위한 뷰를 제공합니다. 
인터페이스 GoogleMap.OnCameraChangeListener 이 인터페이스는 지원 중단되었습니다. GoogleMap.OnCameraMoveStartedListener, GoogleMap.OnCameraMoveListener, GoogleMap.OnCameraIdleListener로 대체되었습니다. 새 카메라 변경 리스너의 메서드와 관련하여 지원 중단된 onCameraChange 메서드가 호출되는 순서는 정의되어 있지 않습니다.  
인터페이스 GoogleMap.OnCameraIdleListener 카메라 이동이 종료된 경우에 대한 콜백 인터페이스입니다. 
인터페이스 GoogleMap.OnCameraMoveCanceledListener 카메라 움직임이 중지되었거나 새로운 이유로 카메라가 움직이기 시작하는 경우에 대한 콜백 인터페이스입니다. 
인터페이스 GoogleMap.OnCameraMoveListener 카메라의 위치가 변경되는 경우에 대한 콜백 인터페이스입니다. 
인터페이스 GoogleMap.OnCameraMoveStartedListener 카메라 모션이 시작될 때 사용되는 콜백 인터페이스입니다. 
인터페이스 GoogleMap.OnCircleClickListener 원을 클릭했을 때의 콜백 인터페이스입니다. 
인터페이스 GoogleMap.OnGroundOverlayClickListener 지면 오버레이가 클릭되는 경우에 대한 콜백 인터페이스입니다. 
인터페이스 GoogleMap.OnIndoorStateChangeListener 실내 상태가 변경되는 경우의 리스너입니다. 
인터페이스 GoogleMap.OnInfoWindowClickListener 마커의 정보 창에서 클릭/탭 이벤트를 위한 콜백 인터페이스입니다. 
인터페이스 GoogleMap.OnInfoWindowCloseListener 마커의 정보 창 닫기 이벤트에 대한 콜백 인터페이스. 
인터페이스 GoogleMap.OnInfoWindowLongClickListener 사용자가 마커의 정보 창을 길게 누를 때 사용되는 콜백 인터페이스입니다. 
인터페이스 GoogleMap.OnMapClickListener 사용자가 지도를 탭할 때의 콜백 인터페이스입니다. 
인터페이스 GoogleMap.OnMapLoadedCallback 지도의 렌더링이 완료된 경우를 위한 콜백 인터페이스입니다. 
인터페이스 GoogleMap.OnMapLongClickListener 사용자가 지도를 길게 누를 때의 콜백 인터페이스입니다. 
인터페이스 GoogleMap.OnMarkerClickListener 마커를 클릭하거나 탭할 때 호출되는 메서드의 서명을 정의합니다. 
인터페이스 GoogleMap.OnMarkerDragListener 마커의 드래그 이벤트에 대한 콜백 인터페이스입니다. 
인터페이스 GoogleMap.OnMyLocationButtonClickListener My Location 버튼이 클릭될 때의 콜백 인터페이스입니다. 
인터페이스 GoogleMap.OnMyLocationChangeListener 이 인터페이스는 지원 중단되었습니다. 대신 com.google.android.gms.location.FusedLocationProviderApi를 사용하세요. FusedLocationProviderApi는 향상된 위치 찾기와 전력 사용량을 제공하며 '내 위치' 파란색 점에서 사용합니다. FusedLocationProviderApi를 사용하는 현재 장소 선택 튜토리얼 또는 위치 개발자 가이드를 참고하세요.  
인터페이스 GoogleMap.OnMyLocationClickListener 내 위치 점 (사용자의 위치를 나타냄)이 클릭되었을 때의 콜백 인터페이스입니다. 
인터페이스 GoogleMap.OnPoiClickListener 관심 장소 탭에 대한 리스너입니다. 
인터페이스 GoogleMap.OnPolygonClickListener 다각형이 클릭되는 경우에 대한 콜백 인터페이스입니다. 
인터페이스 GoogleMap.OnPolylineClickListener 다중선을 클릭하는 경우에 대한 콜백 인터페이스입니다. 
인터페이스 GoogleMap.SnapshotReadyCallback 스냅샷을 촬영했을 때 알림을 받는 콜백 인터페이스입니다. 

상수 요약

int MAP_TYPE_HYBRID 주요 거리가 투명 레이어로 표시된 위성 지도입니다.
int MAP_TYPE_NONE 기본 지도 타일이 없습니다.
int MAP_TYPE_NORMAL 기본 지도
int MAP_TYPE_SATELLITE 라벨이 없는 위성 지도입니다.
int MAP_TYPE_TERRAIN 지형 지도

공개 메서드 요약

Circle
addCircle(CircleOptions 옵션)
지도에 원을 추가합니다.
GroundOverlay
addGroundOverlay(GroundOverlayOptions 옵션)
이 지도에 이미지를 추가합니다.
Marker
addMarker(MarkerOptions 옵션)
이 지도에 마커를 추가합니다.
Polygon
addPolygon(PolygonOptions 옵션)
이 지도에 다각형을 추가합니다.
Polyline
addPolyline(PolylineOptions 옵션)
이 지도에 폴리라인을 추가합니다.
TileOverlay
addTileOverlay(TileOverlayOptions 옵션)
이 지도에 타일 오버레이를 추가합니다.
void
animateCamera(CameraUpdate 업데이트)
현재 위치에서 업데이트에 정의된 위치로 카메라가 이동하는 것을 애니메이션으로 보여줍니다.
void
animateCamera(CameraUpdate 업데이트, GoogleMap.CancelableCallback 콜백)
현재 위치에서 업데이트에 정의된 위치로 카메라의 이동을 애니메이션 처리하고 완료 시 선택적 콜백을 호출합니다.
void
animateCamera(CameraUpdate 업데이트, int durationMs, GoogleMap.CancelableCallback 콜백)
업데이트에 따라 지정된 시간 동안 애니메이션으로 지도를 이동하고, 완료 시 선택적 콜백을 호출합니다.
void
clear()
지도에서 모든 마커, 폴리라인, 폴리곤, 오버레이 등을 제거합니다.
CameraPosition
getCameraPosition()
카메라의 현재 위치를 가져옵니다.
IndoorBuilding
getFocusedBuilding()
현재 포커스가 설정된 건물을 가져옵니다.
int
getMapType()
현재 표시된 지도의 유형을 가져옵니다.
float
getMaxZoomLevel()
현재 카메라 위치의 최대 확대/축소 수준을 반환합니다.
float
getMinZoomLevel()
최소 확대/축소 수준을 반환합니다.
위치
getMyLocation()
이 메서드는 지원 중단되었습니다. use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi는 향상된 위치 찾기와 전력 사용량을 제공하며 '내 위치' 파란색 점에서 사용합니다. 코드 예는 샘플 애플리케이션 폴더의 MyLocationDemoActivity 또는 위치 개발자 가이드를 참고하세요.
Projection
getProjection()
화면 좌표와 위도/경도 좌표 간을 변환하는 데 사용할 수 있는 Projection 객체를 반환합니다.
UiSettings
getUiSettings()
지도의 사용자 인터페이스 설정을 가져옵니다.
boolean
isBuildingsEnabled()
3D 건물 레이어의 사용 설정 여부를 반환합니다.
boolean
isIndoorEnabled()
실내 지도가 현재 사용 설정되어 있는지 여부를 가져옵니다.
boolean
isMyLocationEnabled()
내 위치 레이어의 상태를 가져옵니다.
boolean
isTrafficEnabled()
지도에서 교통정보를 보고 있는지 확인합니다.
void
moveCamera(CameraUpdate 업데이트)
업데이트에 정의된 안내에 따라 카메라 위치를 변경합니다.
void
resetMinMaxZoomPreference()
이전에 지정한 상한 및 하한 확대/축소 경계를 삭제합니다.
void
setBuildingsEnabled(불리언 사용 설정됨)
3D 빌딩 항목을 켜거나 끕니다.
void
setContentDescription(문자열 설명)
지도의 contentDescription을 설정합니다.
boolean
setIndoorEnabled(불리언 사용 설정됨)
실내 지도의 사용 여부를 설정합니다.
void
setInfoWindowAdapter(GoogleMap.InfoWindowAdapter 어댑터)
정보 창의 콘텐츠에 대한 맞춤 렌더기를 설정합니다.
void
setLatLngBoundsForCameraTarget(LatLngBounds 경계)
사용자가 지도를 스크롤하고 패닝할 때 카메라 타겟이 이 경계 밖으로 이동하지 않도록 LatLngBounds를 지정하여 카메라 타겟을 제한합니다.
void
setLocationSource(LocationSource 소스)
my-location 레이어의 위치 소스를 대체합니다.
boolean
setMapStyle(MapStyleOptions 스타일)
기본 지도의 스타일을 설정합니다.
void
setMapType(int type)
표시해야 하는 지도 타일의 유형을 설정합니다.
void
setMaxZoomPreference(float maxZoomPreference)
카메라 확대/축소의 기본 상한값을 설정합니다.
void
setMinZoomPreference(float minZoomPreference)
카메라 확대/축소의 기본 하한값을 설정합니다.
void
setMyLocationEnabled(불리언 사용)
내 위치 레이어를 사용 설정하거나 사용 중지합니다.
void
void
setOnCameraIdleListener(GoogleMap.OnCameraIdleListener 리스너)
카메라 이동이 종료되었을 때 호출되는 콜백을 설정합니다.
void
setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener 리스너)
새로운 유형의 애니메이션으로 인해 카메라 움직임이 중지되거나 중단될 때 호출되는 콜백을 설정합니다.
void
setOnCameraMoveListener(GoogleMap.OnCameraMoveListener 리스너)
카메라가 움직이는 동안 반복적으로 호출되는 콜백을 설정합니다.
void
setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener 리스너)
카메라가 움직이기 시작하거나 카메라 모션의 이유가 변경되었을 때 호출되는 콜백을 설정합니다.
void
setOnCircleClickListener(GoogleMap.OnCircleClickListener 리스너)
원을 클릭했을 때 호출되는 콜백을 설정합니다.
void
setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener 리스너)
지면 오버레이를 클릭하면 호출되는 콜백을 설정합니다.
void
setOnIndoorStateChangeListener(GoogleMap.OnIndoorStateChangeListener 리스너)
실내 이벤트의 리스너를 설정하거나 지웁니다.
void
setOnInfoWindowClickListener(GoogleMap.OnInfoWindowClickListener 리스너)
마커 정보 창을 클릭할 때 호출되는 콜백을 설정합니다.
void
setOnInfoWindowCloseListener(GoogleMap.OnInfoWindowCloseListener 리스너)
마커의 정보 창이 닫힐 때 호출되는 콜백을 설정합니다.
void
setOnInfoWindowLongClickListener(GoogleMap.OnInfoWindowLongClickListener 리스너)
마커의 정보 창을 길게 누를 때 호출되는 콜백을 설정합니다.
void
setOnMapClickListener(GoogleMap.OnMapClickListener 리스너)
지도를 탭할 때 호출되는 콜백을 설정합니다.
void
setOnMapLoadedCallback(GoogleMap.OnMapLoadedCallback 콜백)
이 지도의 렌더링이 완료되면 호출되는 콜백을 설정합니다.
void
setOnMapLongClickListener(GoogleMap.OnMapLongClickListener 리스너)
지도를 길게 누르면 호출되는 콜백을 설정합니다.
void
setOnMarkerClickListener(GoogleMap.OnMarkerClickListener 리스너)
마커를 클릭하면 호출되는 콜백을 설정합니다.
void
setOnMarkerDragListener(GoogleMap.OnMarkerDragListener 리스너)
마커를 드래그할 때 호출되는 콜백을 설정합니다.
void
setOnMyLocationButtonClickListener(GoogleMap.OnMyLocationButtonClickListener 리스너)
내 위치 버튼을 클릭할 때 호출되는 콜백을 설정합니다.
void
setOnMyLocationChangeListener(GoogleMap.OnMyLocationChangeListener 리스너)
이 메서드는 지원 중단되었습니다. use com.google.android.gms.location.FusedLocationProviderApi instead. FusedLocationProviderApi는 향상된 위치 찾기와 전력 사용량을 제공하며 '내 위치' 파란색 점에서 사용합니다. 코드 예는 샘플 애플리케이션 폴더의 MyLocationDemoActivity 또는 위치 개발자 가이드를 참고하세요.
void
setOnMyLocationClickListener(GoogleMap.OnMyLocationClickListener 리스너)
내 위치 점 (사용자의 위치를 나타냄)을 클릭했을 때 호출되는 콜백을 설정합니다.
void
setOnPoiClickListener(GoogleMap.OnPoiClickListener 리스너)
관심 장소를 클릭하거나 탭할 때 트리거될 리스너를 설정합니다.
void
setOnPolygonClickListener(GoogleMap.OnPolygonClickListener 리스너)
폴리곤을 클릭하면 호출되는 콜백을 설정합니다.
void
setOnPolylineClickListener(GoogleMap.OnPolylineClickListener 리스너)
다중선을 클릭하면 호출되는 콜백을 설정합니다.
void
setPadding(int left, int top, int right, int bottom)
지도에 패딩을 설정합니다.
void
setTrafficEnabled(불리언 사용 설정됨)
교통정보 레이어를 사용 설정 또는 중지합니다.
void
snapshot(GoogleMap.SnapshotReadyCallback 콜백)
지도의 스냅샷을 찍습니다.
void
snapshot(GoogleMap.SnapshotReadyCallback 콜백, 비트맵 비트맵)
지도의 스냅샷을 찍습니다.
void
stopAnimation()
카메라 애니메이션이 진행 중인 경우 중지합니다.

상속받은 메서드 요약

상수

public static Final int MAP_TYPE_HYBRID

주요 거리가 투명 레이어로 표시된 위성 지도입니다.

상수 값: 4

public static Final int MAP_TYPE_NONE

기본 지도 타일이 없습니다.

상수 값: 0

public static Final int MAP_TYPE_NORMAL

기본 지도

상수 값: 1

public static Final int MAP_TYPE_SATELLITE

라벨이 없는 위성 지도입니다.

상수 값: 2

public static Final int MAP_TYPE_TERRAIN

지형 지도

상수 값: 3

공개 메서드

공개 서클 addCircle (CircleOptions 옵션)

지도에 원을 추가합니다.

매개변수
옵션 원을 렌더링하는 방법을 정의하는 원 옵션 객체
반환 값
  • 지도에 추가된 Circle 객체

공개 GroundOverlay addGroundOverlay (GroundOverlayOptions 옵션)

이 지도에 이미지를 추가합니다.

매개변수
옵션 오버레이를 렌더링하는 방법을 정의하는 지면 오버레이 옵션 객체입니다. 옵션에는 이미지 (AnchoredBitmap)와 위치가 지정되어 있어야 합니다.
반환 값
생성 값
IllegalArgumentException (이미지 또는 위치가 옵션에 지정되지 않은 경우)

공개 마커 addMarker (MarkerOptions 옵션)

이 지도에 마커를 추가합니다.

마커의 아이콘은 지도의 Marker.position 위치에 렌더링됩니다. 마커를 클릭하면 카메라가 마커의 중앙에 배치됩니다. Marker.title이 정의되면 지도에 마커의 제목 및 스니펫이 포함된 정보 상자가 표시됩니다. 마커를 드래그할 수 있는 경우 마커를 길게 클릭한 다음 드래그하면 마커가 이동합니다.

매개변수
옵션 마커를 렌더링하는 방법을 정의하는 마커 옵션 객체입니다.
반환 값
  • 지도에 추가된 Marker입니다.

공개 다각형 addPolygon (PolygonOptions 옵션)

이 지도에 다각형을 추가합니다.

매개변수
옵션 다각형을 렌더링하는 방법을 정의하는 다각형 옵션 객체입니다.
반환 값
  • 지도에 추가된 Polygon 객체

공개 다중선 addPolyline (PolylineOptions 옵션)

이 지도에 폴리라인을 추가합니다.

매개변수
옵션 폴리라인을 렌더링하는 방법을 정의하는 폴리라인 옵션 객체입니다.
반환 값
  • 지도에 추가된 Polyline 객체

공개 TileOverlay addTileOverlay (TileOverlayOptions 옵션)

이 지도에 타일 오버레이를 추가합니다. 자세한 내용은 TileOverlay를 참고하세요.

다른 오버레이와 달리, 지도를 다시 만드는 경우 타일 오버레이는 자동으로 복원되지 않으며 수동으로 다시 추가해야 합니다.

매개변수
옵션 오버레이를 렌더링하는 방법을 정의하는 타일 오버레이 옵션 객체입니다. 옵션에는 TileProvider이 지정되어 있어야 합니다. 그러지 않으면 IllegalArgumentException이 발생합니다.
반환 값
생성 값
IllegalArgumentException TileProvider가 옵션에 지정되지 않은 경우입니다.

public void animateCamera (CameraUpdate 업데이트)

현재 위치에서 업데이트에 정의된 위치로 카메라가 이동하는 것을 애니메이션으로 보여줍니다. 애니메이션 중에 getCameraPosition()를 호출하면 카메라의 중간 위치가 반환됩니다.

업데이트 모음은 CameraUpdateFactory를 참고하세요.

매개변수
update 카메라에 적용해야 하는 변경사항입니다.

public void animateCamera (CameraUpdate 업데이트, GoogleMap.CancelableCallback 콜백)

현재 위치에서 업데이트에 정의된 위치로 카메라의 이동을 애니메이션 처리하고 완료 시 선택적 콜백을 호출합니다. 업데이트 집합은 CameraUpdateFactory를 참조하세요.

애니메이션 중에 getCameraPosition()를 호출하면 카메라의 중간 위치가 반환됩니다.

매개변수
update 카메라에 적용해야 하는 변경사항입니다.
콜백 애니메이션이 중지될 때 Android UI 스레드에서 호출할 콜백입니다. 애니메이션이 정상적으로 완료되면 onFinish()가 호출됩니다. 그러지 않으면 onCancel()이 호출됩니다. onCancel() 내에서 카메라를 업데이트하거나 애니메이션을 적용하지 마세요.

public void animateCamera (CameraUpdate update, int durationMs, GoogleMap.CancelableCallback callback)

업데이트에 따라 지정된 시간 동안 애니메이션으로 지도를 이동하고, 완료 시 선택적 콜백을 호출합니다. 업데이트 모음은 CameraUpdateFactory를 참고하세요.

애니메이션 중에 getCameraPosition()가 호출되면 비행 중인 카메라의 현재 위치가 반환됩니다.

매개변수
update
durationMs 애니메이션 재생 시간(밀리초)입니다. 이 값은 양수여야 하며, 그렇지 않으면 IllegalArgumentException이 발생합니다.
콜백 애니메이션이 중지될 때 Android UI 스레드에서 알림을 받을 선택적 콜백입니다. 자연스러운 완료로 인해 애니메이션이 중지되면 콜백에 onFinish() 알림이 전송됩니다. 이후의 카메라 움직임 또는 사용자 동작으로 인해 중단되어 애니메이션이 중지되면 onCancel()가 호출됩니다. 콜백은 취소 메서드에서 카메라를 이동하거나 애니메이션 처리하려고 해서는 안 됩니다. 콜백이 필요하지 않은 경우 null로 둡니다.

public void clear ()

지도에서 모든 마커, 폴리라인, 폴리곤, 오버레이 등을 제거합니다.

공개 CameraPosition getCameraPosition ()

카메라의 현재 위치를 가져옵니다.

반환된 CameraPosition는 현재 위치의 스냅샷이며 카메라가 이동해도 자동으로 업데이트되지 않습니다.

카메라 위치 변경에 관한 자세한 내용은 카메라 및 뷰를 참고하세요.

반환 값
  • 카메라의 현재 위치입니다.

공개 IndoorBuilding getFocusedBuilding ()

현재 포커스가 설정된 건물을 가져옵니다.

반환 값
  • 현재 포커스가 설정된 건물 또는 null(포커스가 설정된 건물이 없는 경우)

public int getMapType ()

현재 표시된 지도의 유형을 가져옵니다. 가능한 값은 MAP_TYPE_NORMAL, MAP_TYPE_SATELLITE, MAP_TYPE_TERRAIN를 참고하세요.

반환 값
  • 지도 유형

public float getMaxZoomLevel ()

현재 카메라 위치의 최대 확대/축소 수준을 반환합니다. 이는 현재 사용 중인 지도 유형을 고려합니다. 예를 들어 위성 또는 지형은 기본 지도 타일보다 최대 확대/축소 수준이 낮을 수 있습니다.

카메라의 확대/축소 수준을 변경하는 방법을 자세히 알아보려면 카메라 및 뷰를 참고하세요.

반환 값
  • 현재 카메라 위치에서 사용할 수 있는 최대 확대/축소 수준입니다.

public float getMinZoomLevel ()

최소 확대/축소 수준을 반환합니다. 이는 최대 확대/축소 수준과 달리 모든 위치에서 동일하지만 기기와 지도 크기에 따라 다를 수 있습니다.

카메라의 확대/축소 수준을 변경하는 방법을 자세히 알아보려면 카메라 및 뷰를 참고하세요.

반환 값
  • 사용 가능한 최소 확대/축소 수준입니다.

공개 위치 getMyLocation ()

이 메서드는 지원 중단되었습니다.
대신 com.google.android.gms.location.FusedLocationProviderApi를 사용하세요. FusedLocationProviderApi는 향상된 위치 찾기와 전력 사용량을 제공하며 '내 위치' 파란색 점에서 사용합니다. 코드 예는 샘플 애플리케이션 폴더의 MyLocationDemoActivity 또는 위치 개발자 가이드를 참고하세요.

현재 표시된 사용자 위치를 반환하거나 사용 가능한 위치 데이터가 없는 경우 null를 반환합니다.

반환 값
생성 값
IllegalStateException my-location 레이어가 사용 설정되지 않은 경우

public Projection getProjection ()

화면 좌표와 위도/경도 좌표 간을 변환하는 데 사용할 수 있는 Projection 객체를 반환합니다.

반환된 Projection는 현재 투영의 스냅샷이며 카메라가 이동해도 자동으로 업데이트되지 않습니다. 이 작업은 비용이 많이 들기 때문에 화면당 한 번만 프로젝션을 가져와야 합니다. Google 지도는 메르카토르 투영법을 사용하여 지리 데이터로부터 지도를 만들고 지도상의 지점을 지리적 좌표로 변환합니다.

반환 값

공개 UiSettings getUiSettings ()

지도의 사용자 인터페이스 설정을 가져옵니다.

반환 값

공개 불리언 isBuildingsEnabled ()

3D 건물 레이어의 사용 설정 여부를 반환합니다.

반환 값
  • 건물이 사용 설정된 경우 true, 사용 설정되지 않은 경우 false

공개 불리언 isIndoorEnabled ()

실내 지도가 현재 사용 설정되어 있는지 여부를 가져옵니다.

반환 값
  • 실내 지도가 사용 설정된 경우 true, 실내 지도가 사용 중지된 경우 false

공개 불리언 isMyLocationEnabled ()

내 위치 레이어의 상태를 가져옵니다.

반환 값
  • 내 위치 레이어가 사용 설정된 경우 true, 그렇지 않은 경우 false입니다.

공개 불리언 isTrafficEnabled ()

지도에서 교통정보를 보고 있는지 확인합니다. 이것은 교통정보의 제공 여부에 따라 달라집니다.

반환 값
  • 교통정보가 사용 설정된 경우 true, 사용 설정되지 않은 경우 false

public void moveCamera (CameraUpdate 업데이트)

업데이트에 정의된 안내에 따라 카메라 위치를 변경합니다. 이동은 즉시 이루어지며 후속 getCameraPosition()에 새 위치가 반영됩니다. 업데이트 집합은 CameraUpdateFactory를 참조하세요.

매개변수
update 카메라에 적용해야 하는 변경사항입니다.

public void resetMinMaxZoomPreference ()

이전에 지정한 상한 및 하한 확대/축소 경계를 삭제합니다.

public void setBuildingsEnabled (boolean enabled)

3D 빌딩 항목을 켜거나 끕니다.

매개변수
사용 설정됨 true: 3D 빌딩 레이어를 사용 설정하려면 false: 3D 빌딩 레이어를 사용 중지합니다.

public void setContentDescription (문자열 설명)

지도의 contentDescription을 설정합니다.

접근성 모드에서 지도에 대한 음성 설명을 제공하는 데 사용됩니다. 기본값은 'Google 지도'입니다.

매개변수
설명 설명으로 사용할 문자열입니다.

공개 불리언 setIndoorEnabled (boolean enabled)

실내 지도의 사용 여부를 설정합니다. 현재 실내 지도는 한 번에 하나의 지도에만 표시할 수 있으며 기본적으로 이 지도가 애플리케이션에 추가되는 첫 번째 지도입니다. 다른 지도에서 실내 지도를 사용 설정하려면 먼저 원래 지도에서 실내 지도를 사용 중지해야 합니다. 다른 지도에서 실내 지도가 사용 설정된 상태에서 이를 사용 설정하려고 하면 아무 일도 일어나지 않으며 false이 반환됩니다. 지도에 실내가 사용 설정되지 않은 경우 실내와 관련된 모든 메서드가 null 또는 false를 반환합니다.

매개변수
사용 설정됨 실내 지도를 사용 설정하려면 true, 실내 지도를 사용 중지하려면 false.
반환 값
  • 실내 지도 사용 가능 여부입니다.

public void setInfoWindowAdapter (GoogleMap.InfoWindowAdapter 어댑터)

정보 창의 콘텐츠에 대한 맞춤 렌더기를 설정합니다.

지도의 이벤트 리스너와 마찬가지로 이 상태는 지도와 함께 직렬화되지 않습니다. 구성이 변경되어 지도가 다시 생성되는 경우, 맞춤설정을 유지하려면 이 메서드를 다시 호출해야 합니다.

매개변수
어댑터 정보 창 콘텐츠에 사용할 어댑터이거나 정보 창의 기본 콘텐츠 렌더링을 사용하기 위한 null입니다.

public void setLatLngBoundsForCameraTarget (LatLngBounds 경계)

사용자가 지도를 스크롤하고 패닝할 때 카메라 타겟이 이 경계 밖으로 이동하지 않도록 LatLngBounds를 지정하여 카메라 타겟을 제한합니다.

경계 상자를 완전히 지우려면 null로 설정합니다. 새 경계는 이전에 지정된 경계 상자를 대체합니다.

LatLngBounds가 변경되면 SDK는 가능한 경우 이러한 경계를 준수하도록 이후의 모든 카메라 업데이트를 조정합니다. 기술적 문제로 인해 SDK가 카메라 타겟을 경계 내에서만 유지하지 못할 수도 있습니다. 예를 들어 부동 소수점 정밀도 반올림 오차나 매우 낮은 확대/축소 수준일 수 있습니다.

매개변수
bounds 카메라 타겟을 제한하는 경계입니다.

public void setLocationSource (LocationSource 소스)

my-location 레이어의 위치 소스를 대체합니다.

매개변수
소스 내 위치 레이어에서 사용할 위치 소스입니다. 기본 위치 소스를 사용하려면 null로 설정하세요.

공개 불리언 setMapStyle (MapStyleOptions 스타일)

기본 지도의 스타일을 설정합니다.

스타일 옵션을 사용하여 지도의 지형지물과 요소에 맞춤 스타일을 적용할 수 있습니다. 스타일 정의 세부정보는 MapStyleOptions를 참고하세요.

이전 맞춤 스타일을 지우려면 null로 설정합니다.

매개변수
스타일
반환 값
  • 스타일이 성공적으로 파싱된 경우 true, MapStyleOptions 관련 문제가 감지되면 false(예: 파싱할 수 없는 스타일 지정 JSON, 인식할 수 없는 지형지물 유형, 인식할 수 없는 요소 유형, 잘못된 스타일러 키 등) 반환 값이 false이면 현재 스타일이 변경되지 않습니다.

public void setMapType (int type)

표시해야 하는 지도 타일의 유형을 설정합니다. 허용되는 값은 다음과 같습니다.

매개변수
유형 표시할 지도 유형입니다.

public void setMaxZoomPreference (float maxZoomPreference)

카메라 확대/축소의 기본 상한값을 설정합니다.

최대 확대/축소가 변경되면 SDK는 가능한 경우 최대 확대/축소를 따르도록 이후의 모든 카메라 업데이트를 조정합니다. 기술적 고려사항으로 인해 SDK에서 사용자가 지도를 너무 깊이 확대/축소하는 것을 허용하지 않을 수도 있습니다. 예를 들어 위성 또는 지형은 기본 지도 타일보다 최대 확대/축소 수준이 낮을 수 있습니다.

SDK는 최솟값과 최댓값의 충돌을 해결합니다. 최소 확대/축소를 현재 최대 확대/축소 수준보다 높은 확대/축소 수준으로 설정하면 SDK에서 최소 및 최대 확대/축소 수준에서 모두 새로운 최솟값을 사용합니다. 최대 확대/축소를 최솟값보다 낮은 확대/축소 수준으로 설정하면 SDK에서 최소 및 최댓값 모두에 새로운 최댓값을 사용합니다. 예를 들어 현재 최소 확대/축소가 8이고 최대 확대/축소가 14라고 가정합니다. 그런 다음 최대 확대/축소를 6으로 설정합니다. SDK는 최소 확대/축소 수준 6, 최대 확대/축소 수준 6을 사용합니다.

매개변수
maxZoomPreference 기본 상한값입니다.

public void setMinZoomPreference (float minZoomPreference)

카메라 확대/축소의 기본 하한값을 설정합니다.

최소 확대/축소가 변경되면 SDK는 가능한 경우 최소 확대/축소를 따르도록 이후의 모든 카메라 업데이트를 조정합니다. 기술적 고려사항으로 인해 SDK에서 사용자가 너무 낮게 확대/축소하는 것을 막을 수 있습니다.

SDK는 최솟값과 최댓값의 충돌을 해결합니다. 최소 확대/축소를 현재 최대 확대/축소 수준보다 높은 확대/축소 수준으로 설정하면 SDK에서 최소 및 최대 확대/축소 수준에서 모두 새로운 최솟값을 사용합니다. 최대 확대/축소를 최솟값보다 낮은 확대/축소 수준으로 설정하면 SDK에서 최소 및 최댓값 모두에 새로운 최댓값을 사용합니다. 예를 들어 현재 최소 확대/축소가 8이고 최대 확대/축소가 14라고 가정합니다. 그런 다음 최소 확대/축소를 16으로 설정합니다. SDK에서는 최소 확대/축소 16, 최대 확대/축소를 16으로 사용합니다.

매개변수
minZoomPreference 선호하는 하한값입니다.

public void setMyLocationEnabled (boolean enabled)

내 위치 레이어를 사용 설정하거나 사용 중지합니다.

사용 설정되고 위치를 사용할 수 있는 동안 내 위치 레이어는 지속적으로 사용자의 현재 위치와 방위 표시를 그리고 사용자가 위치와 상호작용 (예: 위치 및 방위에 대한 카메라 추적을 사용 설정 또는 사용 중지)할 수 있는 UI 컨트롤을 표시합니다.

my-location-layer 기능을 사용하려면 맞춤 위치 소스를 설정하지 않은 경우 ACCESS_COARSE_LOCATION 또는 ACCESS_FINE_LOCATION에 대한 권한을 요청해야 합니다.

setLocationSource(LocationSource)를 통해 맞춤 위치 소스를 설정한 경우 Android용 Google Maps SDK는 위의 권한이 부여되었는지 확인하지 않습니다. 하지만 사용자가 맞춤 위치 소스에 필요한 모든 권한을 부여했는지 확인해야 합니다.

매개변수
사용 설정됨 사용 설정하려면 true, 사용 중지하려면 false입니다.
생성 값
SecurityException (위치 권한이 부여되지 않은 경우).

public void setOnCameraChangeListener (GoogleMap.OnCameraChangeListener 리스너)

이 메서드는 지원 중단되었습니다.
setOnCameraMoveStartedListener(GoogleMap.OnCameraMoveStartedListener), setOnCameraMoveListener(GoogleMap.OnCameraMoveListener), setOnCameraMoveCanceledListener(GoogleMap.OnCameraMoveCanceledListener), setOnCameraIdleListener(GoogleMap.OnCameraIdleListener)로 대체되었습니다.

카메라가 변경될 때 호출되는 콜백을 설정합니다.

매개변수
리스너 카메라가 변경될 때 호출되는 콜백입니다. 콜백을 설정 해제하려면 null를 사용하세요.

public void setOnCameraIdleListener (GoogleMap.OnCameraIdleListener 리스너)

카메라 이동이 종료되었을 때 호출되는 콜백을 설정합니다.

매개변수
리스너 호출되는 콜백입니다. 콜백을 설정 해제하려면 null를 사용합니다.

public void setOnCameraMoveCanceledListener (GoogleMap.OnCameraMoveCanceledListener 리스너)

새로운 유형의 애니메이션으로 인해 카메라 움직임이 중지되거나 중단될 때 호출되는 콜백을 설정합니다.

매개변수
리스너 호출되는 콜백입니다. 콜백을 설정 해제하려면 null를 사용합니다. onCameraMoveCanceled() 내에서 카메라를 업데이트하거나 애니메이션을 적용해서는 안 됩니다.

public void setOnCameraMoveListener (GoogleMap.OnCameraMoveListener 리스너)

카메라가 움직이는 동안 반복적으로 호출되는 콜백을 설정합니다. 콜백은 프레임마다 한 번씩 호출할 수 있으며 비용이 많이 드는 작업을 실행하면 안 됩니다.

매개변수
리스너 호출되는 콜백입니다. 콜백을 설정 해제하려면 null를 사용합니다.

public void setOnCameraMoveStartedListener (GoogleMap.OnCameraMoveStartedListener 리스너)

카메라가 움직이기 시작하거나 카메라 모션의 이유가 변경되었을 때 호출되는 콜백을 설정합니다.

매개변수
리스너 호출되는 콜백입니다. 콜백을 설정 해제하려면 null를 사용합니다. onCameraMoveStarted() 내에서 카메라를 업데이트하거나 애니메이션을 적용해서는 안 됩니다.

public void setOnCircleClickListener (GoogleMap.OnCircleClickListener 리스너)

원을 클릭했을 때 호출되는 콜백을 설정합니다.

매개변수
리스너 원을 클릭했을 때 호출되는 콜백입니다. 콜백을 설정 해제하려면 null를 사용하세요.

public void setOnGroundOverlayClickListener (GoogleMap.OnGroundOverlayClickListener 리스너)

지면 오버레이를 클릭하면 호출되는 콜백을 설정합니다.

매개변수
리스너 지면 오버레이를 클릭할 때 호출되는 콜백입니다. 콜백을 설정 해제하려면 null를 사용하세요.

public void setOnIndoorStateChangeListener (GoogleMap.OnIndoorStateChangeListener 리스너)

실내 이벤트의 리스너를 설정하거나 지웁니다. 하나의 리스너만 설정할 수 있습니다. 새 리스너를 설정하면 이전 리스너가 삭제됩니다.

매개변수
리스너 null이 아닌 경우 실내 이벤트를 위한 리스너입니다. 그렇지 않으면 리스너를 지웁니다.

public void setOnInfoWindowClickListener (GoogleMap.OnInfoWindowClickListener 리스너)

마커 정보 창을 클릭할 때 호출되는 콜백을 설정합니다.

매개변수
리스너 마커 정보 창을 클릭할 때 호출되는 콜백입니다. 콜백을 설정 해제하려면 null를 사용하세요.

public void setOnInfoWindowCloseListener (GoogleMap.OnInfoWindowCloseListener 리스너)

마커의 정보 창이 닫힐 때 호출되는 콜백을 설정합니다.

매개변수
리스너 마커의 정보 창이 닫힐 때 호출되는 콜백입니다. 콜백을 설정 해제하려면 null를 사용하세요.

public void setOnInfoWindowLongClickListener (GoogleMap.OnInfoWindowLongClickListener 리스너)

마커의 정보 창을 길게 누를 때 호출되는 콜백을 설정합니다.

매개변수
리스너 마커의 정보 창을 길게 누를 때 호출되는 콜백입니다. 콜백을 설정 해제하려면 null를 사용하세요.

public void setOnMapClickListener (GoogleMap.OnMapClickListener 리스너)

지도를 탭할 때 호출되는 콜백을 설정합니다.

매개변수
리스너 지도를 탭할 때 호출되는 콜백입니다. 콜백을 설정 해제하려면 null를 사용하세요.

public void setOnMapLoadedCallback (GoogleMap.OnMapLoadedCallback 콜백)

이 지도의 렌더링이 완료되면 호출되는 콜백을 설정합니다. 콜백은 한 번만 호출됩니다.

지도가 완전히 렌더링될 때 이 메서드를 호출하면 콜백이 즉시 호출됩니다. 연결 문제로 인해 지도가 로드되지 않거나 사용자가 지도와 계속 상호작용하여 지도가 계속 변경되고 로드가 완료되지 않는 경우에는 이 이벤트가 실행되지 않습니다.

매개변수
콜백 지도의 렌더링이 완료되면 호출되는 콜백입니다. 콜백을 설정 해제하려면 null를 사용하세요.

public void setOnMapLongClickListener (GoogleMap.OnMapLongClickListener 리스너)

지도를 길게 누르면 호출되는 콜백을 설정합니다.

매개변수
리스너 지도를 길게 누르면 호출되는 콜백입니다. 콜백을 설정 해제하려면 null를 사용하세요.

public void setOnMarkerClickListener (GoogleMap.OnMarkerClickListener 리스너)

마커를 클릭하면 호출되는 콜백을 설정합니다.

매개변수
리스너 마커를 클릭하면 호출되는 콜백입니다. 콜백을 설정 해제하려면 null를 사용하세요.

public void setOnMarkerDragListener (GoogleMap.OnMarkerDragListener 리스너)

마커를 드래그할 때 호출되는 콜백을 설정합니다.

매개변수
리스너 마커 드래그 이벤트에서 호출되는 콜백입니다. 콜백을 설정 해제하려면 null를 사용하세요.

public void setOnMyLocationButtonClickListener (GoogleMap.OnMyLocationButtonClickListener 리스너)

내 위치 버튼을 클릭할 때 호출되는 콜백을 설정합니다.

listenertrue를 반환하면 이벤트가 소비되고 기본 동작이 발생하지 않습니다. false를 반환하면 기본 동작이 발생합니다 (즉, 사용자 위치의 중앙에 위치하도록 카메라가 움직입니다).

매개변수
리스너 내 위치 버튼을 클릭하면 호출되는 콜백입니다.

public void setOnMyLocationChangeListener (GoogleMap.OnMyLocationChangeListener 리스너)

이 메서드는 지원 중단되었습니다.
대신 com.google.android.gms.location.FusedLocationProviderApi를 사용하세요. FusedLocationProviderApi는 향상된 위치 찾기와 전력 사용량을 제공하며 '내 위치' 파란색 점에서 사용합니다. 코드 예는 샘플 애플리케이션 폴더의 MyLocationDemoActivity 또는 위치 개발자 가이드를 참고하세요.

My Location 점이 위치를 변경할 때 호출되는 콜백을 설정합니다.

매개변수
리스너 내 위치 점이 변경될 때 호출되는 콜백입니다.

public void setOnMyLocationClickListener (GoogleMap.OnMyLocationClickListener 리스너)

내 위치 점 (사용자의 위치를 나타냄)을 클릭했을 때 호출되는 콜백을 설정합니다.

매개변수
리스너 내 위치 점을 클릭할 때 호출되는 콜백입니다.

public void setOnPoiClickListener (GoogleMap.OnPoiClickListener 리스너)

관심 장소를 클릭하거나 탭할 때 트리거될 리스너를 설정합니다.

리스너를 지우려면 null를 전달합니다.

매개변수
리스너

public void setOnPolygonClickListener (GoogleMap.OnPolygonClickListener 리스너)

폴리곤을 클릭하면 호출되는 콜백을 설정합니다.

매개변수
리스너 폴리곤을 클릭하면 호출되는 콜백입니다. 콜백을 설정 해제하려면 null를 사용하세요.

public void setOnPolylineClickListener (GoogleMap.OnPolylineClickListener 리스너)

다중선을 클릭하면 호출되는 콜백을 설정합니다.

매개변수
리스너 다중선을 클릭하면 호출되는 콜백입니다. 콜백을 설정 해제하려면 null를 사용하세요.

public void setPadding (int left, int top, int right, int bottom)

지도에 패딩을 설정합니다.

이 메서드를 사용하면 지도에 표시되는 영역을 정의하여, 지도의 네 가장자리 각각에 패딩을 설정하여 가장자리 주변의 지도 부분이 가려질 수 있음을 지도에 알릴 수 있습니다. 지도 함수가 패딩에 맞게 조정됩니다. 예를 들어 확대/축소 컨트롤, 나침반, 저작권 고지 및 Google 로고는 정의된 영역 내에 들어가도록 이동하고, 카메라는 보이는 영역의 중심을 기준으로 이동합니다.

매개변수
왼쪽 지도의 왼쪽에 추가될 패딩의 픽셀 수입니다.
상단 지도 상단에 추가할 패딩의 픽셀 수입니다.
오른쪽 지도의 오른쪽에 추가될 패딩의 픽셀 수입니다.
하단 지도 하단에 추가할 패딩의 픽셀 수입니다.

public void setTrafficEnabled (boolean enabled)

교통정보 레이어를 사용 설정 또는 중지합니다.

매개변수
사용 설정됨

public void snapshot (GoogleMap.SnapshotReadyCallback 콜백)

지도의 스냅샷을 찍습니다.

대화형 지도를 사용하기 어렵거나 불가능할 때 애플리케이션 내에서 스냅샷을 사용할 수 있습니다. 예를 들어 snapshot() 메서드로 생성된 이미지를 사용하여 앱에서 지도의 썸네일을 표시하거나 알림 센터에 스냅샷을 표시할 수 있습니다.

참고: 지도 이미지를 서버로 전송하거나 애플리케이션 외부에서 사용해서는 안 됩니다. 지도를 다른 애플리케이션 또는 사용자에게 보내야 하는 경우 스냅샷 대신 새 사용자를 위해 지도를 재구성할 수 있는 데이터를 전송하세요.

매개변수
콜백 스냅샷을 만들 때 호출되는 콜백 메서드입니다.

public void snapshot (GoogleMap.SnapshotReadyCallback 콜백, 비트맵 비트맵)

지도의 스냅샷을 찍습니다.

이 메서드는 snapshot(SnapshotReadyCallback)와 동일하지만 사전 할당된 Bitmap를 제공할 수 있습니다. 비트맵이 지도의 현재 크기와 일치하지 않으면 지도의 크기에 맞는 다른 비트맵이 할당됩니다.

대부분의 경우 콜백 메서드에서 전달하는 객체는 이 메서드의 매개변수에 지정된 객체와 동일하지만 일부 경우에는 반환되는 객체가 다를 수 있습니다 (예: 실제 스냅샷을 촬영할 때 뷰의 크기가 변경된 경우). 따라서 콜백 메서드에서 전달한 비트맵 콘텐츠만 신뢰해야 합니다.

매개변수
콜백 스냅샷을 만들 때 호출되는 콜백 메서드입니다.
비트맵 사전 할당된 비트맵 null인 경우 snapshot(SnapshotReadyCallback)처럼 동작합니다.

public void stopAnimation ()

카메라 애니메이션이 진행 중인 경우 중지합니다. 이 메서드가 호출되면 카메라는 즉시 이동을 중지하고 그 위치에 남아 있게 됩니다.