Class LatLngBounds

java.lang.Object
com.naver.maps.geometry.LatLngBounds
All Implemented Interfaces:
Parcelable

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

  • Constructor Details

    • LatLngBounds

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

    • from

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

      @NonNull public static LatLngBounds from(@NonNull Collection<LatLng> latLngs)
      latLngs의 좌표를 모두 포함하는 최소한의 LatLngBounds 객체를 생성합니다. latLngs에 있는 null이거나 유효하지 않은 좌표는 무시됩니다.
      Parameters:
      latLngs - 포함할 좌표들.
      Returns:
      LatLngBounds 객체.
      Throws:
      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

      영역과 다른 영역 간의 교차 영역을 반환합니다.
      Parameters:
      bounds - 다른 영역.
      Returns:
      교차 영역. 두 영역이 교차하지 않을 경우 null.
    • expand

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

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

      이 영역과 다른 영역을 모두 포함하는 최소한의 영역을 반환합니다.
      Parameters:
      bounds - 다른 영역.
      Returns:
      두 영역을 모두 포함하는 영역.
    • equals

      public boolean equals(Object o)
      Overrides:
      equals in class Object
    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object
    • toString

      public String toString()
      Overrides:
      toString in class Object
    • describeContents

      public int describeContents()
      Specified by:
      describeContents in interface Parcelable
    • writeToParcel

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