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

MarkerOptions

공개 최종 클래스 MarkerOptions Object를 확장
구현 Parcelable

마커의 MarkerOptions를 정의합니다.

개발자 가이드

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

상속받은 상수 요약

android.os.Parcelable 인터페이스에서 상속됨

int	CONTENTS_FILE_DESCRIPTOR
int	PARCELABLE_WRITE_RETURN_VALUE

공개 생성자 요약

MarkerOptions()

새 마커 옵션 집합을 만듭니다.

공개 메서드 요약

MarkerOptions	alpha(부동 소수점 수 알파) 마커의 알파 (불투명도)를 설정합니다.
MarkerOptions	anchor(float u, float v) 마커 이미지의 특정 지점에 위치하도록 앵커를 지정합니다.
MarkerOptions	collisionBehavior(int collisionBehavior) 마커의 충돌 상태를 설정합니다.
MarkerOptions	draggable(불리언 드래그 가능) 마커의 드래그 가능 여부를 설정합니다.
MarkerOptions	flat(부울 플랫) 이 마커를 지도 `true`에 평평하게 놓아야 하는지 아니면 카메라 `false`를 향한 빌보드에 평평해야 하는지 설정합니다.
float	getAlpha() 이 `MarkerOptions` 객체의 알파 집합을 가져옵니다.
float	getAnchorU() 왼쪽 가장자리로부터 앵커의 수평 거리([0, 1]로 정규화됨).
float	getAnchorV() 상단 가장자리로부터 앵커의 수직 거리([0, 1]로 정규화됨)입니다.
int	getCollisionBehavior()
BitmapDescriptor	getIcon() 이 `MarkerOptions` 객체에 설정된 맞춤 아이콘 설명어를 가져옵니다.
float	getInfoWindowAnchorU() 왼쪽 가장자리에서 정보 창 앵커의 수평 거리([0, 1]로 정규화됨).
float	getInfoWindowAnchorV() 상단 가장자리로부터 정보 창 앵커의 수직 거리([0, 1]로 정규화됨).
LatLng	getPosition() 이 `MarkerOptions` 객체에 설정된 위치를 반환합니다.
float	getRotation() 이 `MarkerOptions` 객체에 설정된 회전을 가져옵니다.
문자열	getSnippet() 이 `MarkerOptions` 객체에 설정된 스니펫을 가져옵니다.
문자열	getTitle() 이 `MarkerOptions` 객체에 설정된 제목을 가져옵니다.
float	getZIndex() 이 `MarkerOptions` 객체에 설정된 zIndex를 가져옵니다.
MarkerOptions	icon(BitmapDescriptor iconDescriptor) 마커의 아이콘을 설정합니다.
MarkerOptions	infoWindowAnchor(float u, float v) 마커 이미지에 대한 정보 창의 앵커 지점을 지정합니다.
boolean	isDraggable() 이 `MarkerOptions` 객체의 드래그 가능 여부 설정을 가져옵니다.
boolean	isFlat() 이 `MarkerOptions` 객체의 평면 설정을 가져옵니다.
boolean	isVisible() 이 `MarkerOptions` 객체의 공개 상태 설정을 가져옵니다.
MarkerOptions	position(LatLng latlng) 마커의 위치를 설정합니다.
MarkerOptions	rotation(부동 소수점 수 회전) 마커의 앵커 포인트를 기준으로 마커의 회전 각도를 시계 방향으로 설정합니다.
MarkerOptions	snippet(문자열 스니펫) 마커의 스니펫을 설정합니다.
MarkerOptions	title(문자열 제목) 마커의 제목을 설정합니다.
MarkerOptions	visible(불리언 표시) 마커의 가시성을 설정합니다.
MarkerOptions	zIndex(부동 소수점 수 zIndex) 마커의 zIndex를 설정합니다.

상속받은 메서드 요약

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

boolean	equals(객체 arg0)
최종 Class<?>	getClass()
int	hashCode()
최종 void	notify()
최종 void	notifyAll()
문자열	toString()
최종 void	wait(long arg0, int arg1)
최종 void	wait(long arg0)
최종 void	wait()

android.os.Parcelable 인터페이스에서 상속됨

추상 정수	describeContents()
추상 void	writeToParcel(Parcel arg0, int arg1)

공개 생성자

public MarkerOptions ()

새 마커 옵션 집합을 만듭니다.

공개 메서드

public MarkerOptions alpha (부동 소수점 수 알파)

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

매개변수

알파

반환 값

새 알파 집합이 포함된 메서드가 호출된 객체입니다.

public MarkerOptions anchor (float u, float v)

마커 이미지의 특정 지점에 위치하도록 앵커를 지정합니다.

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

앵커 포인트는 연속 공간 [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)
 |     |     |     |     |
 |     |     |     |     |
 *-----+-----+-----+-----*

매개변수

u	이미지 너비에 대한 비율인 앵커의 u 좌표([0, 1] 범위)
v	이미지 높이에 대한 비율인 앵커의 v 좌표입니다([0, 1] 범위).

반환 값

새 앵커 세트와 함께 메서드가 호출된 객체입니다.

public MarkerOptions collisionBehavior (int collisionBehavior)

마커의 충돌 상태를 설정합니다. Marker.CollisionBehavior의 값입니다. 한 번만 설정할 수 있습니다.

매개변수

collisionBehavior

반환 값

충돌 상태가 설정된 상태로 메서드가 호출된 객체입니다.

public MarkerOptions draggable (boolean draggable)

마커의 드래그 가능 여부를 설정합니다.

