GroundOverlay

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

위치

지면 오버레이의 위치를 지정하는 방법에는 두 가지가 있습니다. <ph type="x-smartling-placeholder">

</ph>
• 위치 사용: 지면 오버레이의 이미지(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, 즉 표시입니다.

클릭 가능 여부

사용자가 지면 오버레이를 클릭할 때 실행되는 이벤트를 처리하려면 다음과 같이 설정합니다. 속성을 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));