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
    화면 좌표를 위경도 좌표로 변환합니다.
    fromScreenLocationAt(PointF point, double zoom, double tilt, double bearing, boolean wrap)
    화면 좌표를 카메라가 지정된 줌 레벨, 틸트/베어링 각도일 때의 위경도 좌표로 변환합니다.
    double
    현재 지도의 축척을 미터/DP 단위로 반환합니다.
    static double
    getMetersPerDp(double latitude, double zoom)
    카메라의 위도가 latitude, 줌 레벨이 zoom일 때의 축척을 미터/DP 단위로 반환합니다.
    double
    현재 지도의 축척을 미터/픽셀 단위로 반환합니다.
    double
    getMetersPerPixel(double latitude, double zoom)
    카메라의 위도가 latitude, 줌 레벨이 zoom일 때의 축척을 미터/픽셀 단위로 반환합니다.
    위경도 좌표를 화면 좌표로 변환합니다.
    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 Details

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

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

      @NonNull public 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인) 좌표가 반환됩니다.