Package com.inavi.mapsdk.style.shapes

Class InvMarker

java.lang.Object
com.inavi.mapsdk.style.shapes.InvShape
com.inavi.mapsdk.style.shapes.InvMarker
All Implemented Interfaces:
InvMarkerOptions, InvShapeOptions
public final class InvMarker extends InvShape implements InvMarkerOptions
지도 위에 아이콘과 타이틀을 이용해 한 지점을 표출하는 셰이프 클래스.

  • Field Details

    • DEFAULT_GLOBAL_Z_INDEX

      public static final int DEFAULT_GLOBAL_Z_INDEX
      기본 전역 Z 인덱스.
      See Also:

    • DEFAULT_ICON

      public static final InvImage DEFAULT_ICON
      기본 아이콘.

  • Constructor Details

  • Method Details

    • getPosition

      public LatLng getPosition()
      마커의 위치 좌표를 반환합니다.
      Specified by:
      getPosition in interface InvMarkerOptions
      Returns:
      마커의 좌표

    • setPosition

      public void setPosition(LatLng position) throws InvalidLatLngException
      마커의 위치 좌표를 설정합니다.
      Specified by:
      setPosition in interface InvMarkerOptions
      Parameters:
      position - 마커의 좌표
      Throws:
      InvalidLatLngException - 설정할 좌표가 유효하지 않으면 발생합니다.

    • getIconImage

      public InvImage getIconImage()
      마커의 아이콘 이미지를 반환합니다.
      Specified by:
      getIconImage in interface InvMarkerOptions
      Returns:
      아이콘 이미지

    • setIconImage

      public void setIconImage(InvImage iconImage)
      마커의 아이콘 이미지를 설정합니다.
      Specified by:
      setIconImage in interface InvMarkerOptions
      Parameters:
      iconImage - 아이콘 이미지

    • getAnchor

      public PointF getAnchor()

      마커 아이콘의 앵커(기준점)를 반환합니다.

      기본값은 {@link PointF(0.5, 1)}입니다.
      Specified by:
      getAnchor in interface InvMarkerOptions
      Returns:
      마커 아이콘의 앵커

    • setAnchor

      public void setAnchor(PointF anchor)
      마커 아이콘의 앵커(기준점)을 설정합니다.

      앵커의 좌표로 설정된 지점이 실제 표출되는 마커의 기준 위치가 되며, 마커 회전 시 해당 좌표를 축으로 회전하게 됩니다.
      앵커의 범위는 (0.0, 0.0)~(1.0, 1.0)이며, (0, 0)일 경우 마커 이미지의 top-left, (1, 1)일 경우 마커 이미지의 bottom-right가 기준점이 됩니다.

      기본값은 {@link PointF(0.5, 1)}입니다.
      Specified by:
      setAnchor in interface InvMarkerOptions
      Parameters:
      anchor - 마커 아이콘의 앵커

    • getTitle

      public String getTitle()
      마커의 타이틀 텍스트 문구를 반환합니다.
      Specified by:
      getTitle in interface InvMarkerOptions
      Returns:
      타이틀

    • setTitle

      public void setTitle(String title)
      마커의 타이틀 텍스트 문구를 설정합니다.
      Specified by:
      setTitle in interface InvMarkerOptions
      Parameters:
      title - 타이틀

    • getTitleSize

      public float getTitleSize()

      마커의 타이틀 텍스트 크기를 반환합니다. (DP 단위)

      기본값은 12입니다.
      Specified by:
      getTitleSize in interface InvMarkerOptions
      Returns:
      텍스트 크기

    • setTitleSize

      public void setTitleSize(float titleSize)

      마커의 타이틀 텍스트 크기를 설정합니다. (DP 단위)

      기본값은 12입니다.
      Specified by:
      setTitleSize in interface InvMarkerOptions
      Parameters:
      titleSize - 텍스트 크기

    • getTitleColor

      public int getTitleColor()

      마커의 타이틀 텍스트 색상을 반환합니다.

      기본값은 Color.BLACK입니다.
      Specified by:
      getTitleColor in interface InvMarkerOptions
      Returns:
      텍스트 색상

    • setTitleColor

      public void setTitleColor(int titleColor)

      마커의 타이틀 텍스트 색상을 설정합니다.

      기본값은 Color.BLACK입니다.
      Specified by:
      setTitleColor in interface InvMarkerOptions
      Parameters:
      titleColor - 텍스트 색상

    • getTitleHaloColor

      public int getTitleHaloColor()

      마커의 타이틀 텍스트 테두리 색상을 반환합니다.

      기본값은 Color.WHITE입니다.
      Specified by:
      getTitleHaloColor in interface InvMarkerOptions
      Returns:
      테두리 색상

    • setTitleHaloColor

      public void setTitleHaloColor(int haloColor)

      마커의 타이틀 텍스트 테두리 색상을 설정합니다.

      기본값은 Color.WHITE입니다.
      Specified by:
      setTitleHaloColor in interface InvMarkerOptions
      Parameters:
      haloColor - 테두리 색상

    • getTitleMaxWidth

      public int getTitleMaxWidth()

      마커의 타이틀 텍스트 한 줄당 최대 너비를 반환합니다. (픽셀 단위)

      기본값은 0입니다.
      Specified by:
      getTitleMaxWidth in interface InvMarkerOptions
      Returns:
      타이틀 최대 너비

    • setTitleMaxWidth

      public void setTitleMaxWidth(int titleMaxWidth)
      마커의 타이틀 텍스트 한 줄당 최대 너비를 설정합니다. (픽셀 단위)

      값을 지정할 경우 타이틀 텍스트의 길이가 최대 너비를 초과할 경우 강제 개행이 됩니다.
      개행은 어절 단위로 이루어지므로, 하나의 어절이 길 경우 최대 너비를 초과할 수 있습니다.
      0일 경우 너비를 제한하지 않습니다.

      기본값은 0입니다.
      Specified by:
      setTitleMaxWidth in interface InvMarkerOptions
      Parameters:
      titleMaxWidth - 타이틀 최대 너비

    • getTitleMargin

      public float getTitleMargin()

      아이콘과 타이틀 사이의 여백을 반환합니다. (픽셀 단위)

      기본값은 0입니다.
      Specified by:
      getTitleMargin in interface InvMarkerOptions
      Returns:
      아이콘과 타이틀 사이의 여백

    • setTitleMargin

      public void setTitleMargin(float titleMargin)

      아이콘과 타이틀 사이의 여백을 설정합니다. (픽셀 단위)

      기본값은 0입니다.
      Specified by:
      setTitleMargin in interface InvMarkerOptions
      Parameters:
      titleMargin - 아이콘과 타이틀 사이의 여백

    • getAlpha

      public float getAlpha()
      마커의 투명도를 반환합니다.

      값이 0이면 투명, 1이면 불투명을 의미합니다.

      기본값은 1입니다.
      Specified by:
      getAlpha in interface InvMarkerOptions
      Returns:
      투명도(0~1 사잇값)

    • setAlpha

      public void setAlpha(float alpha)
      마커의 투명도를 설정합니다.

      값을 0으로 설정하면 투명, 1로 설정하면 불투명이 됩니다.

      기본값은 1입니다.

      Specified by:
      setAlpha in interface InvMarkerOptions
      Parameters:
      alpha - 투명도(0~1 사잇값)

    • getAngle

      public float getAngle()

      마커 아이콘의 각도를 반환합니다.

      기본값은 0입니다.
      Specified by:
      getAngle in interface InvMarkerOptions
      Returns:
      마커 아이콘의 각도

    • setAngle

      public void setAngle(float angle)
      마커 아이콘의 각도를 설정합니다. (도 단위)

      값이 0이면 북쪽을 의미하며, 시계 방향으로 값이 증가합니다. 360의 배수마다 다시 북쪽이 됩니다.

      기본값은 0입니다.
      Specified by:
      setAngle in interface InvMarkerOptions
      Parameters:
      angle - 마커 아이콘의 각도

    • getIconScale

      public float getIconScale()
      마커의 아이콘 크기의 배율을 반환합니다.

      값을 3.0으로 설정하면 3배의 크기로 표출됩니다.

      기본값은 1입니다.
      Specified by:
      getIconScale in interface InvMarkerOptions
      Returns:
      아이콘의 배율

    • setIconScale

      public void setIconScale(float scale)
      마커의 아이콘 크기의 배율을 설정합니다.

      값이 3.0이면 3배의 크기로 의미합니다.

      기본값은 1입니다.
      Specified by:
      setIconScale in interface InvMarkerOptions
      Parameters:
      scale - 아이콘의 배율

    • isAllowOverlapMarkers

      public boolean isAllowOverlapMarkers()
      상위 다른 마커와 마커 겹침을 허용할지 여부를 반환합니다.

      기본값은 true입니다.

      Specified by:
      isAllowOverlapMarkers in interface InvMarkerOptions
      Returns:
      겹침을 허용하면 true, 허용하지 않으면 false

    • setAllowOverlapMarkers

      public void setAllowOverlapMarkers(boolean allowOverlap)
      상위 다른 마커와 마커 겹침을 허용할지 여부를 설정합니다.

      기본값은 true입니다.

      Specified by:
      setAllowOverlapMarkers in interface InvMarkerOptions
      Parameters:
      allowOverlap - 겹침을 허용하면 true, 허용하지 않으면 false

    • isAllowOverlapTitle

      public boolean isAllowOverlapTitle()
      상위 다른 마커와 마커의 타이틀 겹침을 허용할지 여부를 반환합니다.

      기본값은 true입니다.

      Specified by:
      isAllowOverlapTitle in interface InvMarkerOptions
      Returns:
      겹침을 허용하면 true, 허용하지 않으면 false

    • setAllowOverlapTitle

      public void setAllowOverlapTitle(boolean allowOverlap)
      상위 다른 마커와 마커의 타이틀 겹침을 허용할지 여부를 설정합니다.

      기본값은 true입니다.

      Specified by:
      setAllowOverlapTitle in interface InvMarkerOptions
      Parameters:
      allowOverlap - 겹침을 허용하면 true, 허용하지 않으면 false

    • isIconFlat

      public boolean isIconFlat()
      마커의 아이콘을 지도에 평평하게 표출할지 여부를 반환합니다.

      기본값은 false입니다.

      Specified by:
      isIconFlat in interface InvMarkerOptions
      Returns:
      Flat 적용 여부

    • setIconFlat

      public void setIconFlat(boolean iconFlat)
      마커의 아이콘을 지도에 평평하게 표출할지 여부를 설정합니다.

      기본값은 false입니다.

      Specified by:
      setIconFlat in interface InvMarkerOptions
      Parameters:
      iconFlat - Flat 적용 여부

    • isTransitionEnabled

      public boolean isTransitionEnabled()

      마커의 표출 상태가 변경될 때 애니메이션을 적용할지 여부를 반환합니다.

      기본값은 false입니다.
      Returns:
      애니메이션 적용 여부

    • setTransitionEnabled

      public void setTransitionEnabled(boolean transitionEnabled)

      마커의 표출 상태가 변경될 때 애니메이션을 적용할지 여부를 설정합니다.

      기본값은 false입니다.
      Parameters:
      transitionEnabled - 애니메이션 적용 여부

    • isTitleFlat

      public boolean isTitleFlat()
      마커의 타이틀을 지도에 평평하게 표출할지 여부를 반환합니다.

      기본값은 false입니다.

      Specified by:
      isTitleFlat in interface InvMarkerOptions
      Returns:
      Flat 적용 여부

    • setTitleFlat

      public void setTitleFlat(boolean titleFlat)
      마커의 타이틀을 지도에 평평하게 표출할지 여부를 설정합니다.

      기본값은 false입니다.

      Specified by:
      setTitleFlat in interface InvMarkerOptions
      Parameters:
      titleFlat - Flat 적용 여부

    • isAllowOverlapSymbols

      public boolean isAllowOverlapSymbols()
      마커와 지도상 심벌 겹침을 허용할지 여부를 반환합니다.

      기본값은 false입니다.

      Returns:
      겹침 허용 true, 겹침 허용 안 함 false

    • setAllowOverlapSymbols

      public void setAllowOverlapSymbols(boolean allowOverlap)
      마커와 지도상 심벌 겹침을 허용할지 여부를 설정합니다.

      값이 true이면 현재 마커와 겹쳐지는 지도상 심벌의 표출이 유지됩니다.

      기본값은 false입니다.

      Parameters:
      allowOverlap - 겹침 허용 true, 겹침 허용 안 함 false

    • getInfoWindow

      public InvInfoWindow getInfoWindow()
      마커에 표출되고 있는 InvInfoWindow 객체를 반환합니다.
      Returns:
      마커에 표출되고 있는 InvInfoWindow 객체

    • finalize

      protected void finalize() throws Throwable
      Overrides:
      finalize in class Object
      Throws:
      Throwable