지리공간적 검색

GeoJSON 위치

위치는 지구상의 단일 장소를 나타내며 코드에 두세 개의 숫자 값을 포함하는 배열로 존재합니다.

• 첫 번째 위치의 경도(필수)

• 두 번째 위치의 위도(필수)

• 세 번째 위치의 고도(선택 사항)

GeoJSON 유형

GeoJSON 객체의 유형에 따라 기하학적 모양이 결정됩니다. 기하학적 도형은 위치로 구성됩니다.

다음은 몇 가지 일반적인 GeoJSON 유형과 이를 위치로 지정하는 방법입니다:

• Point: 단일 위치. 이는 조각상의 위치를 나타낼 수 있습니다.

• LineString: 두 개 이상의 위치로 구성된 배열로, 일련의 라인 세그먼트를 형성합니다. 이는 만리장성의 경로를 나타낼 수 있습니다.

• Polygon: 첫 번째 위치와 마지막 위치가 동일하여 일부 공간을 둘러싸는 위치 배열입니다. 이는 바티칸 시국 내의 땅을나타낼 수 있습니다.

MongoDB에서 사용할 수 있는 모양에 대해 자세히 알아보려면 GeoJSON 수동 항목을 참조하세요.

Index

GeoJSON 형식으로 저장된 데이터를 쿼리하려면 GeoJSON 데이터가 포함된 필드를 2dsphere 인덱스에 추가합니다. 다음 스니펫은 Indexes 빌더를 사용하여 location.geo 필드에 2dsphere 인덱스를 생성합니다.

collection.createIndex((Indexes.geo2dsphere("location.geo")))

Indexes 빌더에 대한 자세한 내용은 인덱스 빌더에 가이드 가이드를 참조하세요.

Index

레거시 좌표 쌍으로 저장된 데이터를 쿼리하려면 레거시 좌표 쌍이 포함된 필드를 2d 인덱스에 추가해야 합니다. 다음 스니펫은 Indexes 빌더를 사용하여 coordinates 필드에 2d 인덱스를 생성합니다.

collection.createIndex((Indexes.geo2d("coordinates")))

Indexes 빌더에 대한 자세한 내용 은 인덱스 빌더 가이드를 참조하세요.

레거시 좌표 쌍에 대한 자세한 내용은 레거시 좌표 쌍에 대한 MongoDB 서버 매뉴얼 페이지를 참조하세요.

쿼리 연산자

지리 공간적 데이터를 쿼리하려면 다음 쿼리 연산자 중 하나를 사용합니다:

• $near

• $geoWithin

• $nearSphere

• $geoIntersects 2dsphere 인덱스 필요

Filters 빌더 클래스의 near(), geoWithin(), nearSphere() 및 geoIntersects() 유틸리티 메서드를 사용하여 MongoDB Kotlin 드라이버에서 이러한 쿼리 연산자를 지정할 수 있습니다.

지리 공간적 쿼리 연산자에 대한 자세한 내용은 지리 공간적 쿼리 수동 항목을 참조하세요.

Filters 에 대한 자세한 내용 은 필터 빌더 가이드를 참조하세요.

쿼리 매개변수

지리 공간적 쿼리에 사용할 형태를 지정하려면 MongoDB 코틀린(Kotlin) 드라이버의 Position, Point, LineString 및 Polygon 클래스를 사용합니다.

MongoDB 코틀린(Kotlin) 드라이버에서 사용할 수 있는 GeoJSON 모양의 전체 목록은 GeoJSON 패키지 를 참조하세요. API 문서.

근접성 기준 쿼리

점에서 가장 가까운 것부터 가장 먼 것 순으로 문서를 검색하고 반환하려면 Filters 빌더 클래스의 near() 정적 유틸리티 메서드를 사용합니다. near() 메서드는 $near 쿼리 연산자를 사용하여 쿼리를 구성합니다.

다음 예시에서는 Centralpark의 그레이트 론에서 10,000 ~ 5,000 미터 사이의 극장을 쿼리합니다.

val database = client.getDatabase("sample_mflix")
val collection = database.getCollection<TheaterResults>("theaters")
val centralPark = Point(Position(-73.9667, 40.78))
val query = Filters.near(
    "${Theater::location.name}.${Theater.Location::geo.name}", centralPark, 10000.0, 5000.0
)
val projection = Projections.fields(
    Projections.include(
        "${Theater::location.name}.${Theater.Location::address.name}.${Theater.Location.Address::city.name}"),
    Projections.excludeId()
)
val resultsFlow = collection.find(query).projection(projection)
resultsFlow.collect { println(it) }

TheaterResults(location=Location(address=Address(city=Bronx)))
TheaterResults(location=Location(address=Address(city=New York)))
TheaterResults(location=Location(address=Address(city=New York)))
TheaterResults(location=Location(address=Address(city=Long Island City)))
TheaterResults(location=Location(address=Address(city=New York)))
TheaterResults(location=Location(address=Address(city=Secaucus)))
TheaterResults(location=Location(address=Address(city=Jersey City)))
TheaterResults(location=Location(address=Address(city=Elmhurst)))
TheaterResults(location=Location(address=Address(city=Flushing)))
TheaterResults(location=Location(address=Address(city=Flushing)))
TheaterResults(location=Location(address=Address(city=Flushing)))
TheaterResults(location=Location(address=Address(city=Elmhurst)))

$near 연산자에 대한 자세한 내용 은 $near에 대한 참고 문서를 참조하세요.

Filters 에 대한 자세한 내용 은 필터 빌더 가이드를 참조하세요.

범위 내 쿼리

지정된 모양 내에서 지리 공간적 데이터를 검색하려면 Filters 빌더 클래스의 geoWithin() 정적 유틸리티 메서드를 사용합니다. geoWithin() 메서드는 $geoWithin 쿼리 연산자를 사용하여 쿼리를 구성합니다.

다음 예에서는 롱 아일랜드의 한 구역에 있는 영화관을 검색합니다.

val longIslandTriangle = Polygon(
    listOf(
        Position(-72.0, 40.0),
        Position(-74.0, 41.0),
        Position(-72.0, 39.0),
        Position(-72.0, 40.0)
    )
)
val projection = Projections.fields(
    Projections.include(
        "${Theater::location.name}.${Theater.Location::address.name}.${Theater.Location.Address::city.name}"),
    Projections.excludeId()
)
val geoWithinComparison = Filters.geoWithin(
    "${Theater::location.name}.${Theater.Location::geo.name}", longIslandTriangle
)
val resultsFlow = collection.find<TheaterResults>(geoWithinComparison)
    .projection(projection)
resultsFlow.collect { println(it) }

TheaterResults(location=Location(address=Address(city=Baldwin))))
TheaterResults(location=Location(address=Address(city=Levittown)))
TheaterResults(location=Location(address=Address(city=Westbury)))
TheaterResults(location=Location(address=Address(city=Mount Vernon)))
TheaterResults(location=Location(address=Address(city=Massapequa)))

다음 그림은 longIslandTriangle 변수로 정의된 다각형과 쿼리에서 반환된 영화관 위치를 나타내는 점을 보여줍니다.

$geoWithin 연산자에 대한 자세한 내용 은 $geoWithin에 대한 참고 문서를 참조하세요 .

쿼리 에 사용할 수 있는 연산자에 대한 자세한 내용 은 지리 공간적 쿼리 연산자에 대한 MongoDB 서버 매뉴얼 페이지를참조하세요.