지리공간 쿼리

샘플 데이터

theaters sample_mflix 이 가이드 의 예제에서는 Atlas 샘플 데이터 세트의 데이터베이스 에 있는 컬렉션 사용합니다. 스칼라 애플리케이션 에서 이 컬렉션 액세스 하려면 Atlas cluster 에 연결하는 MongoClient 를 만들고 database 및 collection 변수에 다음 값을 할당합니다.

val database: MongoDatabase = mongoClient.getDatabase("sample_mflix")
val collection: MongoCollection[Document] = database.getCollection("theaters")

무료 MongoDB Atlas 클러스터 생성하고 샘플 데이터 세트를 로드하는 방법을 학습하려면 MongoDB 시작하기 가이드 를 참조하세요.

GeoJSON 위치

위치는 지구상의 한 장소를 나타내며 두 개 또는 세 개의 숫자 값을 포함하는 배열 로 제공됩니다.

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

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

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

GeoJSON 유형

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

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

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

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

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

MongoDB 에서 사용할 수 있는 모양에 대해 자세히 학습하려면 서버 매뉴얼에서 GeoJSON 을 참조하세요.

Index

2dsphere 인덱스를 생성하려면 Indexes.geo2dsphere() 헬퍼를 사용하여 2dsphere 인덱스에 대한 사양을 생성합니다. 인덱스를 생성하려면 MongoCollection.createIndex() 메서드에 사양을 전달합니다.

다음 예에서는 theaters 컬렉션의 "location.geo" 필드에 2dsphere 인덱스를 생성합니다.

val indexObservable = collection.createIndex(Indexes.geo2dsphere("location.geo"))
Await.result(indexObservable.toFuture(), Duration(10, TimeUnit.SECONDS))

스칼라 운전자 의 인덱스에 대해 자세히 학습 인덱스를 사용하여 쿼리 최적화 가이드 를 참조하세요.

Index

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

val indexObservable = collection.createIndex(Indexes.geo2d("coordinates"))
Await.result(indexObservable.toFuture(), Duration(10, TimeUnit.SECONDS))

스칼라 운전자 의 인덱스에 대해 자세히 학습 인덱스를 사용하여 쿼리 최적화 가이드 를 참조하세요.

레거시 좌표 쌍에 대한 자세한 내용은 서버 매뉴얼에서 지리 공간적 쿼리 가이드의 레거시 좌표 쌍 섹션을 참조하세요.

쿼리 연산자

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

• $near

• $geoWithin

• $nearSphere

• $geoIntersects 2dsphere 인덱스 필요

스칼라 운전자 에서 Filters 객체 의 near(), geoWithin(), nearSphere() 및 geoIntersects() 메서드를 사용하여 이러한 쿼리 연산자를 지정할 수 있습니다.

지리 공간적 쿼리 연산자에 대해 자세히 학습하려면 서버 매뉴얼의 지리 공간적 쿼리 가이드의 지리 공간적 쿼리 연산자 섹션을 참조하세요.

Filters 헬퍼 메서드의 전체 목록을 보려면 필터 API 설명서를 참조하세요.

쿼리 매개변수

지리 공간적 쿼리 에서 사용할 도형을 지정하려면 스칼라 운전자 의 Position, Point, LineString, Polygon 클래스를 사용합니다.

GeoJSON 모양 클래스에 대해 자세히 학습하려면 GeoJSON 패키지 API 설명서를 참조하세요.

근접성 기준 쿼리

점 에서 가장 가까운 것부터 가장 먼 것 순으로 문서를 검색 하고 반환하려면 Filters 객체 의 near() 메서드를 사용합니다. near() 메서드는 $near 쿼리 연산자 사용하여 쿼리 구성합니다.

다음 예시 지정된 GeoJSON Point 인스턴스 에서 최대 1000 미터 떨어진 문서를 가장 가까운 것부터 가장 먼 것 순으로 정렬하여 반환합니다.

val refPoint = new Point(new Position(-73.986805, 40.7620853))
val findObservable = collection.find(Filters.near("location.geo", refPoint, Some(1000.0), Some(0.0)))
val results = Await.result(findObservable.toFuture(), Duration(10, TimeUnit.SECONDS))

{"_id": {"$oid": "59a47287cfa9a3a73e51e8e2"}, "theaterId": 1908, "location":
{"address": {"street1": "750 Seventh Ave", "city": "New York", "state": "NY",
"zipcode": "10019"}, "geo": {"type": "Point", "coordinates": [-73.983487, 40.76078]}}}
{"_id": {"$oid": "59a47286cfa9a3a73e51e838"}, "theaterId": 1448, "location":
{"address": {"street1": "1880 Broadway", "city": "New York", "state": "NY",
"zipcode": "10023"}, "geo": {"type": "Point", "coordinates": [-73.982094, 40.769882]}}}

$near 연산자에 대해 자세히 학습하려면 서버 매뉴얼에서 $near 참조를 참조하세요.

범위 내 쿼리

지정된 도형 내에서 지리 공간적 데이터를 검색 하려면 Filters 객체 의 geoWithin() 메서드를 사용합니다. geoWithin() 메서드는 $geoWithin 쿼리 연산자 사용하여 쿼리 구성합니다.

다음 예시 롱 아일랜드의 한 구역에 있는 영화관을 검색합니다. 이 예시 각 결과에 location.address.city 필드 만 포함하고 _id 필드 제외하도록 프로젝션 적용합니다.

val longIslandTriangle = new Polygon(Arrays.asList(
    new Position(-72.0, 40.0),
    new Position(-74.0, 41.0),
    new Position(-72.0, 39.0),
    new Position(-72.0, 40.0)
))
val projection = Projections.fields(
    Projections.include("location.address.city"),
    Projections.excludeId()
)
val geoWithinComparison = Filters.geoWithin("location.geo", longIslandTriangle)
val findObservable = collection.find(geoWithinComparison).projection(projection)
val results = Await.result(findObservable.toFuture(), Duration(10, TimeUnit.SECONDS))
results.foreach(doc => println(doc.toJson()))

{"location": {"address": {"city": "Baldwin"}}}
{"location": {"address": {"city": "Levittown"}}}
{"location": {"address": {"city": "Westbury"}}}
{"location": {"address": {"city": "Mount Vernon"}}}
{"location": {"address": {"city": "Massapequa"}}}

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

$geoWithin 연산자에 대해 자세히 학습하려면 서버 매뉴얼에서 $geoWithin 참조를 참조하세요.