Package com.naver.maps.map.overlay

Class GroundOverlay

java.lang.Object
com.naver.maps.map.overlay.Overlay
com.naver.maps.map.overlay.GroundOverlay
All Implemented Interfaces:
Pickable
public final class GroundOverlay extends Overlay
지도에서 특정 영역을 나타내는 오버레이. 지도에 추가하기 전에 반드시 setBounds(LatLngBounds)와 setImage(OverlayImage)를 호출해 영역 및 이미지를 지정해야 하며, 그렇지 않으면 예외가 발생합니다.

  • Field Details

  • Constructor Details

    • GroundOverlay

      public GroundOverlay()
      기본 생성자.

    • GroundOverlay

      public GroundOverlay(@NonNull com.naver.maps.geometry.LatLngBounds bounds, @NonNull OverlayImage image)
      영역과 이미지를 지정하는 생성자. 만약 bounds가 빈(LatLngBounds.isEmpty()가 true인) 영역이라면 Overlay.InvalidBoundsException이 발생합니다.
      Parameters:
      bounds - 영역.
      image - 이미지.
      Throws:
      Overlay.InvalidBoundsException - bounds가 유효하지 않은 경우 발생.

  • Method Details

    • setMap

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

      지상 오버레이를 지도에 추가하기 전에는 반드시 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 com.naver.maps.geometry.LatLngBounds getBounds()
      영역을 반환합니다.

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

    • setBounds

      @UiThread public void setBounds(@NonNull com.naver.maps.geometry.LatLngBounds bounds)
      영역을 지정합니다. 지상 오버레이를 지도에 추가하기 전에 반드시 이 메서드를 호출해 영역을 지정해야 합니다. 만약 bounds가 빈(LatLngBounds.isEmpty()가 true인) 영역이라면 Overlay.InvalidBoundsException이 발생합니다.
      Parameters:
      bounds - 영역.
      Throws:
      Overlay.InvalidBoundsException - bounds가 유효하지 않은 경우 발생.

    • getImage

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

    • setImage

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

    • getAlpha

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

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

    • setAlpha

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

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