새로운 지도 스타일이 곧 Google Maps Platform에 제공될 예정입니다. 이 지도 스타일 지정 업데이트에는 새로운 기본 색상 팔레트와 지도 환경 및 사용성 개선사항이 포함됩니다. 모든 지도 스타일이 2025년 3월에 자동으로 업데이트됩니다. 사용 가능 여부 및 더 일찍 선택하는 방법에 대한 자세한 내용은 Google Maps Platform용 새로운 지도 스타일을 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

마커

공개 최종 클래스 마커 객체
를 확장합니다.

지도 표면의 특정 지점에 배치되는 아이콘입니다. 마커 아이콘은 특정 방향으로 그려져 있습니다. 지도의 표면이 아니라 기기의 화면에 맞추어 야기합니다. 즉, 데이터가 실제로 표시되는 지도 회전, 기울기 또는 확대/축소 때문에 발생할 수 있습니다.

마커에는 다음과 같은 속성이 있습니다.

알파: 마커의 불투명도를 설정합니다. 기본값은 1.0입니다.
anchor: 이미지에서 마커의 LatLng 위치에 배치되는 지점입니다. 기본값은 이미지 왼쪽 및 하단으로부터 50% 입니다.
위치: 지도 상의 마커 위치에 대한 LatLng 값입니다. 이 값은 다음에서 변경할 수 있습니다. 를 클릭합니다.
제목: 사용자가 마커를 탭할 때 정보 창에 표시되는 텍스트 문자열입니다. 다음을 수행할 수 있습니다. 언제든지 이 값을 변경할 수 있습니다.
스니펫: 제목 아래 표시되는 추가 텍스트입니다. 이 값은 언제든지 변경할 수 있습니다.
아이콘: 마커에 대해 표시되는 비트맵입니다. 아이콘을 설정하지 않으면 기본 아이콘은 다음과 같습니다. 표시됩니다. defaultMarker(float)를 사용하여 기본 아이콘의 대체 색상을 지정할 수 있습니다.
드래그 상태: 사용자가 마커를 드래그할 수 있도록 하려면 이 속성을 true로 설정합니다. 나 언제든지 이 값을 변경할 수 있습니다. 기본값은 false입니다.
공개 상태: 기본적으로 마커가 표시됩니다. 마커를 보이지 않게 하려면 이 속성을 false 이 값은 언제든지 변경할 수 있습니다.
플랫 또는 빌보드: 마커가 지도 위에 평행을 놓으면 카메라가 지도에 머물러 있게 됩니다. 가 회전하고 기울어지지만 GroundOverlay와 달리 카메라 확대/축소 시 동일한 크기를 유지합니다. 마커가 빌보드인 경우 마커가 항상 카메라를 향하도록 그려지며 카메라와 함께 회전하고 기울어집니다. 기본값은 빌보드 (false)입니다.
회전: 마커의 앵커 포인트를 기준으로 마커의 시계 방향(단위: 도) 회전입니다. 축 마커와 직각을 이룰 수 있습니다. 0 회전은 기본값에 해당합니다. 위치를 나타냅니다. 지도에서 마커가 평면인 경우 기본 위치는 북쪽입니다. 마커가 항상 지도에서 평평한 상태를 유지하도록 회전이 정렬됩니다. 이 마커가 빌보드이고, 기본 위치는 위를 가리키고 회전은 마커는 항상 카메라를 향합니다. 기본값은 0입니다.
zIndex: 마커의 그리기 순서입니다. 마커는 zIndex 순으로 그려지며, 가장 높은 zIndex 마커가 위에 그려집니다. 각 마커에 대해 zIndex 속성을 설정하면 사용자가 누를 가능성이 가장 높은 탭 타겟을 관리합니다. 기본값은 0입니다.
태그: 마커와 연결된 Object입니다. 예를 들어 Object에는 마커가 나타내는 것에 대한 데이터입니다. 이는 별도의 Map<Marker, Object>를 저장하는 것보다 쉽습니다. 또 다른 예로 String ID를 데이터 세트의 ID에 해당합니다. Android용 Google Maps SDK는 이 속성을 씁니다.

