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

GroundOverlayOptions

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

지면 오버레이에 대한 옵션을 정의합니다.

상수 요약

float NO_DIMENSION 높이에 지정된 치수가 없는 경우의 플래그입니다.

상속받은 상수 요약

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

int	CONTENTS_FILE_DESCRIPTOR
int	PARCELABLE_WRITE_RETURN_VALUE

공개 생성자 요약

GroundOverlayOptions()

새 지상 오버레이 옵션 집합을 만듭니다.

공개 메서드 요약

GroundOverlayOptions	anchor(float u, float v) 앵커를 지정합니다.
GroundOverlayOptions	bearing(부동 소수점 방위) 지면 오버레이의 방위를 북쪽에서 시계 방향의 각도로 지정합니다.
GroundOverlayOptions	clickable(부울 클릭 가능) 지면 오버레이를 클릭할 수 있는지 여부를 지정합니다.
float	getAnchorU() 가로 상대 앵커, `0.0` 및 `1.0`는 각각 왼쪽 및 오른쪽 가장자리를 나타냅니다.
float	getAnchorV() 세로 상대 앵커. `0.0` 및 `1.0`는 각각 상단 및 하단 가장자리를 나타냅니다.
float	getBearing() 이 `GroundOverlayOptions` 객체의 방위 집합을 가져옵니다.
LatLngBounds	getBounds() 이 `GroundOverlayOptions` 객체에 설정된 경계를 가져옵니다.
float	getHeight() 이 `GroundOverlayOptions` 객체에 설정된 높이를 가져옵니다.
BitmapDescriptor	getImage() 이 `GroundOverlayOptions` 객체에 설정된 이미지 설명어를 가져옵니다.
LatLng	getLocation() 이 `GroundOverlayOptions` 객체에 설정된 위치를 가져옵니다.
float	getTransparency() 이 `GroundOverlayOptions` 객체에 설정된 투명도를 가져옵니다.
float	getWidth() 이 `GroundOverlayOptions` 객체에 설정된 너비를 가져옵니다.
float	getZIndex() 이 `GroundOverlayOptions` 객체에 설정된 zIndex를 가져옵니다.
GroundOverlayOptions	image(BitmapDescriptor imageDescriptor) 이 지면 오버레이의 이미지를 지정합니다.
boolean	isClickable() 이 `GroundOverlayOptions` 객체의 클릭 가능 여부 설정을 가져옵니다.
boolean	isVisible() 이 `GroundOverlayOptions` 객체의 공개 상태 설정을 가져옵니다.
GroundOverlayOptions	position(LatLng 위치, 부동 소수점 너비) 앵커 포인트 (`LatLng`)와 너비 (단위: 미터)를 사용하여 이 지면 오버레이의 위치를 지정합니다.
GroundOverlayOptions	position(LatLng location, float 너비, float 높이) 앵커 포인트 (`LatLng`), 너비, 높이 (둘 다 미터)를 사용하여 이 지면 오버레이의 위치를 지정합니다.
GroundOverlayOptions	positionFromBounds(LatLngBounds 경계) 이 지면 오버레이의 위치를 지정합니다.
GroundOverlayOptions	투명도(플로팅 투명도) 지면 오버레이의 투명도를 지정합니다.
GroundOverlayOptions	visible(불리언 표시) 지면 오버레이의 가시성을 지정합니다.
GroundOverlayOptions	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)

상수

공개 정적 최종 부동 소수점 수 NO_DIMENSION

높이에 지정된 치수가 없는 경우의 플래그입니다.

상수 값: -1.0

공개 생성자

공개 GroundOverlayOptions ()

새 지상 오버레이 옵션 집합을 만듭니다.

공개 메서드

공개 GroundOverlayOptions 앵커 (float u, float v)

앵커를 지정합니다.

앵커는 지면 오버레이의 위치에 맞춰 정렬됩니다.

앵커 포인트는 2D 연속 공간에 지정됩니다. 여기서 (0,0), (1,0), (0,1), (1,1)은 각각 왼쪽 상단, 오른쪽 상단, 왼쪽 하단, 오른쪽 하단 모서리를 나타냅니다.

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

매개변수

u	앵커의 u 좌표
v	앵커의 v 좌표

