{
  "$search": {
     "index": <index name>, // optional, defaults to "default"
     "geoWithin": {
        "path": "<field-to-search>",
        "box | circle | geometry": <object>,
        "score": <score-options>
     }
  }
}

オプション

geoWithin では、次の用語を使用してクエリを作成します。

フィールド	タイプ	説明	必要性
`box`	オブジェクト	検索するボックスの左下と右上のGeoJSONポイントを指定するオブジェクト。オブジェクトは次のフィールドを取ります。 `bottomLeft` - 左下にある GeoJSONポイント。 `topRight` - 右上の GeoJSONポイント。 GeoJSON オブジェクト内で GeoJSON データを指定する方法については、「 GeoJSON オブジェクト」を参照してください。 `box` 、 `circle` 、または`geometry`のいずれかが必要です。	条件付き
`circle`	オブジェクト	検索する中心点と半径をメートル単位で指定するオブジェクト。オブジェクトには、次のGeoJSONフィールドが含まれています。 `center` - GeoJSONポイントとして指定された円の中心。 `radius` - 半径（メートル単位で指定される数値）。値は`0`以上である必要があります。 GeoJSON オブジェクト内で GeoJSON データを指定する方法については、「 GeoJSON オブジェクト」を参照してください。 `circle` 、 `box` 、または`geometry`のいずれかが必要です。	条件付き
`geometry`	GeoJSON オブジェクト	検索対象の Multi ポリゴンまたは多角形を指定する GeoJSON オブジェクト。多角形は最後の位置が最初の位置と同じである閉じたループとして指定する必要があります。地理空間結果を計算する場合、 MongoDB Search の geoShape 演算子と geoWithin 演算子、および MongoDB の $geoIntersects 演算子は異なるジオメトリを使用します。この違いは、MongoDB Search とMongoDB が多角形のエッジを描画する方法で確認できます。 MongoDB Search は、座標参照システム内の 2 点間の最短線である直列距離に基づいて多角形を描画します。 MongoDB は、ジオメトリタイプのサードパーティライブラリ上に構築された2 dsphere インデックス、または平面モードに基づきジオデックスモードを使用して多角形を読み込み、2 d インデックスから収集します。詳細については、「GeoJSON オブジェクト」を参照してください。 MongoDB Search とMongoDBでは、多角形に関係する地理空間クエリで異なる結果が返される可能性がありました。 GeoJSON オブジェクト内で GeoJSON データを指定する方法については、「 GeoJSON オブジェクト」を参照してください。 `geometry` 、 `box` 、または`circle`のいずれかが必要です。	条件付き
`path`	文字列または複数の文字列の配列	検索するインデックス付き geo 型フィールド。	はい
`score`	オブジェクト	一致する検索結果に割り当てるスコア。デフォルトでは、結果のスコアは`1`です。次のオプションを使用してスコアを変更できます。 `boost`: 結果のスコアに指定された数値を掛けます。 `constant`: 結果のスコアを指定された数値に置き換えます。 `function`: 結果のスコアを指定された式で置き換えます。クエリで `score` を使用する方法については、「結果内のドキュメントのスコアリング」を参照してください。	no

例

次の例では、sample_airbnb データベースの listingsAndReviews コレクションを使用します。クラスター上にサンプルデータセットがある場合、geo 型のカスタム MongoDB Search インデックスを作成し、クラスター上でサンプルクエリを実行できます。

次のサンプルインデックス定義を使用して、 listingsAndReviewsコレクションのaddress.locationフィールドにインデックスを作成します。

1 {
2   "mappings": {
3     "fields": {
4       "address": {
5         "fields": {
6           "location": {
7             "type": "geo"
8           }
9         },
10         "type": "document"
11       },
12       "property_type": {
13         "type": "token"
14       }
15     }
16   }
17 }

インターフェース

`box` 例

次のクエリでは、 geoWithin演算子とboxフィールドを使用して、オーストラリアの境界ボックス内のプロパティを検索します。

クエリには以下が含まれます。

$limitステージを使用して、出力を3の結果に制限します。
$projectステージでは、 nameとaddressを除くすべてのフィールドが除外されます。

注意

MongoDB Search クエリに default という名前のインデックスを指定する必要はありません。インデックスに他の名前がある場合は、indexフィールドを指定する必要があります。

基本的な例

メタデータの例

`circle` 例

次のクエリでは、 geoWithin演算子とcircleフィールドを使用して、カナダ内の指定された座標の半径 1 マイル以内のプロパティを検索します。

クエリには以下が含まれます。

$limitステージを使用して、出力を3の結果に制限します。
$projectステージを使用して、nameおよびaddressを除くすべてのフィールドを除外します。Compassの例については、必要な手順のリファレンスを参照してください。

注意

`geometry` 例

次の例では、 geoWithin演算子とgeometryフィールドを使用して、クラウドのプロパティを検索しています。 typeフィールドは、領域が GeoJSON 多角形であるか、マルチポリゴンであるかを指定します。

注意

戻る

geoShape

hasAncestor

1	{
2	"mappings": {
3	"fields": {
4	"address": {
5	"fields": {
6	"location": {
7	"type": "geo"
8	}
9	},
10	"type": "document"
11	},
12	"property_type": {
13	"type": "token"
14	}
15	}
16	}
17	}

geoWithin 演算子

定義

構文

オプション

例

box 例

基本的な例

メタデータの例

circle 例

geometry 例

`geoWithin` 演算子

`box` 例

`circle` 例

`geometry` 例