Package com.inavi.mapsdk.maps

Class LocationIcon

java.lang.Object
com.inavi.mapsdk.maps.LocationIcon
public final class LocationIcon extends Object

지도 위에 위치를 표출하는 아이콘 클래스.

아이콘의 모양 및 원의 반경 등을 설정하여 다양한 커스텀 위치 아이콘을 만들 수 있습니다.
InaviMap.getLocationIcon()을 통해서만 인스턴스를 얻을 수 있습니다.
See Also:

  • Field Details

    • DEFAULT_GLOBAL_Z_INDEX

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

    • DEFAULT_IMAGE

      public static final InvImage DEFAULT_IMAGE
      위치 아이콘의 기본 이미지. (투명도가 있는 빨간색)

    • DEFAULT_IMAGE_TRACKING

      public static final InvImage DEFAULT_IMAGE_TRACKING
      위치 추적 모드가 UserTrackingMode.Tracking 상태일 때 위치 아이콘의 기본 이미지.

    • DEFAULT_IMAGE_TRACKING_COMPASS

      public static final InvImage DEFAULT_IMAGE_TRACKING_COMPASS
      위치 추적 모드가 UserTrackingMode.TrackingCompass 상태일 때 위치 아이콘의 기본 이미지.

    • DEFAULT_CIRCLE_RADIUS

      public static final int DEFAULT_CIRCLE_RADIUS
      위치 아이콘 주변에 그려지는 원의 기본 반경. (DP 단위)
      See Also:

    • DEFAULT_CIRCLE_COLOR

      public static final int DEFAULT_CIRCLE_COLOR
      위치 아이콘 주변에 그려지는 원의 기본 색상.

  • Method Details

    • isVisible

      public boolean isVisible()

      위치 아이콘 표출 여부를 반환합니다.

      해당 값이 true이더라도 위치 좌표가 설정되지 않으면 위치 아이콘이 표출되지 않습니다.
      기본값은 true입니다.
      Returns:
      위치 아이콘 표출 여부

    • setVisible

      public void setVisible(boolean visible)

      위치 아이콘 표출 여부를 설정합니다.

      해당 값이 true이더라도 위치 좌표가 설정되지 않으면 위치 아이콘이 표출되지 않습니다.
      기본값은 true입니다.
      Parameters:
      visible - 위치 아이콘 표출 여부

    • getGlobalZIndex

      public int getGlobalZIndex()

      위치 아이콘의 전역 Z 인덱스를 반환합니다.

      기본값은 DEFAULT_GLOBAL_Z_INDEX입니다.
      Returns:
      전역 Z 인덱스

    • setGlobalZIndex

      public void setGlobalZIndex(int globalZIndex)

      위치 아이콘의 전역 Z 인덱스를 설정합니다.

      기본값은 DEFAULT_GLOBAL_Z_INDEX입니다.
      Parameters:
      globalZIndex - 전역 Z 인덱스

    • getPosition

      public LatLng getPosition()

      위치 아이콘의 위치 좌표를 반환합니다.

      위치 추적 모드 설정에 따라 자동으로 갱신됩니다.
      Returns:
      위치 아이콘의 위치 좌표
      See Also:

    • setPosition

      public void setPosition(LatLng position) throws InvalidLatLngException

      위치 아이콘의 위치 좌표를 설정합니다.

      위치 추적 모드 설정에 따라 자동으로 갱신됩니다.
      Parameters:
      position - 위치 아이콘의 위치 좌표
      Throws:
      InvalidLatLngException
      See Also:

    • getBearing

      public float getBearing()

      위치 아이콘이 지도상에서 바라보는 방향을 반환합니다. (도 단위)

      위치 추적 모드 설정에 따라 값이 자동으로 갱신됩니다.

      값이 0이면 북쪽을 의미하며, 시계 방향으로 값이 증가합니다. 360의 배수마다 다시 북쪽이 됩니다.
      기본값은 0입니다.
      Returns:
      위치 아이콘의 베어링
      See Also:

    • setBearing

      public void setBearing(float bearing)

      위치 아이콘이 지도상에서 바라보는 방향을 설정합니다. (도 단위)

      위치 추적 모드 설정에 따라 값이 자동으로 갱신됩니다.

      값이 0이면 북쪽을 의미하며, 시계 방향으로 값이 증가합니다. 360의 배수마다 다시 북쪽이 됩니다.
      기본값은 0입니다.
      Parameters:
      bearing - 위치 아이콘의 베어링
      See Also:

    • getScale

      public float getScale()

      위치 아이콘의 크기를 반환합니다. (배율 단위)

      값을 3.0으로 설정하면 3배의 크기로 표출됩니다.
      기본값은 1.0입니다.
      Returns:
      위치 아이콘의 크기

    • setScale

      public void setScale(float scale)

      위치 아이콘의 크기를 설정합니다. (배율 단위)

      값을 3.0으로 설정하면 3배의 크기로 표출됩니다.
      기본값은 1.0입니다.
      Parameters:
      scale - 위치 아이콘의 크기

    • getImage

      public InvImage getImage()

      위치 아이콘의 이미지를 반환합니다.

      위치 추적 모드가 UserTrackingMode.None이거나 UserTrackingMode.NoTracking일 때 이 아이콘이 표출됩니다.
      기본값은 DEFAULT_IMAGE입니다.
      Returns:
      위치 아이콘의 이미지

    • setImage

      public void setImage(InvImage image)

      위치 아이콘의 이미지를 설정합니다.

      위치 추적 모드가 UserTrackingMode.None이거나 UserTrackingMode.NoTracking일 때 이 아이콘이 표출됩니다.
      기본값은 DEFAULT_IMAGE입니다.
      Parameters:
      image - 위치 아이콘의 이미지

    • getImageTracking

      public InvImage getImageTracking()

      위치 추적 모드가 UserTrackingMode.Tracking일 때 위치 아이콘의 이미지를 반환합니다.

      기본값은 DEFAULT_IMAGE_TRACKING입니다.
      Returns:
      위치 추적 모드가 UserTrackingMode.Tracking 상태일 때 위치 아이콘의 이미지

    • setImageTracking

      public void setImageTracking(InvImage imageTracking)

      위치 추적 모드가 UserTrackingMode.Tracking일 때 위치 아이콘의 이미지를 설정합니다.

      기본값은 DEFAULT_IMAGE_TRACKING입니다.
      Parameters:
      imageTracking - 위치 추적 모드가 UserTrackingMode.Tracking 상태일 때 위치 아이콘의 이미지

    • getImageTrackingCompass

      public InvImage getImageTrackingCompass()

      위치 추적 모드가 UserTrackingMode.TrackingCompass일 때 위치 아이콘의 이미지를 반환합니다.

      기본값은 DEFAULT_IMAGE_TRACKING_COMPASS입니다.
      Returns:
      위치 추적 모드가 UserTrackingMode.TrackingCompass 상태일 때 위치 아이콘의 이미지

    • setImageTrackingCompass

      public void setImageTrackingCompass(InvImage imageTrackingCompass)

      위치 추적 모드가 UserTrackingMode.TrackingCompass일 때 위치 아이콘의 이미지를 설정합니다.

      기본값은 DEFAULT_IMAGE_TRACKING_COMPASS입니다.
      Parameters:
      imageTrackingCompass - 위치 추적 모드가 UserTrackingMode.TrackingCompass 상태일 때 위치 아이콘의 이미지

    • getCircleRadius

      public int getCircleRadius()

      위치 아이콘 주변에 그려지는 원의 반경을 반환합니다. (픽셀 단위)

      기본값은 DEFAULT_CIRCLE_RADIUS의 값을 픽셀 단위로 변환한 값입니다.
      Returns:
      위치 아이콘 주변에 그려지는 원의 반경

    • setCircleRadius

      public void setCircleRadius(int circleRadius)

      위치 아이콘 주변에 그려지는 원의 반경을 설정합니다. (픽셀 단위)

      기본값은 DEFAULT_CIRCLE_RADIUS의 값을 픽셀 단위로 변환한 값입니다.
      Parameters:
      circleRadius - 위치 아이콘 주변에 그려지는 원의 반경

    • getCircleColor

      public int getCircleColor()

      위치 아이콘 주변에 그려지는 원의 색상을 반환합니다.

      기본값은 DEFAULT_CIRCLE_COLOR입니다.
      Returns:
      위치 아이콘 주변에 그려지는 원의 색상

    • setCircleColor

      public void setCircleColor(int circleColor)

      위치 아이콘 주변에 그려지는 원의 색상을 설정합니다.

      기본값은 DEFAULT_CIRCLE_COLOR입니다.
      Parameters:
      circleColor - 위치 아이콘 주변에 그려지는 원의 색상

    • getOnClickListener

      public InvShape.OnClickListener getOnClickListener()
      위치 아이콘에 설정된 클릭 리스너를 반환합니다.
      Returns:
      이벤트를 받을 InvShape.OnClickListener 객체

    • setOnClickListener

      public void setOnClickListener(InvShape.OnClickListener clickListener)
      위치 아이콘에 클릭 리스너를 설정합니다.
      Parameters:
      clickListener - 이벤트를 받을 InvShape.OnClickListener 객체