GroundOverlay

지면 오버레이는 지도에 고정된 이미지입니다. 지면 오버레이에는 다음과 같은 속성이 있습니다.

직위

지면 오버레이의 위치를 지정하는 방법에는 두 가지가 있습니다.

• 위치 사용: 지면 오버레이의 이미지, 앵커를 고정할 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));