지리공간 쿼리

GeoJSON 객체

지구와 같은 구의 기하학적 모양을 계산하려면 위치 데이터를 GeoJSON 객체로 저장합니다.

GeoJSON 데이터를 지정하려면 내장된 문서를 사용하세요.

• GeoJSON 객체 유형을 지정하는 type 이라는 필드 및

• 객체의 좌표를 지정하는 coordinates라는 필드입니다.

<field>: { type: <GeoJSON type> , coordinates: <coordinates> }

예를 들어 GeoJSON 포인트를 지정하려면 다음을 수행합니다.

location: {
      type: "Point",
      coordinates: [-73.856077, 40.848447]
}

MongoDB에서 지원되는 GeoJSON 객체 목록과 예시는 GeoJSON 객체를 참조하세요.

GeoJSON 객체에 대한 MongoDB 지리 공간적 쿼리는 구체에서 계산되며, MongoDB는 GeoJSON 객체에 대한 지리 공간적 쿼리에 WGS84 참고 시스템을 사용합니다.

레거시 좌표 쌍

유클리드 평면에서 거리를 계산하려면 위치 데이터를 legacy coordinate pairs로 저장하고 2d 인덱스를 사용하세요. 데이터를 GeoJSON 포인트 유형으로 수동 변환하는 경우에는 MongoDB가 2dsphere 인덱스를 사용하여 legacy coordinate pairs에 대한 구면 계산을 지원합니다.

데이터를 레거시 좌표 쌍으로 지정하려면 배열(선호되는 방법) 또는 내장된 문서를 사용할 수 있습니다.

배열을 통해 지정합니다(기본 설정):

<field>: [ <x>, <y> ]

위도 및 경도 좌표를 지정하는 경우 경도를 먼저 나열한 다음 위도를 나열합니다.

<field>: [<longitude>, <latitude> ]

• 유효한 경도 값은 -180~180입니다(둘 모두 포함).

• 유효한 위도 값은 -90~90입니다(둘 모두 포함).

내장된 문서를 통해 지정합니다.

<field>: { <field1>: <x>, <field2>: <y> }

위도 및 경도 좌표를 지정하는 경우 필드 이름에 관계없이 첫 번째 필드에는 경도 값이 포함되고 두 번째 필드에는 위도 값이 포함되어야 합니다. 즉,

<field>: { <field1>: <longitude>, <field2>: <latitude> }

• 유효한 경도 값은 -180~180입니다(둘 모두 포함).

• 유효한 위도 값은 -90~90입니다(둘 모두 포함).

일부 언어에서는 연관 맵 순서가 보장되지 않으므로 레거시 좌표 쌍을 지정하려면 내장된 문서보다 배열을 사용하는 것이 좋습니다.

2dsphere

2dsphere 인덱스는 지구와 유사한 구의 기하학을 계산하는 쿼리를 지원합니다.

2dsphere 인덱스를 만들려면 db.collection.createIndex() 메서드를 사용하고 문자열 리터럴 "2dsphere"를 인덱스 형식으로 지정합니다.

db.collection.createIndex( { <location field> : "2dsphere" } )

여기서 <location field>는 값이 GeoJSON 객체 또는 레거시 좌표 쌍인 필드입니다.

2dsphere 인덱스에 대한 자세한 내용은 2dsphere 인덱스를 참조하세요.

2d

2D 인덱스는 2차원 평면에서 도형을 계산하는 쿼리를 지원합니다. 인덱스는 구체에서 계산하는 $nearSphere 쿼리를 지원할 수 있지만, 가능하면 구체 쿼리에는 2dsphere 인덱스를 사용하는 것이 좋습니다.

2d 인덱스를 생성하려면, db.collection.createIndex() 메서드를 사용하여 위치 필드를 키로 지정하고 "2d" 문자열 리터럴을 다음과 같이 인덱스 유형으로 지정합니다.

db.collection.createIndex( { <location field> : "2d" } )

여기서 <location field>는 값이 레거시 좌표 쌍인 필드입니다.

2d 인덱스에 대한 자세한 내용은 2d 인덱스를 참조하세요.

지리 공간적 인덱스 및 샤드 collection

collection을 샤딩할 때는 지리 공간적 인덱스를 샤드 키로 사용할 수 없습니다. 그러나 다른 필드를 샤드 키로 사용하여 샤드 collection에 지리 공간적 인덱스를 생성할 수 있습니다.

샤드 collection에서 지원되는 지리 공간적 작업은 다음과 같습니다.

• $geoNear 집계 단계

• $near 및 $nearSphere 쿼리 연산자

$geoWithin 및 $geoIntersects 를 사용하여 샤드 cluster의 지리 공간적 데이터를 쿼리할 수도 있습니다.

지원되는 쿼리

지리 공간적 인덱스 는 쿼리를 포함할 수 없습니다.

지리공간 쿼리 연산자

MongoDB는 다음과 같은 지리공간 쿼리 연산자를 제공합니다:

예시를 포함한 자세한 내용은 참조 페이지를 참조하세요.

지리 공간적 집계 단계

MongoDB에서 제공하는 다음 지리적 공간 집계 파이프라인 단계:

예시를 포함한 자세한 내용은 $geoNear 참고 페이지를 참조하세요.