반환 값

새 앵커 세트가 있는 이 GroundOverlayOptions 객체를 반환합니다.

공개 GroundOverlayOptions 베어링 (부동 소수점 수 방위)

지면 오버레이의 방위를 북쪽에서 시계 방향의 각도로 지정합니다. 앵커 포인트를 기준으로 회전이 실행됩니다. 지정하지 않으면 기본값은 0입니다. 즉, 이미지에서 위쪽이 북쪽을 향합니다.

위도-경도 경계는 회전 전에 적용됩니다.

매개변수

방위	북쪽에서 시계 방향의 방위입니다(단위: 도). [0, 360) 범위를 벗어나는 값은 정규화됩니다.

반환 값

새 방위 집합이 있는 이 GroundOverlayOptions 객체입니다.

공개 GroundOverlayOptions 클릭 가능 (부울 클릭 가능)

지면 오버레이를 클릭할 수 있는지 여부를 지정합니다. 기본 클릭 가능 여부는 false입니다.

매개변수

클릭 가능	새 클릭 가능 여부 설정

반환 값

이 GroundOverlayOptions 객체에는 새 클릭 가능 여부 설정이 포함됩니다.

public float getAnchorU ()

가로 상대 앵커, 0.0 및 1.0는 각각 왼쪽 및 오른쪽 가장자리를 나타냅니다. 다른 앵커 값은 이에 따라 보간됩니다.

반환 값

가로 가장자리를 기준으로 한 앵커 위치입니다.

public float getAnchorV ()

세로 상대 앵커. 0.0 및 1.0는 각각 상단 및 하단 가장자리를 나타냅니다. 다른 앵커 값은 이에 따라 보간됩니다.

반환 값

세로 가장자리를 기준으로 한 앵커 위치입니다.

public float getBearing ()

이 GroundOverlayOptions 객체의 방위 집합을 가져옵니다.

반환 값

지면 오버레이의 방위입니다.

공개 LatLngBounds getBounds ()

이 GroundOverlayOptions 객체에 설정된 경계를 가져옵니다.

반환 값

지면 오버레이의 경계 내에 있는 것입니다. 위치가 position(LatLng, float) 또는 position(LatLng, float, float)를 사용하여 설정된 경우 null입니다.

public float getHeight ()

이 GroundOverlayOptions 객체에 설정된 높이를 가져옵니다.

반환 값

지면 오버레이의 높이입니다.

공개 BitmapDescriptor getImage ()

이 GroundOverlayOptions 객체에 설정된 이미지 설명어를 가져옵니다.

반환 값

지면 오버레이의 이미지를 나타내는 BitmapDescriptor입니다.

공개 LatLng getLocation ()

이 GroundOverlayOptions 객체에 설정된 위치를 가져옵니다.

반환 값

지면 오버레이의 앵커를 배치할 위치입니다. 위치가 positionFromBounds(LatLngBounds)를 사용하여 설정된 경우 null입니다.

public float getTransparency ()

이 GroundOverlayOptions 객체에 설정된 투명도를 가져옵니다.

반환 값

지면 오버레이의 투명도

public float getWidth ()

이 GroundOverlayOptions 객체에 설정된 너비를 가져옵니다.

반환 값

지면 오버레이의 너비

public float getZIndex ()

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

반환 값

지면 오버레이의 zIndex입니다.

공개 GroundOverlayOptions image (BitmapDescriptor imageDescriptor)

이 지면 오버레이의 이미지를 지정합니다.

이미지를 텍스처로 로드하려면 (지도에 이미지를 그리는 데 사용됨), 변의 길이가 2의 거듭제곱인 이미지로 변환해야 합니다. 이는 다양한 확대/축소 수준에서 텍스처를 렌더링하기 위해 밉맵을 만들 수 있도록 하기 위함입니다. 자세한 내용은 밉맵 (위키백과)을 참고하세요. 따라서 이 변환을 방지하여 메모리를 절약하려면 이미지 크기가 2의 거듭제곱인 것이 좋습니다.

매개변수

imageDescriptor	이 지면 오버레이에 사용할 `BitmapDescriptor`

반환 값

새 이미지 세트로 이 GroundOverlayOptions 객체를 반환합니다.

