지면 오버레이는 지도에 고정된 이미지입니다. 지면 오버레이에는 다음과 같은 속성이 있습니다.
- 직위
- 지면 오버레이의 위치를 지정하는 방법에는 두 가지가 있습니다.
- 위치 사용: 지면 오버레이의 이미지, 앵커를 고정할
LatLng
, 오버레이의 너비 (단위: 미터)를 제공해야 합니다. 앵커는 기본적으로 이미지 상단에서 50%, 이미지 왼쪽에서 50% 입니다. 이 설정은 변경할 수 있습니다. 선택사항으로 오버레이의 높이 (단위: 미터)를 지정할 수도 있습니다. 오버레이의 높이를 지정하지 않으면 이미지의 비율을 유지하도록 자동으로 계산됩니다. - 경계 사용: 이미지를 포함할
LatLngBounds
를 제공해야 합니다.
IllegalArgumentException
이 발생합니다. 또한GroundOverlayOptions
객체에서 이러한 메서드 중 하나를 사용하여 위치를 지정해야 합니다. 그러지 않으면 두 번째 메서드를 사용하여 지정할 때IllegalStateException
이 발생합니다. - 위치 사용: 지면 오버레이의 이미지, 앵커를 고정할
- 이미지
- 이 오버레이에 사용할 이미지입니다 (
BitmapDescriptor
로서). 제공된 위치에 맞게 이미지 크기가 조정됩니다. 지도에 지면 오버레이를 추가하기 전에 이미지를 지정해야 합니다. 이미지를 지정하지 않으면 지도에 추가할 때IllegalArgumentException
이 발생합니다. - 방위
- 이미지를 시계 방향으로 회전해야 하는 양입니다. 회전의 중심이 이미지의 앵커가 됩니다. 이는 선택사항이며 기본 방위는 0입니다. 즉, 위쪽이 북쪽이 되도록 이미지가 정렬됩니다.
- zIndex
- 다른 오버레이와 관련하여 이 지면 오버레이가 그려지는
순서입니다 (
Polyline
및TileOverlay
는 포함되지만Marker
은 포함되지 않음). zIndex가 큰 오버레이는 zIndex가 더 작은 오버레이 위에 그려집니다. zIndex 값이 동일한 오버레이의 순서는 무작위입니다. 이는 선택사항이며 기본 zIndex는 0입니다. - 투명성
[0..1]
범위의 지면 오버레이의 투명도입니다. 여기서0
는 오버레이가 불투명함을 의미하고1
는 오버레이가 완전히 투명함을 의미합니다. 지정된 비트맵이 이미 부분적으로 투명한 경우 각 픽셀의 투명도가 그에 따라 조정됩니다. 예를 들어 비트맵의 픽셀의 알파 값이 200이고 지면 오버레이의 투명도를 0.25로 지정하면 픽셀은 화면에서 알파 값 150으로 렌더링됩니다. 이 속성의 지정은 선택사항이며 기본 투명도는 0 (불투명)입니다.- 공개 상태
- 지면 오버레이가 지도에 표시되는지 여부(예: 지도에 그려지는지 여부)를
나타냅니다. 보이지 않는 지면 오버레이는 그려지지 않지만 다른 모든 속성은 유지합니다.
이는 선택사항이며 기본 공개 상태는
true
(visible)입니다. - 클릭 가능 여부
- 사용자가 지면 오버레이를 클릭할 때 실행되는 이벤트를 처리하려면 이 속성을
true
로 설정합니다. 이 값은 언제든지 변경할 수 있습니다. 기본값은false
입니다. 이 속성이true
로 설정된 경우 앱은setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener)
를 통해 등록된GoogleMap.OnGroundOverlayClickListener
로 알림을 수신합니다. - 태그
- 지면 오버레이와 연결된
Object
입니다. 예를 들어Object
에는 지면 오버레이가 나타내는 내용에 대한 데이터가 포함될 수 있습니다. 이는 별도로Map<GroundOverlay, Object>
를 저장하는 것보다 쉽습니다. 또 다른 예로, 데이터 세트의 ID에 해당하는String
ID를 연결할 수 있습니다. Android용 Google Maps SDK에서는 이 속성을 읽거나 쓰지 않습니다.
이 클래스의 메서드는 Android UI 스레드에서 호출되어야 합니다. 그러지 않으면 런타임에 IllegalStateException
이 발생합니다.
예
GoogleMap map = ...; // get a map.
BitmapDescriptor imageDescriptor = ...; // get an image.
LatLngBounds bounds = ...; // get a bounds
// Adds a ground overlay with 50% transparency.
GroundOverlay groundOverlay = map.addGroundOverlay(new GroundOverlayOptions()
.image(imageDescriptor)
.positionFromBounds(bounds)
.transparency(0.5));
공개 메서드 요약
boolean |
같음(기타 객체)
이
GroundOverlay 가 다른 것과 같은지 테스트합니다. |
float |
getBearing()
북쪽에서 시계 방향의 지면 오버레이의 방위(단위: 도)를 가져옵니다.
|
LatLngBounds |
getBounds()
지면 오버레이의 경계를 가져옵니다.
|
float |
getHeight()
지면 오버레이의 높이를 가져옵니다.
|
문자열 |
getId()
이 지면 오버레이의 ID를 가져옵니다.
|
LatLng |
getPosition()
앵커 포인트의 위치를 가져옵니다.
|
객체 |
getTag()
원의 태그를 가져옵니다.
|
float |
getTransparency()
이 지면 오버레이의 투명도를 가져옵니다.
|
float |
getWidth()
지면 오버레이의 너비를 가져옵니다.
|
float |
getZIndex()
이 지면 오버레이의 zIndex를 가져옵니다.
|
int |
hashCode()
|
boolean |
isClickable()
지면 오버레이의 클릭 가능 여부를 가져옵니다.
|
boolean |
isVisible()
이 지면 오버레이의 가시성을 가져옵니다.
|
void |
remove()
지도에서 이 지면 오버레이를 제거합니다.
|
void |
setBearing(플로트 방위)
지면 오버레이의 방위 (지면 오버레이의 세로 축이 가리키는 방향)를 북쪽에서
시계 방향으로 도 단위로 설정합니다.
|
void |
setClickable(부울 클릭 가능)
지면 오버레이의 클릭 가능 여부를 설정합니다.
|
void |
setDimensions(부동 소수점 너비, 플로팅 높이)
지면 오버레이의 크기를 설정합니다.
|
void |
setDimensions(부동 소수점 너비)
지면 오버레이의 너비를 설정합니다.
|
void | |
void | |
void | |
void |
setTag(객체 태그)
지면 오버레이에 대한 태그를 설정합니다.
|
void |
setTransparency(플로팅 투명도)
이 지면 오버레이의 투명도를 설정합니다.
|
void |
setVisible(불리언 표시)
이 지면 오버레이의 가시성을 설정합니다.
|
void |
setZIndex(부동 소수점 수 zIndex)
이 지면 오버레이의 zIndex를 설정합니다.
|
상속받은 메서드 요약
공개 메서드
공개 부울 같음 (기타 객체)
public float getBearing ()
북쪽에서 시계 방향의 지면 오버레이의 방위(단위: 도)를 가져옵니다.
반환 값
- 지면 오버레이의 방위입니다.
공개 LatLngBounds getBounds ()
지면 오버레이의 경계를 가져옵니다. 이렇게 하면 지면 오버레이의 회전이 무시됩니다.
반환 값
- 회전을 무시하고 지면 오버레이를 포함하는
LatLngBounds
public float getHeight ()
지면 오버레이의 높이를 가져옵니다.
반환 값
- 미터 단위의 지면 오버레이의 높이입니다.
공개 문자열 getId ()
이 지면 오버레이의 ID를 가져옵니다. ID는 지도의 모든 GroundOverlay 중에서 고유합니다.
반환 값
- 이 지면 오버레이의 ID입니다.
공개 객체 getTag ()
원의 태그를 가져옵니다.
반환 값
setTag
로 태그가 설정된 경우 태그, 설정된 태그가 없으면null
입니다.
public float getTransparency ()
이 지면 오버레이의 투명도를 가져옵니다.
반환 값
- 이 지면 오버레이의 투명도입니다.
public float getWidth ()
지면 오버레이의 너비를 가져옵니다.
반환 값
- 미터 단위의 지면 오버레이의 너비입니다.
public float getZIndex ()
이 지면 오버레이의 zIndex를 가져옵니다.
반환 값
- 지면 오버레이의 zIndex입니다.
public int hashCode ()
공개 불리언 isClickable ()
지면 오버레이의 클릭 가능 여부를 가져옵니다. 지면 오버레이를 클릭할 수 있는 경우
사용자가 지면 오버레이를 클릭하면 앱에서
GoogleMap.OnGroundOverlayClickListener
에 알림을 수신합니다. 이벤트 리스너는 setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener)
를 통해 등록됩니다.
반환 값
- 지면 오버레이를 클릭할 수 있는 경우
true
, 그렇지 않은 경우false
를 반환합니다.
공개 불리언 isVisible ()
이 지면 오버레이의 가시성을 가져옵니다. 이 메서드는 지면 오버레이가 실제로 화면에 있는지 여부를 반환하지 않고 카메라의 표시 영역에 포함된 경우 그려질지 여부를 반환합니다.
반환 값
- 표시합니다.
public void remove ()
지도에서 이 지면 오버레이를 제거합니다. 지면 오버레이가 삭제된 후에는 모든 메서드의 동작이 정의되지 않습니다.
public void setBearing (플로트 베어링)
지면 오버레이의 방위 (지면 오버레이의 세로 축이 가리키는 방향)를 북쪽에서 시계 방향으로 도 단위로 설정합니다. 앵커 포인트를 기준으로 회전이 실행됩니다.
매개변수
방위 | 북쪽에서 시계 방향의 방위각 |
---|
public void setClickable (부울 클릭 가능)
지면 오버레이의 클릭 가능 여부를 설정합니다. 지면 오버레이를 클릭할 수 있는 경우
사용자가 지면 오버레이를 클릭하면 앱에서
GoogleMap.OnGroundOverlayClickListener
에 알림을 수신합니다. 이벤트 리스너는 setOnGroundOverlayClickListener(GoogleMap.OnGroundOverlayClickListener)
를 통해 등록됩니다.
매개변수
클릭 가능 | 지면 오버레이에 대한 새로운 클릭 가능 여부 설정 |
---|
public void setDimensions (부동 소수점 수 너비, 플로팅 높이)
지면 오버레이의 크기를 설정합니다. 크기에 맞게 이미지가 늘어납니다.
매개변수
너비 | 너비(미터) |
---|---|
높이 | 키(미터) |
public void setDimensions (부동 소수점 너비)
지면 오버레이의 너비를 설정합니다. 지면 오버레이의 높이는 가로세로 비율을 유지하기 위해 그에 따라 조정됩니다.
매개변수
너비 | 너비(미터) |
---|
public void setImage (BitmapDescriptor imageDescriptor)
지면 오버레이에 대한 이미지를 설정합니다. 새 이미지는 이전 이미지와 동일한 경계를 차지합니다.
매개변수
imageDescriptor | 지면 오버레이에 사용할 BitmapDescriptor 입니다.
|
---|
public void setPosition (LatLng latLng)
앵커 포인트의 위치를 변경하여 지면 오버레이의 위치를 설정합니다. 이미지의 다른 모든 속성을 보존합니다.
매개변수
latLng | 앵커 포인트를 배치할 새 위치인 LatLng
|
---|
public void setPositionFromBounds (LatLngBounds 경계)
지면 오버레이를 지정된 LatLngBounds
에 맞추어 지면 오버레이의 위치를 설정합니다. 이
메서드는 지면 오버레이를 배치할 때 지면 오버레이의 회전 (방위)을 무시하지만
지면 오버레이를 그릴 때 방위는 계속 사용됩니다.
매개변수
bounds | 지면 오버레이를 배치할 LatLngBounds
|
---|
public void setTag (객체 태그)
지면 오버레이에 대한 태그를 설정합니다.
이 속성을 사용하여 임의의 Object
을 이 지면 오버레이와 연결할 수 있습니다.
예를 들어 Object
에는 지면 오버레이가 나타내는 내용에 관한 데이터가 포함될 수 있습니다. 이는 별도로 Map<GroundOverlay, Object>
를 저장하는 것보다 쉽습니다. 또 다른 예로, 데이터 세트의 ID에 해당하는 String
ID를 연결할 수 있습니다. Android용 Google Maps SDK에서는 이 속성을 읽거나 쓰지 않습니다. 앱에서 메모리 누수를 방지하기 위해 setTag(null)
를 호출하여 더 이상 필요하지 않은 태그를 삭제하도록 해야 합니다.
매개변수
태그 | null이면 태그가 지워집니다. |
---|
public void setTransparency (플로팅 투명도)
이 지면 오버레이의 투명도를 설정합니다. 자세한 내용은 이 클래스 상단에 있는 문서를 참조하세요.
매개변수
투명성 | [0..1] 범위의 부동 소수점입니다. 여기서 0 는 지면 오버레이가 불투명함을
의미하고 1 는 지면 오버레이가 투명함을 의미합니다.
|
---|
public void setVisible (boolean visible)
이 지면 오버레이의 가시성을 설정합니다. 표시되지 않으면 지면 오버레이는 그려지지 않지만 다른 모든 속성은 유지됩니다.
매개변수
표시 | true 인 경우 지면 오버레이가 표시되고 false 인 경우 지면 오버레이가 표시되지 않습니다.
|
---|
public void setZIndex (float zIndex)
이 지면 오버레이의 zIndex를 설정합니다. 자세한 내용은 이 클래스 상단에 있는 문서를 참조하세요.
매개변수
zIndex | 이 지면 오버레이의 zIndex |
---|