$nearSphere

定義

$nearSphere

地理空間クエリの基準となる地点を指定します。この地点をもとに、指定した地点から最も近いドキュメントから最も遠いドキュメントの順に地理空間クエリによりドキュメントが返されます。 MongoDB は球面ジオメトリを使用して $nearSphereの距離を計算します。

$nearSphere には地理空間インデックスが必要です。

• GeoJSON ポイントとして定義されたロケーション データの2dsphereインデックス

• legacy coordinate pairs として定義されたロケーション データの2dインデックス GeoJSON ポイントで2dインデックスを使用するには、GeoJSON オブジェクトのcoordinatesフィールドにインデックスを作成します。

$nearSphere演算子は、 GeoJSONポイントまたはレガシー座標ポイントのいずれかを指定できます。

GeoJSONポイントを指定するには、次の構文を使用します。

{
  $nearSphere: {
     $geometry: {
        type : "Point",
        coordinates : [ <longitude>, <latitude> ]
     },
     $minDistance: <distance in meters>,
     $maxDistance: <distance in meters>
  }
}

• 任意の$minDistanceを使用すると、中心点から指定された 以上 の距離にあるドキュメントに結果が制限されます。

• 任意の$maxDistanceはどちらのインデックスでも使用できます。

レガシー座標を使用して点を指定するには、次の構文を使用します。

{
  $nearSphere: [ <x>, <y> ],
  $minDistance: <distance in radians>,
  $maxDistance: <distance in radians>
}

• オプションの$minDistanceは、クエリが2dsphereインデックスを使用する場合にのみ使用できます。 $minDistanceでは、中心点から指定された 以上 の距離にあるドキュメントに結果が制限されます。

• 任意の$maxDistanceはどちらのインデックスでも使用できます。

レガシー座標に経度と緯度を使用する場合は、最初に経度、次に緯度を指定します。

動作

例

db.places.find(
   {
     location: {
        $nearSphere: {
           $geometry: {
              type : "Point",
              coordinates : [ -73.9667, 40.78 ]
           },
           $minDistance: 1000,
           $maxDistance: 5000
        }
     }
   }
)

db.legacyPlaces.find(
   { location : { $nearSphere : [ -73.9667, 40.78 ], $maxDistance: 0.10 } }
)

db.legacyPlaces.find(
   { location : { $nearSphere : [ -73.9667, 40.78 ], $minDistance: 0.0004 } }
)