Package com.naver.maps.map

Class Projection

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

  • Method Summary

    Modifier and Type
    Method
    Description
    com.naver.maps.geometry.LatLng
    fromScreenLocation(android.graphics.PointF point)
    화면 좌표를 위경도 좌표로 변환합니다.
    com.naver.maps.geometry.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(com.naver.maps.geometry.LatLng coord)
    위경도 좌표를 화면 좌표로 변환합니다.
    android.graphics.PointF
    toScreenLocationAt(com.naver.maps.geometry.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 Details

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

    • fromScreenLocationAt

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

    • toScreenLocationAt

      @NonNull public android.graphics.PointF toScreenLocationAt(@Nullable com.naver.maps.geometry.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인) 좌표가 반환됩니다.