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​(double latitude,
                                            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​(double latitude,
                                        double zoom)
        카메라의 위도가 latitude, 줌 레벨이 zoom일 때의 축척을 미터/픽셀 단위로 반환합니다.
        Parameters:
        latitude - 위도.
        zoom - 줌 레벨.
        Returns:
        축척. 미터/픽셀 단위.
      • fromScreenLocation

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

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