이 클래스의 메서드는 Android UI 스레드에서 호출되어야 합니다. 그러지 않으면 런타임에 IllegalStateException이 발생합니다.

예

GoogleMap map = ... // get a map.
 // Add a marker at San Francisco.
 Marker marker = map.addMarker(new MarkerOptions()
     .position(new LatLng(37.7750, 122.4183))
     .title("San Francisco")
     .snippet("Population: 776733"));

개발자 가이드

자세한 내용은 마커 개발자를 참고하세요. 참조하세요.

중첩된 클래스 요약

@interface Marker.CollisionBehavior 다른 마커나 베이스와 충돌했을 때 마커가 처리되는 방식을 나타냅니다. 지도 라벨

공개 메서드 요약

부울	같음(기타 객체) 이 `Marker`가 다른 `Marker`와 같은지 테스트합니다.
float	getAlpha() 마커의 알파를 가져옵니다.
문자열	getId() 이 마커의 ID를 가져옵니다.
LatLng	getPosition() 마커의 위치를 반환합니다.
float	getRotation() 마커의 회전을 가져옵니다.
문자열	getSnippet() 마커의 스니펫을 가져옵니다.
객체	getTag() 마커의 태그를 가져옵니다.
문자열	getTitle() 마커의 제목을 가져옵니다.
float	getZIndex() 마커의 zIndex를 반환합니다.
int	hashCode()
void	hideInfoWindow() 이 마커에 표시되는 경우 정보창을 숨깁니다.
부울	isDraggable() 마커의 드래그 가능 여부를 가져옵니다.
부울	isFlat() 마커의 평면 설정을 가져옵니다.
부울	isInfoWindowShown() 정보창이 현재 이 마커 위에 표시되는지 여부를 반환합니다.
부울	isVisible() 이 마커의 공개 상태 설정을 가져옵니다.
void	remove() 지도에서 이 마커를 삭제합니다.
void	setAlpha(부동 소수점 수 알파) 마커의 알파 (불투명도)를 설정합니다.
void	setAnchor(부동 anchorU, 부동 앵커 V) 마커의 앵커 포인트를 설정합니다.
void	setDraggable(boolean draggable) 마커의 드래그 가능 여부를 설정합니다.
void	setFlat(불리언 플랫) 이 마커를 지도 `true` 또는 카메라 `false`.
void	setIcon(BitmapDescriptor iconDescriptor) 마커의 아이콘을 설정합니다.
void	setInfoWindowAnchor(float anchorU, float anchorV) 정보창이 정보창을 고정할 때 마커 이미지의 지점을 지정합니다. 표시됩니다.
void	setPosition(LatLng latlng) 마커의 위치를 설정합니다.
void	setRotation(부동 소수점 수 회전) 마커의 앵커 포인트를 기준으로 마커의 회전을 시계 방향으로 설정합니다.
void	setSnippet(문자열 스니펫) 마커의 스니펫을 설정합니다.
void	setTag(객체 태그) 마커의 태그를 설정합니다.
void	setTitle(문자열 제목) 마커의 제목을 설정합니다.
void	setVisible(boolean visible) 이 마커의 표시 여부를 설정합니다.
void	setZIndex(부동 소수점 수 zIndex) 마커의 zIndex를 설정합니다.
void	showInfoWindow() 이 마커가 `isVisible()`인 경우 지도에 이 마커의 정보 창을 표시합니다.

상속받은 메서드 요약

java.lang.Object 클래스에서 상속됨

부울	같음(객체 arg0)
최종 클래스<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
문자열	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

공개 메서드

<ph type="x-smartling-placeholder"></ph> 공개 불리언 를 통해 개인정보처리방침을 정의할 수 있습니다. 같음 (객체 기타)

이 Marker가 다른 Marker와 같은지 테스트합니다.

매개변수

기타	`Object`

반환 값

두 객체가 동일한 객체라면 true, 즉 이 == other입니다.

<ph type="x-smartling-placeholder"></ph> 공개 부동 소수점 수 를 통해 개인정보처리방침을 정의할 수 있습니다. getAlpha ()

마커의 알파를 가져옵니다.

반환 값

[0, 1] 범위에 있는 마커의 알파입니다.

