$centerSphere

정의

$centerSphere

구형 기하학을 사용하는지리 공간적 쿼리 에 대한 원을 정의합니다. 쿼리 원의 경계 내에 있는 문서를 반환합니다. $centerSphere GeoJSON 객체와 레거시 좌표 쌍 모두에서 연산자 사용할 수 있습니다.

$centerSphere 을 사용하려면 다음을 포함하는 배열을 지정합니다.

• 원의 중심점의 그리드 좌표,

• 라디안 단위로 측정한 원의 반지름입니다. 라디안을 계산하려면 구형 기하학을 사용하여 거리 계산을 참조하세요.

{
   <location field>: {
      $geoWithin: { $centerSphere: [ [ <x>, <y> ], <radius> ] }
   }
}

중요

경도와 위도를 사용하는 경우 경도를 먼저 지정합니다.

행동

애플리케이션은 지리 공간적 인덱스 없이 $centerSphere를 사용할 수 있습니다. 하지만 지리 공간적 인덱스는 인덱싱되지 않은 경우보다 훨씬 빠른 쿼리를 지원합니다.

2dsphere 및 2d 지리 공간적 인덱스는 모두 $centerSphere 를 지원합니다.

예시

다음 예에서는 그리드 좌표를 쿼리하고 경도 88 W 및 위도 30 N 반경 10마일 내의 모든 문서를 반환합니다. 쿼리는 지구의 대략적인 적도 반경인 3963.2마일을 나누어 거리를 라디안으로 변환합니다.

db.places.find( {
  loc: { $geoWithin: { $centerSphere: [ [ -88, 30 ], 10/3963.2 ] } }
} )