Class GroundOverlay

  • All Implemented Interfaces:
    Pickable

    public final class GroundOverlay
    extends Overlay
    지도에서 특정 영역을 나타내는 오버레이. 지도에 추가하기 전에 반드시 setBounds(LatLngBounds)setImage(OverlayImage)를 호출해 영역 및 이미지를 지정해야 하며, 그렇지 않으면 예외가 발생합니다.
    • Method Detail

      • setMap

        public void setMap​(@Nullable
                           NaverMap map)
        오버레이를 map에 추가합니다. mapnull을 지정하면 지도에서 제거됩니다.

        지상 오버레이를 지도에 추가하기 전에는 반드시 setBounds(LatLngBounds)로 영역을 지정해야 합니다. 그렇지 않을 경우 Overlay.InvalidBoundsException이 발생합니다.
        Overrides:
        setMap in class Overlay
        Parameters:
        map - 오버레이를 추가할 지도 객체.
        Throws:
        Overlay.InvalidBoundsException - bounds를 지정하지 않은 경우 발생.
      • getGlobalZIndex

        public int getGlobalZIndex()
        전역 Z 인덱스를 반환합니다. 여러 오버레이가 화면에서 겹쳐지면 전역 Z 인덱스가 큰 오버레이가 작은 오버레이를 덮습니다. 또한 값이 0 이상이면 오버레이가 심벌 위에, 0 미만이면 심벌 아래에 그려집니다.

        기본값은 DEFAULT_GLOBAL_Z_INDEX입니다.
        Overrides:
        getGlobalZIndex in class Overlay
        Returns:
        전역 Z 인덱스.
      • setGlobalZIndex

        public void setGlobalZIndex​(int globalZIndex)
        전역 Z 인덱스를 지정합니다. 여러 오버레이가 화면에서 겹쳐지면 전역 Z 인덱스가 큰 오버레이가 작은 오버레이를 덮습니다. 또한 값이 0 이상이면 오버레이가 심벌 위에, 0 미만이면 심벌 아래에 그려집니다.

        기본값은 DEFAULT_GLOBAL_Z_INDEX입니다.
        Overrides:
        setGlobalZIndex in class Overlay
        Parameters:
        globalZIndex - 전역 Z 인덱스.
      • getBounds

        @NonNull
        @UiThread
        public LatLngBounds getBounds()
        영역을 반환합니다.

        기본값은 빈(LatLngBounds.isEmpty()true인) 영역입니다.
        Returns:
        영역.
      • getImage

        @NonNull
        @UiThread
        public OverlayImage getImage()
        이미지를 반환합니다.
        Returns:
        이미지.
      • setImage

        @UiThread
        public void setImage​(@NonNull
                             OverlayImage image)
        이미지를 지정합니다.
        Parameters:
        image - 이미지.
      • getAlpha

        @UiThread
        public float getAlpha()
        불투명도를 0~1로 반환합니다. 0일 경우 완전히 투명, 1일 경우 완전히 불투명함을 의미합니다.

        기본값은 1입니다.
        Returns:
        불투명도.
      • setAlpha

        @UiThread
        public void setAlpha​(float alpha)
        불투명도를 0~1로 지정합니다. 0일 경우 완전히 투명, 1일 경우 완전히 불투명함을 의미합니다.

        기본값은 1입니다.
        Parameters:
        alpha - 불투명도.