<ph type="x-smartling-placeholder"></ph> 공개 문자열 를 통해 개인정보처리방침을 정의할 수 있습니다. getId ()

이 마커의 ID를 가져옵니다. ID는 지도의 모든 마커 간에 고유합니다.

반환 값

마커의 ID입니다.

<ph type="x-smartling-placeholder"></ph> 공개 LatLng getPosition ()

마커의 위치를 반환합니다.

반환 값

마커의 현재 위치를 지정하는 LatLng 객체입니다.

<ph type="x-smartling-placeholder"></ph> 공개 부동 소수점 수 를 통해 개인정보처리방침을 정의할 수 있습니다. getRotation ()

마커의 회전을 가져옵니다.

반환 값

기본 위치에서부터 시계 방향으로 마커의 회전 각도입니다.

<ph type="x-smartling-placeholder"></ph> 공개 문자열 를 통해 개인정보처리방침을 정의할 수 있습니다. getSnippet ()

마커의 스니펫을 가져옵니다.

반환 값

마커의 스니펫을 포함하는 문자열입니다.

<ph type="x-smartling-placeholder"></ph> 공개 개체 를 통해 개인정보처리방침을 정의할 수 있습니다. getTag ()

마커의 태그를 가져옵니다.

반환 값

태그가 setTag로 설정된 경우 태그입니다. 태그가 설정되지 않은 경우 null입니다.

<ph type="x-smartling-placeholder"></ph> 공개 문자열 를 통해 개인정보처리방침을 정의할 수 있습니다. getTitle ()

마커의 제목을 가져옵니다.

반환 값

마커의 제목을 포함하는 문자열입니다.

<ph type="x-smartling-placeholder"></ph> 공개 부동 소수점 수 를 통해 개인정보처리방침을 정의할 수 있습니다. getZIndex ()

마커의 zIndex를 반환합니다.

반환 값

zIndex를 표시합니다.

<ph type="x-smartling-placeholder"></ph> 공개 정수 를 통해 개인정보처리방침을 정의할 수 있습니다. hashCode ()

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. hideInfoWindow ()

이 마커에 표시되는 경우 정보창을 숨깁니다.

이 마커가 보이지 않으면 이 메서드는 아무런 영향을 미치지 않습니다.

<ph type="x-smartling-placeholder"></ph> 공개 불리언 를 통해 개인정보처리방침을 정의할 수 있습니다. isDraggable ()

마커의 드래그 가능 여부를 가져옵니다. 마커를 드래그할 수 있는 경우 사용자가 마커를 길게 누릅니다.

반환 값

마커를 드래그할 수 있는 경우 true, 그렇지 않으면 false를 반환합니다.

<ph type="x-smartling-placeholder"></ph> 공개 불리언 를 통해 개인정보처리방침을 정의할 수 있습니다. isFlat ()

마커의 평면 설정을 가져옵니다.

반환 값

마커가 지도에 수평인 경우 true, 마커가 다음과 같아야 하는 경우 false 카메라를 바라보세요.

<ph type="x-smartling-placeholder"></ph> 공개 불리언 를 통해 개인정보처리방침을 정의할 수 있습니다. isInfoWindowShown ()

정보창이 현재 이 마커 위에 표시되는지 여부를 반환합니다. 이것은 정보창이 실제로 화면에 표시되는지 여부

<ph type="x-smartling-placeholder"></ph> 공개 불리언 를 통해 개인정보처리방침을 정의할 수 있습니다. isVisible ()

이 마커의 공개 상태 설정을 가져옵니다. 이것은 마커가 화면의 표시 영역 내에 있어야 합니다. 이것은 마커가 이미지 및 동영상 광고입니다.

반환 값

표시됩니다.

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. 삭제 ()

지도에서 이 마커를 삭제합니다. 마커가 제거되면 모든 마커의 동작은 메서드가 정의되지 않은 것입니다.

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setAlpha (부동 소수점 수 알파)

마커의 알파 (불투명도)를 설정합니다. 0~1 사이의 값이며 0은 마커를 의미합니다. 는 완전히 투명하며 1은 마커가 완전히 불투명함을 의미합니다.

매개변수

알파

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setAnchor (float anchorU, float anchorV)

마커의 앵커 포인트를 설정합니다.

