Package com.naver.maps.geometry
Class LatLngBounds
- java.lang.Object
-
- com.naver.maps.geometry.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
를 생성하는 빌더 클래스.
-
Field Summary
Fields Modifier and Type Field Description static android.os.Parcelable.Creator<LatLngBounds>
CREATOR
static LatLngBounds
INVALID
유효하지 않은 영역을 나타내는 상수.static LatLngBounds
WORLD
전체 지구 영역을 나타내는 상수.
-
Constructor Summary
Constructors Constructor Description LatLngBounds(LatLng southWest, LatLng northEast)
남서쪽과 북동쪽 좌표로부터 객체를 생성합니다.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description LatLngBounds
buffer(double meter)
동서남북으로meter
미터 확장한 영역을 반환합니다.boolean
contains(LatLng latLng)
영역이 좌표를 포함하는지 여부를 반환합니다.boolean
contains(LatLngBounds bounds)
영역이 다른 영역을 포함하는지 여부를 반환합니다.int
describeContents()
boolean
equals(java.lang.Object o)
LatLngBounds
expand(LatLng latLng)
latLng
를 포함하도록 확장한 영역을 반환합니다.static LatLngBounds
from(LatLng... latLngs)
latLngs
의 좌표를 모두 포함하는 최소한의LatLngBounds
객체를 생성합니다.static LatLngBounds
from(java.util.Collection<LatLng> latLngs)
latLngs
의 좌표를 모두 포함하는 최소한의LatLngBounds
객체를 생성합니다.LatLng
getCenter()
영역의 중심점 좌표를 반환합니다.double
getEastLongitude()
최동단의 위도를 반환합니다.LatLng
getNorthEast()
북동쪽 좌표를 반환합니다.double
getNorthLatitude()
최북단의 위도를 반환합니다.LatLng
getNorthWest()
북서쪽 좌표를 반환합니다.LatLng
getSouthEast()
남동쪽 좌표를 반환합니다.double
getSouthLatitude()
최남단의 위도를 반환합니다.LatLng
getSouthWest()
남서쪽 좌표를 반환합니다.LatLng[]
getVertexes()
영역의 네 꼭지점을 배열로 반환합니다.double
getWestLongitude()
최서단의 경도를 반환합니다.int
hashCode()
LatLngBounds
intersection(LatLngBounds bounds)
영역과 다른 영역 간의 교차 영역을 반환합니다.boolean
intersects(LatLngBounds bounds)
영역이 다른 영역과 교차하는지 여부를 반환합니다.boolean
isEmpty()
영역이 비어있는지 여부를 반환합니다.boolean
isValid()
영역이 유효한지 여부를 반환합니다.LatLng[]
toPolygon()
영역에 해당하는 폴리곤을 반환합니다.java.lang.String
toString()
LatLngBounds
union(LatLngBounds bounds)
이 영역과 다른 영역을 모두 포함하는 최소한의 영역을 반환합니다.void
writeToParcel(android.os.Parcel dest, int flags)
-
-
-
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
-
-
Method Detail
-
from
@NonNull public static LatLngBounds from(@NonNull LatLng... latLngs)
- Parameters:
latLngs
- 포함할 좌표들.- Returns:
LatLngBounds
객체.- Throws:
java.lang.IllegalArgumentException
-latLngs
가 비어 있거나 유효한 좌표가 하나도 없을 경우 발생.
-
from
@NonNull public static LatLngBounds from(@NonNull java.util.Collection<LatLng> latLngs)
- 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 classjava.lang.Object
-
hashCode
public int hashCode()
- Overrides:
hashCode
in classjava.lang.Object
-
toString
public java.lang.String toString()
- Overrides:
toString
in classjava.lang.Object
-
describeContents
public int describeContents()
- Specified by:
describeContents
in interfaceandroid.os.Parcelable
-
writeToParcel
public void writeToParcel(android.os.Parcel dest, int flags)
- Specified by:
writeToParcel
in interfaceandroid.os.Parcelable
-
-