매개변수

드래그 가능

반환 값

새 드래그 가능 상태가 설정된 상태에서 메서드가 호출된 객체입니다.

공개 MarkerOptions flat (부울 플랫)

이 마커를 지도 true에 평평하게 놓아야 하는지 아니면 카메라 false를 향한 빌보드에 평평해야 하는지 설정합니다. 마커가 지도에 평행인 경우 카메라가 회전하거나 기울어질 때 지도에 고정된 상태로 유지되지만, GroundOverlay와 달리 카메라 확대/축소와 동일한 크기는 유지됩니다. 마커가 빌보드인 경우 항상 카메라를 바라보고 그려지며 카메라와 함께 회전하고 기울어집니다. 기본값은 false입니다.

매개변수

일정함

반환 값

새 평면 상태가 설정된 상태로 메서드가 호출된 객체입니다.

public float getAlpha ()

이 MarkerOptions 객체의 알파 집합을 가져옵니다.

반환 값

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

public float getAnchorU ()

왼쪽 가장자리로부터 앵커의 수평 거리([0, 1]로 정규화됨).

반환 값

앵커의 u 값입니다.

public float getAnchorV ()

상단 가장자리로부터 앵커의 수직 거리([0, 1]로 정규화됨)입니다.

반환 값

앵커의 v 값입니다.

public int getCollisionBehavior ()

공개 BitmapDescriptor getIcon ()

이 MarkerOptions 객체에 설정된 맞춤 아이콘 설명어를 가져옵니다.

반환 값

맞춤 아이콘을 나타내는 BitmapDescriptor 또는 맞춤 아이콘이 설정되지 않은 경우 null입니다.

public float getInfoWindowAnchorU ()

왼쪽 가장자리에서 정보 창 앵커의 수평 거리([0, 1]로 정규화됨).

반환 값

정보창 앵커의 u 값입니다.

public float getInfoWindowAnchorV ()

상단 가장자리로부터 정보 창 앵커의 수직 거리([0, 1]로 정규화됨).

반환 값

정보창 앵커의 v 값입니다.

공개 LatLng getPosition ()

이 MarkerOptions 객체에 설정된 위치를 반환합니다.

반환 값

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

public float getRotation ()

이 MarkerOptions 객체에 설정된 회전을 가져옵니다.

반환 값

기본 위치에서 시계 방향의 마커 회전 각도를 나타냅니다.

공개 문자열 getSnippet ()

이 MarkerOptions 객체에 설정된 스니펫을 가져옵니다.

반환 값

마커의 스니펫이 포함된 문자열입니다.

공개 문자열 getTitle ()

이 MarkerOptions 객체에 설정된 제목을 가져옵니다.

반환 값

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

public float getZIndex ()

이 MarkerOptions 객체에 설정된 zIndex를 가져옵니다.

반환 값

마커의 zIndex.

공개 MarkerOptions 아이콘 (BitmapDescriptor iconDescriptor)

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

매개변수

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

반환 값

새 아이콘 설명어가 설정된 상태로 메서드가 호출된 객체입니다.

공개 MarkerOptions infoWindowAnchor (float u, float v)

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

매개변수

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

반환 값

새 정보창 앵커가 설정된 상태로 메서드가 호출된 객체입니다.

공개 불리언 isDraggable ()

이 MarkerOptions 객체의 드래그 가능 여부 설정을 가져옵니다.

반환 값

마커를 드래그할 수 있으면 true, 드래그할 수 있으면 false를 반환합니다.

공개 부울 isFlat ()

이 MarkerOptions 객체의 평면 설정을 가져옵니다.

반환 값

마커가 지도에 평행인 경우 true, 마커가 카메라를 향해야 하면 false

공개 불리언 isVisible ()

이 MarkerOptions 객체의 공개 상태 설정을 가져옵니다.

반환 값

마커가 표시되면 true, 그렇지 않으면 false을 반환합니다.

public MarkerOptions position (LatLng 위도/경도)

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

매개변수

위도/경도

반환 값

새 위치가 설정된 메서드가 호출된 객체입니다.

public MarkerOptions 회전 (부동 소수점 회전)

마커의 앵커 포인트를 기준으로 마커의 회전 각도를 시계 방향으로 설정합니다. 회전 축은 마커와 직각입니다. 회전이 0이면 마커의 기본 위치에 해당합니다. 지도에서 마커가 평면인 경우 기본 위치는 북쪽 정렬이며 회전은 마커가 지도에서 항상 평평한 상태로 유지됩니다. 마커가 빌보드인 경우 기본 위치는 위를 가리키며 마커는 항상 카메라를 향하도록 회전합니다. 기본값은 0입니다.

매개변수

회전

반환 값

새 회전이 설정된 상태에서 메서드가 호출된 객체입니다.

공개 MarkerOptions 스니펫 (문자열 스니펫)

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

매개변수

snippet

반환 값

새 스니펫이 설정된 상태로 메서드가 호출된 객체입니다.

public MarkerOptions title (문자열 제목)

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

매개변수

제목

반환 값

새 제목이 설정된 메서드가 호출된 객체입니다.

공개 MarkerOptions 표시 (boolean visible)

마커의 가시성을 설정합니다.

매개변수

표시

반환 값

새 가시성 상태가 설정된 상태로 메서드가 호출된 객체입니다.

공개 MarkerOptions zIndex (부동 소수점 수 zIndex)

마커의 zIndex를 설정합니다.

매개변수

zIndex

반환 값

새 zIndex가 설정된 상태로 메서드가 호출된 객체입니다.