Package com.naver.maps.geometry

Class WebMercatorCoord

  • All Implemented Interfaces:
    android.os.Parcelable, Coord
    public final class WebMercatorCoord
extends java.lang.Object
implements Coord, android.os.Parcelable
    웹 메르카토르 좌표를 나타내는 클래스.

    • Nested Class Summary

      • Nested classes/interfaces inherited from interface android.os.Parcelable

        android.os.Parcelable.ClassLoaderCreator<T extends java.lang.Object>, android.os.Parcelable.Creator<T extends java.lang.Object>

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static LatLngBounds COVERAGE
      웹 메르카토르 좌표로 나타낼 수 있는 커버리지 영역.
      static android.os.Parcelable.Creator<WebMercatorCoord> CREATOR  
      static double MAXIMUM_LATITUDE
      웹 메르카토르 좌표로 나타낼 수 있는 최대 위도.
      static double MAXIMUM_XY
      커버리지 내 x 및 y의 최댓값.
      static double MINIMUM_LATITUDE
      웹 메르카토르 좌표로 나타낼 수 있는 최소 위도.
      static double MINIMUM_XY
      커버리지 내 x 및 y의 최솟값.
      double x
      x 좌표.
      double y
      y 좌표.

      • Fields inherited from interface android.os.Parcelable

        CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE

    • Constructor Summary

      Constructors 
      Constructor Description
      WebMercatorCoord​(double x, double y)
      지정한 위치에 대한 좌표를 생성합니다.

    • Field Detail

      • MINIMUM_XY

        public static final double MINIMUM_XY
        커버리지 내 x 및 y의 최솟값.
        See Also:
        Constant Field Values

      • MAXIMUM_XY

        public static final double MAXIMUM_XY
        커버리지 내 x 및 y의 최댓값.
        See Also:
        Constant Field Values

      • MINIMUM_LATITUDE

        public static final double MINIMUM_LATITUDE
        웹 메르카토르 좌표로 나타낼 수 있는 최소 위도.
        See Also:
        Constant Field Values

      • MAXIMUM_LATITUDE

        public static final double MAXIMUM_LATITUDE
        웹 메르카토르 좌표로 나타낼 수 있는 최대 위도.
        See Also:
        Constant Field Values

      • COVERAGE

        @NonNull
public static final LatLngBounds COVERAGE
        웹 메르카토르 좌표로 나타낼 수 있는 커버리지 영역.

      • x

        public final double x
        x 좌표.

      • y

        public final double y
        y 좌표.

      • CREATOR

        public static final android.os.Parcelable.Creator<WebMercatorCoord> CREATOR

    • Constructor Detail

      • WebMercatorCoord

        public WebMercatorCoord​(double x,
                        double y)
        지정한 위치에 대한 좌표를 생성합니다.
        Parameters:
        x - x 좌표.
        y - y 좌표.

    • Method Detail

      • valueOf

        @NonNull
public static WebMercatorCoord valueOf​(@NonNull
                                       LatLng latLng)
        위경도 좌표를 웹 메르카토르 좌표로 변환하는 팩토리 메서드.
        Parameters:
        latLng - 위경도 좌표.
        Returns:
        웹 메르카토르 좌표.

      • isValid

        public boolean isValid()
        좌표가 유효한지 여부를 반환합니다.
        Specified by:
        isValid in interface Coord
        Returns:
        유효할 경우 true, 그렇지 않을 경우 false.

      • isWithinCoverage

        public boolean isWithinCoverage()
        좌표가 좌표계의 커버리지 내에 포함되는지 여부를 반환합니다. 커버리지를 벗어날 경우 좌표 연산의 정확도가 보장되지 않습니다.
        Specified by:
        isWithinCoverage in interface Coord
        Returns:
        커버리지 내일 경우 true, 그렇지 않을 경우 false.

      • distanceTo

        public double distanceTo​(@NonNull
                         WebMercatorCoord other)
        다른 좌표와의 거리를 반환합니다. WebMercatorCoord 좌표는 메르카토르 도법을 사용하므로 오차가 클 수 있습니다. 지리적으로 보다 정밀한 값이 필요한 경우 LatLng.distanceTo(LatLng)를 사용하십시오.
        Parameters:
        other - 다른 좌표.
        Returns:
        거리. 미터 단위.
        See Also:
        LatLng.distanceTo(LatLng)

      • bearingTo

        public double bearingTo​(@NonNull
                        WebMercatorCoord other)
        다른 좌표와의 각도를 반환합니다. 다른 좌표가 현재 좌표의 정북 방향에 있을 경우 0도이며, 시계 방향으로 각도가 증가합니다.
        Parameters:
        other - 다른 좌표.
        Returns:
        각도. 도 단위.

      • toLatLng

        @NonNull
public LatLng toLatLng()
        좌표를 위경도 좌표로 변환합니다.
        Specified by:
        toLatLng in interface Coord
        Returns:
        변환된 위경도 좌표.

      • equals

        public boolean equals​(java.lang.Object o)
        Overrides:
        equals in class java.lang.Object

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class java.lang.Object

      • toString

        @NonNull
public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object

      • describeContents

        public int describeContents()
        Specified by:
        describeContents in interface android.os.Parcelable

      • writeToParcel

        public void writeToParcel​(android.os.Parcel dest,
                          int flags)
        Specified by:
        writeToParcel in interface android.os.Parcelable