$centerSphere（クエリ述語演算子）

定義

$centerSphere

球状ジオメトリを使用する地理空間クエリの円を定義します。クエリは、円の境界内にあるドキュメントを返します。$centerSphere 演算子は GeoJSON オブジェクトとレガシー coordinate pairs の両方で使用できます。

$centerSphereを使用するには、以下を含む配列を指定します。

• 円の中心点のグリッド座標、および

• ラジアンで測定された円の半径。 ラジアンを計算するには、「球面演算子の距離をラジアンに変換する 」を参照してください。

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

重要

経度と緯度を使用する場合は、最初に経度を指定します。

動作

$centerSphereアプリケーションは、 地理空間インデックスなしで を使用できます。ただし、地理空間インデックスでは、インデックスがない場合よりもはるかに高速なクエリをサポートします。

2dsphere と2 d 地理空間インデックスはどちらも$centerSphere をサポートしています。

例

次の例では、グリッド座標をクエリし、経度88 Wと緯度30 Nの 10 マイル以内にあるすべてのドキュメントを返します。 クエリでは、地球のおおよその等価半径（3963.2 マイル）で割った値をラジアンに変換します。

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