GoogleMap

투명한 주요 레이어가 표시된 위성 지도

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

기본 지도

라벨이 없는 위성 지도

지형 지도

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

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

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

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

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

이 지도에 다중선을 추가합니다.

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

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

현재 위치에서 업데이트에 정의된 위치로 카메라의 이동에 애니메이션을 적용합니다. 애니메이션 도중 getCameraPosition() 호출은 카메라의 중간 위치를 반환합니다.

업데이트 사항은 CameraUpdateFactory에서 확인하세요.

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

애니메이션 도중 getCameraPosition() 호출은 카메라의 중간 위치를 반환합니다.

지정된 기간 동안 애니메이션이 포함된 업데이트에 따라 지도를 이동하고 완료 시 선택적 콜백을 호출합니다. 업데이트 사항은 CameraUpdateFactory에서 확인하세요.

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

지도에서 모든 마커, 다중선, 다각형, 오버레이 등을 삭제합니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

실내 지도의 현재 사용 설정 여부를 가져옵니다.

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

지도에서 교통정보를 생성하는지 여부를 확인합니다. 이는 트래픽 데이터의 가용성에 따라 달라집니다.

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

이전에 지정된 위쪽 및 아래쪽 확대/축소 경계를 삭제합니다.

3D 빌딩 레이어를 사용 또는 사용 중지합니다.

지도의 contentDescription을 설정합니다.

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

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

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

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

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

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

LatLngBounds가 변경되면 SDK는 가능한 경우 이러한 경계를 준수하도록 모든 향후 카메라 업데이트를 조정합니다. SDK에서 카메라 대상을 경계 내에서 엄격하게 유지하지 못할 수도 있는 기술적 고려 사항이 있습니다. 예를 들어 부동 소수점 정밀도 반올림 오차 또는 매우 낮은 확대/축소 수준이 있습니다.

내 위치 레이어의 위치 소스를 대체합니다.

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

스타일 옵션을 사용하면 지도의 지형지물과 요소에 맞춤 스타일을 적용할 수 있습니다. 스타일 정의에 관한 자세한 내용은 MapStyleOptions을 참고하세요.

null로 설정하면 이전 맞춤 스타일이 삭제됩니다.

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

• MAP_TYPE_NORMAL: 기본 지도.
• MAP_TYPE_SATELLITE: 위성 이미지입니다.
• MAP_TYPE_HYBRID: 도로와 라벨이 포함된 위성 이미지입니다.
• MAP_TYPE_TERRAIN: 지형 데이터입니다.
• MAP_TYPE_NONE: 기본 지도 타일이 없습니다.

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

최대 확대/축소가 변경되면 SDK는 가능한 한 최대를 따르도록 모든 후속 카메라 업데이트를 조정합니다. SDK에서 사용자가 지도를 너무 깊이 확대하지 못하도록 하는 기술적 문제가 있습니다. 예를 들어, 위성 또는 지형은 기본 지도 타일보다 최대 확대/축소 수준이 낮을 수 있습니다.

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

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

최소 확대/축소가 변경될 때 SDK는 가능한 경우 해당 최소 크기에 맞춰 모든 후속 카메라 업데이트를 조정합니다. SDK에서 사용자가 너무 낮게 확대/축소하지 못하도록 하는 기술적 문제가 있습니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

내 위치 표시 점의 위치가 변경될 때 호출되는 콜백을 설정합니다.

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

관심 장소를 클릭하거나 탭할 때 실행되는 리스너를 설정합니다.

null를 전달하여 리스너를 지웁니다.

다각형을 클릭할 때 호출되는 콜백을 설정합니다.

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

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

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

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

지도의 스냅샷을 생성합니다.

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

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

지도의 스냅샷을 생성합니다.

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

대부분의 경우 콜백 메서드가 전달한 객체는 이 메서드에 제공된 객체와 동일하지만 반환된 객체는 다를 수 있습니다 (예: 스냅샷이 실제로 캡처된 시점으로 뷰의 차원이 변경된 경우). 따라서 콜백 메서드가 전달한 비트맵 콘텐츠만 신뢰해야 합니다.

진행 중인 카메라 애니메이션이 있으면 중지합니다. 메서드가 호출되면 카메라가 즉시 움직이지 않고 그 위치로 유지됩니다.