Package com.naver.maps.map

Class Projection

  • @UiThread
public final class Projection
extends java.lang.Object
    지리적 좌표와 화면 좌표 간의 변환을 담당하는 클래스. 이 클래스의 인스턴스는 직접 생성할 수 없고 NaverMap.getProjection()을 이용해야 가져올 수 있습니다.
    See Also:
    NaverMap.getProjection()

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      LatLng fromScreenLocation​(android.graphics.PointF point)
      화면 좌표를 위경도 좌표로 변환합니다.
      LatLng fromScreenLocationAt​(android.graphics.PointF point, double zoom, double tilt, double bearing, boolean wrap)
      화면 좌표를 카메라가 지정된 줌 레벨, 틸트/베어링 각도일 때의 위경도 좌표로 변환합니다.
      double getMetersPerDp()
      현재 지도의 축척을 미터/DP 단위로 반환합니다.
      static double getMetersPerDp​(double latitude, double zoom)
      카메라의 위도가 latitude, 줌 레벨이 zoom일 때의 축척을 미터/DP 단위로 반환합니다.
      double getMetersPerPixel()
      현재 지도의 축척을 미터/픽셀 단위로 반환합니다.
      double getMetersPerPixel​(double latitude, double zoom)
      카메라의 위도가 latitude, 줌 레벨이 zoom일 때의 축척을 미터/픽셀 단위로 반환합니다.
      android.graphics.PointF toScreenLocation​(LatLng coord)
      위경도 좌표를 화면 좌표로 변환합니다.
      android.graphics.PointF toScreenLocationAt​(LatLng coord, double zoom, double bearing, double tilt, boolean shortestPath)
      위경도 좌표를 카메라가 지정된 줌 레벨, 틸트/베어링 각도일 때의 화면 좌표로 변환합니다.

      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Method Detail

      • getMetersPerDp

        public static double getMetersPerDp​(@FloatRange(from=-85.05112877980659,to=85.05112877980659)
                                    double latitude,
                                    @FloatRange(from=0.0,to=21.0)
                                    double zoom)
        카메라의 위도가 latitude, 줌 레벨이 zoom일 때의 축척을 미터/DP 단위로 반환합니다.
        Parameters:
        latitude - 위도.
        zoom - 줌 레벨.
        Returns:
        축척. 미터/DP 단위.

      • getMetersPerDp

        public double getMetersPerDp()
        현재 지도의 축척을 미터/DP 단위로 반환합니다.
        Returns:
        축척. 미터/DP 단위.

      • getMetersPerPixel

        public double getMetersPerPixel()
        현재 지도의 축척을 미터/픽셀 단위로 반환합니다.
        Returns:
        축척. 미터/픽셀 단위.

      • getMetersPerPixel

        public double getMetersPerPixel​(@FloatRange(from=-85.05112877980659,to=85.05112877980659)
                                double latitude,
                                @FloatRange(from=0.0,to=21.0)
                                double zoom)
        카메라의 위도가 latitude, 줌 레벨이 zoom일 때의 축척을 미터/픽셀 단위로 반환합니다.
        Parameters:
        latitude - 위도.
        zoom - 줌 레벨.
        Returns:
        축척. 미터/픽셀 단위.

      • fromScreenLocation

        @NonNull
public LatLng fromScreenLocation​(@Nullable
                                 android.graphics.PointF point)
        화면 좌표를 위경도 좌표로 변환합니다.
        Parameters:
        point - 화면 좌표.
        Returns:
        위경도 좌표. point가 null이거나, 화면 좌표의 범위가 위경도 좌표로 표현할 수 있는 범위를 벗어난 경우 유효하지 않은(LatLng.isValid()가 false인) 좌표가 반환됩니다.

      • fromScreenLocationAt

        @NonNull
public LatLng fromScreenLocationAt​(@Nullable
                                   android.graphics.PointF point,
                                   double zoom,
                                   double tilt,
                                   double bearing,
                                   boolean wrap)
        화면 좌표를 카메라가 지정된 줌 레벨, 틸트/베어링 각도일 때의 위경도 좌표로 변환합니다. 일반적인 상황에는 fromScreenLocation(PointF)를 사용하세요.
        Parameters:
        point - 화면 좌표.
        zoom - 줌 레벨.
        tilt - 틸트 각도.
        bearing - 베어링 각도.
        wrap - 좌표를 랩핑할지 여부.
        Returns:
        위경도 좌표. point가 null이거나, 화면 좌표의 범위가 위경도 좌표로 표현할 수 있는 범위를 벗어난 경우 유효하지 않은(LatLng.isValid()가 false인) 좌표가 반환됩니다.

      • toScreenLocation

        @NonNull
public android.graphics.PointF toScreenLocation​(@Nullable
                                                LatLng coord)
        위경도 좌표를 화면 좌표로 변환합니다.
        Parameters:
        coord - 위경도 좌표.
        Returns:
        화면 좌표. coord가 null이거나, 위경도 좌표의 범위가 화면 좌표로 표현할 수 있는 범위를 벗어난 경우 유효하지 않은(PointF.x 또는 PointF.y가 Float.NaN인) 좌표가 반환됩니다.

      • toScreenLocationAt

        @NonNull
public android.graphics.PointF toScreenLocationAt​(@Nullable
                                                  LatLng coord,
                                                  double zoom,
                                                  double bearing,
                                                  double tilt,
                                                  boolean shortestPath)
        위경도 좌표를 카메라가 지정된 줌 레벨, 틸트/베어링 각도일 때의 화면 좌표로 변환합니다. 일반적인 상황에는 toScreenLocation(LatLng)을 사용하세요.
        Parameters:
        coord - 위경도 좌표.
        zoom - 줌 레벨.
        tilt - 틸트 각도.
        bearing - 베어링 각도.
        shortestPath - 가까운 좌표를 사용할지 여부.
        Returns:
        화면 좌표. coord가 null이거나, 위경도 좌표의 범위가 화면 좌표로 표현할 수 있는 범위를 벗어난 경우 유효하지 않은(PointF.x 또는 PointF.y가 Float.NaN인) 좌표가 반환됩니다.