앵커는 마커의 위치에 고정된 아이콘 이미지의 점을 지정합니다. 빛을 냅니다.

앵커 포인트는 연속적인 공간 [0.0, 1.0] x [0.0, 1.0]에 지정됩니다. 여기서 (0, 0) 는 이미지의 왼쪽 상단이며 (1, 1)은 오른쪽 하단입니다. 고정점 W x H 이미지에서 (W + 1) x의 가장 가까운 불연속 그리드 점입니다. (H + 1) 그리드입니다. 예를 들어 4x2 이미지의 경우 앵커 포인트 (0.7, 0.6)는 (3, 1)의 그리드 포인트로 확인됩니다.

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*
 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----X-----+   (X, Y) = (3, 1)
 |     |     |     |     |
 |     |     |     |     |
 *-----+-----+-----+-----*

매개변수

anchorU	이미지 너비에 대한 비율([0, 1] 범위 내)으로 표시되는 앵커의 u 좌표입니다.
anchorV	앵커의 v 좌표로, 이미지 높이의 비율([0, 1]).

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setDraggable (불리언 드래그 가능)

마커의 드래그 가능 여부를 설정합니다. 마커를 드래그할 수 있는 경우 사용자가 마커를 길게 누릅니다.

매개변수

드래그 가능

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setFlat (부울 플랫)

이 마커를 지도 true 또는 카메라 false.

매개변수

플랫

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setIcon (BitmapDescriptor iconDescriptor)

마커의 아이콘을 설정합니다.

매개변수

iconDescriptor	null인 경우 기본 마커가 사용됩니다.

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setInfoWindowAnchor (float anchorU, float anchorV)

정보창이 정보창을 고정할 때 마커 이미지의 지점을 지정합니다. 표시됩니다. 앵커와 동일한 좌표계에서 지정됩니다. 자세한 내용은 setAnchor(float, float)를 참고하세요. 기본값은 이미지의 상단 중앙입니다.

매개변수

anchorU	정보창 앵커의 u 좌표로, 이미지 너비의 비율( [0, 1] 범위).
anchorV	정보창 앵커의 v 좌표로, 이미지 높이의 비율( [0, 1] 범위).

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setPosition (LatLng latlng)

마커의 위치를 설정합니다.

매개변수

위도/경도

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setRotation (부동 소수점 수 회전)

마커의 앵커 포인트를 기준으로 마커의 회전을 시계 방향으로 설정합니다. 축 마커와 직각을 이룰 수 있습니다. 0 회전은 기본 위치에 해당합니다. 입니다.

매개변수

회전

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setSnippet (문자열 스니펫)

마커의 스니펫을 설정합니다.

매개변수

스니펫	null인 경우 스니펫이 삭제됩니다.

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setTag (객체 태그)

마커의 태그를 설정합니다.

이 속성을 사용하여 임의의 Object를 이 마커와 연결할 수 있습니다. 대상 예를 들어 Object에는 마커가 나타내는 대상에 관한 데이터가 포함될 수 있습니다. 더 쉽습니다. 별도의 Map<Marker, Object>을 저장하는 것보다 훨씬 더 쉽습니다. 또 다른 예로 데이터 세트의 ID에 해당하는 String ID Android용 Google Maps SDK 이 속성을 읽거나 쓰지 않습니다. setTag(null)를 호출하여 더 이상 필요하지 않을 때 태그를 제거하여 앱에서 메모리 누수를 방지하세요.

매개변수

태그	null인 경우 태그가 지워집니다.

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setTitle (문자열 제목)

마커의 제목을 설정합니다.

매개변수

제목	null인 경우 제목이 지워집니다.

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setVisible (불리언 표시)

이 마커의 표시 여부를 설정합니다. false로 설정되어 있고 정보 창이 현재 이 마커에 을 표시하면 정보 창이 숨겨집니다.

매개변수

표시

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setZIndex (부동 소수점 수 zIndex)

마커의 zIndex를 설정합니다.

매개변수

zIndex

<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. showInfoWindow ()

이 마커가 isVisible()인 경우 지도에 이 마커의 정보 창을 표시합니다.

생성 값

IllegalArgumentException	`marker`이(가) 이 지도에 없는 경우