공개 불리언 isClickable ()

이 GroundOverlayOptions 객체의 클릭 가능 여부 설정을 가져옵니다.

반환 값

지면 오버레이를 클릭할 수 있는 경우 true, 클릭할 수 없는 경우 false입니다.

공개 불리언 isVisible ()

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

반환 값

이 지면 오버레이가 표시되면 true, 그렇지 않으면 false입니다.

공개 GroundOverlayOptions 위치 (LatLng 위치, 부동 소수점 너비)

앵커 포인트 (LatLng)와 너비 (단위: 미터)를 사용하여 이 지면 오버레이의 위치를 지정합니다. 높이는 가로세로 비율을 유지하기 위해 적절하게 조정됩니다.

매개변수

위치	지도 `LatLng` 상에서 지정된 이미지의 앵커 포인트가 고정된 상태로 유지되는 위치입니다. 앵커는 변환 (예: setDimension, setBearing 등)이 적용될 때 지면의 위치에 고정됩니다.
너비	오버레이의 너비 (단위: 미터)입니다. 높이는 이미지의 가로세로 비율에 따라 자동으로 결정됩니다.

반환 값

새로운 위치가 설정된 이 GroundOverlayOptions 객체입니다.

생성 값

IllegalArgumentException	앵커가 `null`인 경우
IllegalArgumentException	너비가 음수인 경우
IllegalStateException	위치가 `positionFromBounds(LatLngBounds)`를 사용하여 이미 설정된 경우

public GroundOverlayOptions position (LatLng 위치, 플로팅 너비, 플로팅 높이)

앵커 포인트 (LatLng), 너비, 높이 (둘 다 미터)를 사용하여 이 지면 오버레이의 위치를 지정합니다. 렌더링할 때 이미지는 지정된 크기에 맞게 조정됩니다.

매개변수

위치	지도 `LatLng` 상에서 지정된 이미지의 앵커 포인트가 고정된 상태로 유지되는 위치입니다. 앵커는 변환 (예: setDimension, setBearing 등)이 적용될 때 지면의 위치에 고정됩니다.
너비	오버레이의 너비 (미터)
높이	오버레이의 높이 (미터)

반환 값

새로운 위치가 설정된 이 GroundOverlayOptions 객체입니다.

생성 값

IllegalArgumentException	앵커가 `null`인 경우
IllegalArgumentException	너비 또는 높이가 음수인 경우
IllegalStateException	위치가 `positionFromBounds(LatLngBounds)`를 사용하여 이미 설정된 경우

공개 GroundOverlayOptions positionFromBounds (LatLngBounds 경계)

이 지면 오버레이의 위치를 지정합니다.

매개변수

bounds	지면 오버레이를 배치할 `LatLngBounds`

반환 값

새로운 위치가 설정된 이 GroundOverlayOptions 객체입니다.

생성 값

IllegalStateException	위치가 `position(LatLng, float)` 또는 `position(LatLng, float, float)`를 사용하여 이미 설정된 경우

공개 GroundOverlayOptions 투명도 (플로트 투명도)

지면 오버레이의 투명도를 지정합니다. 기본 투명도는 0 (불투명)입니다.

매개변수

투명성	`[0..1]` 범위의 부동 소수점입니다. 여기서 `0`는 지면 오버레이가 불투명함을 의미하고 `1`는 지면 오버레이가 투명함을 의미합니다.

반환 값

이 GroundOverlayOptions 객체를 새로운 투명도 설정으로 사용합니다.

생성 값

IllegalArgumentException	투명도가 [0..1] 범위를 벗어나는 경우

공개 GroundOverlayOptions 표시 (boolean visible)

지면 오버레이의 가시성을 지정합니다. 기본 공개 상태는 true입니다.

매개변수

표시

반환 값

이 GroundOverlayOptions 객체에 새로운 공개 상태 설정을 적용합니다.

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

지면 오버레이의 zIndex(즉, 지면을 그리는 순서)를 지정합니다. zIndex에 대한 자세한 내용은 이 클래스 상단에 있는 문서를 참조하세요.

매개변수

zIndex

반환 값

새로운 zIndex가 설정된 GroundOverlayOptions 객체를 반환합니다.