Package com.kakao.vectormap.label

Class Label

  • public class Label
extends ILabel
    지도의 특정 위치에 이미지와 텍스트로 표시할 수 있는 클래스. Label 의 이미지와 텍스트의 설정은 LabelStyle 에서 할 수 있다.

    • Field Detail

      • direction

        public boolean direction
        PathOptions 을 설정할 때 방향을 설정하는 파라미터.

      • pathOptions

        public PathOptions pathOptions
        Label 이 이동하는 경로와 움직임을 정의하는 파라미터.

      • changes

        public int changes

    • Method Detail

      • changePixelOffset

        public void changePixelOffset​(float x,
                              float y)
        Label 의 위치에서 x, y 픽셀만큼 높여서 그린다. Label 이 갖고 있는 LabelStyles 중에 applyDpScale 이 한 개라도 false 이면 KakaoMap.getMapDpScale() 값이 곱해진다. 이 옵션을 무시하려면 changePixelOffset(float, float, boolean) 를 통해 forceDpScale 를 false 로 하면 된다. Label 이 갖고 있는 LabelStyles 중에 레벨 별로 applyDpScale 의 값이 true/false 가 섞여 있다면, applyDpScale 이 적용 된 스타일 레벨마다 offset 값은 보정 된다.
        Parameters:
        x - getPosition() 위치에서 가로로 x 픽셀 값
        y - getPosition() 위치에서 세로로 y 픽셀 값

      • changePixelOffset

        public void changePixelOffset​(float x,
                              float y,
                              boolean forceDpScale)
        Label 의 위치에서 x, y 픽셀만큼 높여서 그린다. Label 이 갖고 있는 LabelStyles 에 설정한 applyDpScale 이 모두 false 이면 KakaoMap.getMapDpScale() 값이 곱해진다. 이 옵션을 무시하려면 changePixelOffset(float, float, boolean) 를 통해 forceDpScale 를 false 로 하면 된다. Label 이 갖고 있는 LabelStyles 중에 레벨 별로 applyDpScale 의 값이 true/false 가 섞여 있다면, applyDpScale 이 적용 된 스타일 레벨마다 offset 값은 달라져서 보인다.
        Parameters:
        x - getPosition() 위치에서 가로로 x 픽셀 값
        y - getPosition() 위치에서 세로로 y 픽셀 값
        forceDpScale - LabelStyles 에 설정한 applyDpScale 이 모두 false 이면 KakaoMap.getMapDpScale() 값이 곱해지는 옵션.

      • getPixelOffset

        public PointF getPixelOffset()

      • show

        public void show​(boolean autoMove)
        지도에 Label 이 보여지게 한다.
        Parameters:
        autoMove - Label 이 나타날 때 스크린 화면에 짤려 가려질 때 다 보여질 수 있게 자동으로 움직이게 하는 설정 여부.

      • show

        public void show​(boolean autoMove,
                 int duration)
        지도에 Label 이 보여지게 한다.
        Parameters:
        autoMove - Label 이 나타날 때 스크린 화면에 짤려 가려질 때 다 보여질 수 있게 자동으로 움직이게 하는 설정 여부.
        duration - 자동으로 움직일 때 애니메이션 지속시간 (millis)

      • moveTo

        public void moveTo​(LatLng position)
        Label 을 즉시 특정 위치로 이동시킨다.
        Parameters:
        position - Label 을 이동시킬 위치 좌표.

      • rotateTo

        public void rotateTo​(float rotate)
        Label 을 즉시 특정 각도(radian)만큼 회전시킨다.
        Parameters:
        rotate - Label 을 회전시킬 각도 (radian)

      • scaleTo

        public void scaleTo​(float scaleX,
                    float scaleY)

      • moveTo

        public void moveTo​(LatLng position,
                   int millis)
        Label 을 애니메이션을 통해 특정 위치로 이동시킨다.
        Parameters:
        position - Label 을 이동시킬 위치 좌표.
        millis - 이동 애니메이션의 지속시간 (millis).

      • rotateTo

        public void rotateTo​(float rotate,
                     int millis)
        Label 을 애니메이션을 통해 특정 각도(radian)만큼 회전시킨다.
        Parameters:
        rotate - Label 을 회전시킬 각도 (radian)
        millis - 회전 애니메이션의 지속시간 (millis).

      • scaleTo

        public void scaleTo​(float scaleX,
                    float scaleY,
                    int millis)

      • setPathOptions

        public void setPathOptions​(PathOptions pathOptions)
        Label 에 PathOptions 을 설정한다.
        Parameters:
        pathOptions - Label 이 이동하는 경로와 움직임을 정의하는 파라미터.

      • setPathOptions

        public void setPathOptions​(PathOptions pathOptions,
                           boolean direction)
        Label 에 PathOptions 을 설정한다.
        Parameters:
        pathOptions - Label 이 이동하는 경로와 움직임을 정의하는 파라미터.
        direction - 움직일 때 방향성을 갖고 움직이도록 설정하는 파라미터.

      • getPathOptions

        public PathOptions getPathOptions()
        Label 에 설정 된 PathOptions 을 가져온다.

      • isDirection

        public boolean isDirection()
        Label 에 설정 된 PathOptions 에 direction 유무를 가져온다.

      • moveOnPath

        public void moveOnPath​(PathOptions options)
        Label 을 즉시 PathOptions 따라 움직이게 한다.
        Parameters:
        options - Label 이 이동하는 경로와 움직임을 정의하는 파라미터.

      • moveOnPath

        public void moveOnPath​(PathOptions options,
                       boolean direction)
        Label 을 즉시 PathOptions 따라 움직이게 한다.
        Parameters:
        options - Label 이 이동하는 경로와 움직임을 정의하는 파라미터.
        direction - 움직일 때 방향성을 갖고 움직이도록 설정하는 파라미터.

      • setStyles

        public void setStyles​(LabelStyles styles)
        Label 의 스타일을 변경한다. invalidate() 를 호출해야 변경이 업데이트 된다.
        Parameters:
        styles - LabelStyles

      • setStyles

        public void setStyles​(LabelStyle... styles)
        Label 의 스타일을 변경한다. invalidate() 를 호출해야 변경이 업데이트 된다.
        Parameters:
        styles - LabelStyle

      • setStyles

        public void setStyles​(int iconResId)
        Label 의 스타일을 변경한다. invalidate() 를 호출해야 변경이 업데이트 된다.
        Parameters:
        iconResId - Label 의 Icon

      • setStyles

        public void setStyles​(Bitmap iconBitmap)
        Label 의 스타일을 변경한다. invalidate() 를 호출해야 변경이 업데이트 된다.
        Parameters:
        iconBitmap -

      • setTexts

        public void setTexts​(java.lang.String... texts)
        Label 의 텍스트를 변경한다. LabelStyle 의 LabelTextStyle 을 설정해줘야 표시된다. invalidate() 를 호출해야 변경이 업데이트 된다.
        Parameters:
        texts -

      • invalidate

        public void invalidate()
        LabelStyle 과 텍스트를 업데이트 한다.

      • invalidate

        public void invalidate​(boolean enableTransition)
        LabelStyle 과 텍스트를 업데이트 한다.
        Parameters:
        enableTransition - Label 이 새롭게 업데이트 될 때 LabelTransition 을 적용할지 여부

      • getPosition

        public LatLng getPosition()
        Label 의 현재 위치를 가져온다.

      • getRotation

        public float getRotation()
        Label 의 현재 회전 값을 가져온다. Label 의 회전 값 (radian)

      • getScale

        public PointF getScale()
        Label 의 현재 Scale 값을 가져온다.

      • addShareTransform

        public void addShareTransform​(Label label)
        Label 과 함께 움직이는 또 다른 Label 을 연결한다.
        Parameters:
        label - 함께 움직일 또 다른 Label

      • addShareTransform

        public void addShareTransform​(Polygon polygon)
        Label 과 함께 움직일 또 다른 Polygon 을 연결한다.
        Parameters:
        polygon - 함께 움직 일 또 다른 Polygon

      • addSharePosition

        public void addSharePosition​(Label label)
        Label 의 위치를 따라 움직이는 또 다른 Label 을 추가할 수 있다.
        Parameters:
        label - 위치를 따라 움직이 또 다른 Label.

      • removeSharePosition

        public void removeSharePosition​(Label label)
        Label 의 위치를 따라 움직이는 또 다른 Label 을 삭제할 수 있다.
        Parameters:
        label - label 위치를 따라 움직이 또 다른 Label.

      • equals

        public boolean equals​(java.lang.Object o)
        Overrides:
        equals in class java.lang.Object

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class java.lang.Object

      • getLayerId

        public java.lang.String getLayerId()
        Label 이 속한 LabelLayer 의 Id 를 가져온다.

      • isLod

        public boolean isLod()
        현재 Label 이 LodLabel 인지 여부를 가져온다.

      • show

        public void show()
        지도에 Label 이 보여지게 한다.

      • hide

        public void hide()
        지도에 Label 사라지게 한다.

      • isShow

        public boolean isShow()
        현재 지도에 Label 보여지고 있는 여부를 가져온다.

      • setClickable

        public void setClickable​(boolean clickable)
        Label 의 click 여부를 설정한다.
        Parameters:
        clickable - click 여부.

      • isClickable

        public boolean isClickable()
        Label 의 click 여부를 가져온다.

      • setRank

        public void setRank​(long rank)
        Label 의 rank 를 설정한다.
        Parameters:
        rank - 설정 할 rank 값.

      • changeRank

        public void changeRank​(long rank)
        Label 의 rank 를 즉시 변경한다.
        Parameters:
        rank - 변경 할 rank 값.

      • changeStyles

        public void changeStyles​(LabelStyles styles)

      • changeStyles

        public void changeStyles​(LabelStyles styles,
                         boolean enableTransition)

      • changeText

        public void changeText​(java.lang.String... texts)

      • changeText

        public void changeText​(boolean enableTransition,
                       java.lang.String... texts)

      • changeStylesAndText

        public void changeStylesAndText​(LabelStyles styles,
                                java.lang.String... texts)

      • changeStylesAndText

        public void changeStylesAndText​(LabelStyles styles,
                                boolean enableTransition,
                                java.lang.String... texts)

      • getRank

        public long getRank()
        Label 의 rank 값을 가져온다.

      • setTag

        public void setTag​(java.lang.Object tag)
        사용자 식별을 위해 태그를 설정한다.
        Parameters:
        tag - 사용자 식별을 할 태그.

      • getTag

        public java.lang.Object getTag()
        태그를 가져온다.

      • getTexts

        public java.lang.String[] getTexts()
        Label 에 설정 된 텍스트를 가져온다.

      • getStyles

        public LabelStyles getStyles()
        Label 에 적용 된 LabelStyles 를 가져온다.

      • addBadge

        public Badge[] addBadge​(BadgeOptions... options)
        Label 에 Badge 를 추가한다.
        Parameters:
        options - 추가 할 Badge.
        Returns:
        추가 된 Badge.

      • removeBadge

        public void removeBadge​(Badge badge)
        Label 에 추가 된 Badge 를 제거한다.
        Parameters:
        badge -

      • removeAllBadge

        public void removeAllBadge()
        Label 에 추가 된 모든 Badge 를 삭제한다.