Class LatLngBounds

  • All Implemented Interfaces:
    android.os.Parcelable

    public final class LatLngBounds
    extends java.lang.Object
    implements android.os.Parcelable
    남서쪽과 북동쪽 두 위경도 좌표로 이루어진 최소 경계 사각형 영역을 나타내는 클래스.
    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      static class  LatLngBounds.Builder
      여러 위경도 좌표를 모두 포함하는 최소한의 LatLngBounds를 생성하는 빌더 클래스.
      • 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 android.os.Parcelable.Creator<LatLngBounds> CREATOR  
      static LatLngBounds INVALID
      유효하지 않은 영역을 나타내는 상수.
      static LatLngBounds WORLD
      전체 지구 영역을 나타내는 상수.
      • Fields inherited from interface android.os.Parcelable

        CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE
    • Constructor Summary

      Constructors 
      Constructor Description
      LatLngBounds​(LatLng southWest, LatLng northEast)
      남서쪽과 북동쪽 좌표로부터 객체를 생성합니다.
    • Field Detail

      • INVALID

        @NonNull
        public static final LatLngBounds INVALID
        유효하지 않은 영역을 나타내는 상수.
      • WORLD

        @NonNull
        public static final LatLngBounds WORLD
        전체 지구 영역을 나타내는 상수.
      • CREATOR

        public static final android.os.Parcelable.Creator<LatLngBounds> CREATOR
    • Constructor Detail

      • LatLngBounds

        public LatLngBounds​(@NonNull
                            LatLng southWest,
                            @NonNull
                            LatLng northEast)
        남서쪽과 북동쪽 좌표로부터 객체를 생성합니다.
        Parameters:
        southWest - 남서쪽 좌표.
        northEast - 북동쪽 좌표.
    • Method Detail

      • from

        @NonNull
        public static LatLngBounds from​(@NonNull
                                        LatLng... latLngs)
        latLngs의 좌표를 모두 포함하는 최소한의 LatLngBounds 객체를 생성합니다. latLngs에 있는 null이거나 유효하지 않은 좌표는 무시됩니다.
        Parameters:
        latLngs - 포함할 좌표들.
        Returns:
        LatLngBounds 객체.
        Throws:
        java.lang.IllegalArgumentException - latLngs가 비어 있거나 유효한 좌표가 하나도 없을 경우 발생.
      • from

        @NonNull
        public static LatLngBounds from​(@NonNull
                                        java.util.Collection<LatLng> latLngs)
        latLngs의 좌표를 모두 포함하는 최소한의 LatLngBounds 객체를 생성합니다. latLngs에 있는 null이거나 유효하지 않은 좌표는 무시됩니다.
        Parameters:
        latLngs - 포함할 좌표들.
        Returns:
        LatLngBounds 객체.
        Throws:
        java.lang.IllegalArgumentException - latLngs가 비어 있거나 유효한 좌표가 하나도 없을 경우 발생.
      • getSouthWest

        @NonNull
        public LatLng getSouthWest()
        남서쪽 좌표를 반환합니다.
        Returns:
        남서쪽 좌표.
      • getNorthEast

        @NonNull
        public LatLng getNorthEast()
        북동쪽 좌표를 반환합니다.
        Returns:
        북동쪽 좌표.
      • getSouthEast

        @NonNull
        public LatLng getSouthEast()
        남동쪽 좌표를 반환합니다.
        Returns:
        남동쪽 좌표.
      • getNorthWest

        @NonNull
        public LatLng getNorthWest()
        북서쪽 좌표를 반환합니다.
        Returns:
        북서쪽 좌표.
      • getSouthLatitude

        public double getSouthLatitude()
        최남단의 위도를 반환합니다.
        Returns:
        최남단의 위도.
      • getWestLongitude

        public double getWestLongitude()
        최서단의 경도를 반환합니다.
        Returns:
        최서단의 경도.
      • getNorthLatitude

        public double getNorthLatitude()
        최북단의 위도를 반환합니다.
        Returns:
        최북단의 위도.
      • getEastLongitude

        public double getEastLongitude()
        최동단의 위도를 반환합니다.
        Returns:
        최동단의 위도.
      • getVertexes

        @NonNull
        public LatLng[] getVertexes()
        영역의 네 꼭지점을 배열로 반환합니다. 배열의 각 원소는 남서쪽 좌표로부터 시계 방향으로 정렬됩니다.
        Returns:
        꼭지점 배열.
      • toPolygon

        @NonNull
        public LatLng[] toPolygon()
        영역에 해당하는 폴리곤을 반환합니다. 원소의 크기는 5이며, 배열의 각 원소는 남서쪽 좌표로부터 시계 방향으로 정렬되고, 배열의 첫 좌표와 마지막 좌표는 동일합니다.
        Returns:
        폴리곤 배열.
      • isValid

        public boolean isValid()
        영역이 유효한지 여부를 반환합니다. 영역을 구성하는 두 좌표가 모두 유효할 경우 영역도 유효한 것으로 간주됩니다.
        Returns:
        유효한 영역일 경우 true, 그렇지 않을 경우 false.
      • isEmpty

        public boolean isEmpty()
        영역이 비어있는지 여부를 반환합니다. 최남단의 위도가 최북단의 위도보다 크거나 같을 경우, 최서단의 경도가 최동단의 경도보다 크거나 같을 경우, 영역이 유효하지 않을 경우 비어 있는 것으로 간주됩니다.
        Returns:
        영역이 비어있을 경우 true, 그렇지 않을 경우 false.
      • getCenter

        @NonNull
        public LatLng getCenter()
        영역의 중심점 좌표를 반환합니다.
        Returns:
        중심점 좌표.
      • contains

        public boolean contains​(@NonNull
                                LatLng latLng)
        영역이 좌표를 포함하는지 여부를 반환합니다.
        Parameters:
        latLng - 포함되는지 확인할 좌표.
        Returns:
        포함할 경우 true, 그렇지 않을 경우 false.
      • contains

        public boolean contains​(@NonNull
                                LatLngBounds bounds)
        영역이 다른 영역을 포함하는지 여부를 반환합니다.
        Parameters:
        bounds - 포함되는지 확인할 영역.
        Returns:
        포함할 경우 true, 그렇지 않을 경우 false.
      • intersects

        public boolean intersects​(@NonNull
                                  LatLngBounds bounds)
        영역이 다른 영역과 교차하는지 여부를 반환합니다.
        Parameters:
        bounds - 교차하는지 확인할 영역.
        Returns:
        교차할 경우 true, 그렇지 않을 경우 false.
      • intersection

        @CheckResult
        @Nullable
        public LatLngBounds intersection​(@NonNull
                                         LatLngBounds bounds)
        영역과 다른 영역 간의 교차 영역을 반환합니다.
        Parameters:
        bounds - 다른 영역.
        Returns:
        교차 영역. 두 영역이 교차하지 않을 경우 null.
      • expand

        @CheckResult
        @NonNull
        public LatLngBounds expand​(@NonNull
                                   LatLng latLng)
        latLng를 포함하도록 확장한 영역을 반환합니다. 영역이 이미 latLng를 포함하고 있을 경우 새로운 객체가 만들어지지 않고 이 객체가 반환됩니다.
        Parameters:
        latLng - 포함할 좌표.
        Returns:
        좌표가 포함된 영역.
      • buffer

        @CheckResult
        @NonNull
        public LatLngBounds buffer​(double meter)
        동서남북으로 meter미터 확장한 영역을 반환합니다.
        Parameters:
        meter - 확장할 거리. 미터 단위.
        Returns:
        확장된 영역.
      • union

        @CheckResult
        @NonNull
        public LatLngBounds union​(@NonNull
                                  LatLngBounds bounds)
        이 영역과 다른 영역을 모두 포함하는 최소한의 영역을 반환합니다.
        Parameters:
        bounds - 다른 영역.
        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

        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