地理空間で検索する

GeoJSON の位置

位置は地球上の単一の場所を表し、コード内では 2 つまたは 3 つの数値を含む配列として存在します。

• 最初の位置の経度（必須）

• 2 番目の位置の緯度（必須）

• 3 番目の位置での高度（任意）

GeoJSON タイプ

GeoJSON オブジェクトのタイプによって幾何学的形状が決まります。 幾何学的形状は位置で構成されています。

以下に、一般的な GeoJSON の型と、それらを位置で指定する方法を示します。

• Point: 単一の位置。 This could represent the location of a sculpture.

• LineString: 2 つ以上の位置の配列で、一連の線セグメントを形成します。 これは 、中国のすべての国の ルートを表す可能性があります。

• Polygon: 最初と最後の位置が同じであるため、スペースを含む位置の配列。 これは バチカン市国内の土地 を表すことができます

MongoDB で使用できる形状の詳細については、 GeoJSON のマニュアル エントリを参照してください。

Index

GeoJSON 形式で保存されたデータをクエリするには、GeoJSON データを含むフィールドを2dsphereインデックスに追加します。 次のスニペットは、 Indexesビルダを使用してlocation.geoフィールドに2dsphereインデックスを作成します。

// <MongoCollection setup code here>
collection.createIndex(Indexes.geo2dsphere("location.geo"));

Indexesビルダの詳細については、 インデックス ビルダに関するガイドをご覧ください。

Index

legacy coordinate pairs として保存されたデータをクエリするには、legacy coordinate pairs を含むフィールドを2dインデックスに追加する必要があります。 次のスニペットは、 Indexesビルダを使用してcoordinatesフィールドに2dインデックスを作成します。

// <MongoCollection setup code here>
collection.createIndex(Indexes.geo2d("coordinates"));

Indexesビルダの詳細については、 インデックス ビルダに関するガイド をご覧ください。

legacy coordinate pairs の詳細については、 legacy coordinate pairsに関する MongoDB Server のマニュアル ページ を参照してください。

クエリ演算子

地理空間データをクエリするには、次のいずれかのクエリ演算子を使用します。

• $near

• $geoWithin

• $nearSphere

• $geoIntersects 2DSPHERE インデックスが必要です

これらのクエリ演算子は、MongoDB Java ドライバー内でFiltersビルダ クラスのnear() 、 geoWithin() 、 nearSphere() 、およびgeoIntersects()ユーティリティ メソッドを使用して指定できます。

地理空間クエリ演算子の詳細については、地理空間クエリに関するマニュアル エントリを参照してください。

Filtersの詳細については、 フィルター ビルダに関するガイド をご覧ください。

クエリ パラメータ

地理空間クエリで使用する形状を指定するには、MongoDB Java ドライバーのPosition 、 Point 、 LineString 、およびPolygonクラスを使用します。

MongoDB Java ドライバーで使用できる GeoJSON シェイプの完全なリストについては、 GeoJSON パッケージ を参照してください API ドキュメント。

近接性によるクエリ

点に最も近いドキュメントから最も遠いドキュメントの順に検索して返すには、 Filtersビルダ クラスのnear()静的ユーティリティ メソッドを使用します。 near()メソッドは、 $nearクエリ演算子を使用してクエリを構築します。

次の例では、Atlas Triggers から から メートルの間にある映画館をクエリし ます。10,0005,000

// Add your MongoClient setup code here
MongoDatabase database = mongoClient.getDatabase("sample_mflix");
MongoCollection<Document> collection = database.getCollection("theaters");
Point centralPark = new Point(new Position(-73.9667, 40.78));
// Creates a query that matches all locations between 5,000 and 10,000 meters from the specified Point
Bson query = near("location.geo", centralPark, 10000.0, 5000.0);
// Creates a projection to include only the "location.address.city" field in the results
Bson projection = fields(include("location.address.city"), excludeId());
// Prints the projected field of the results from the geospatial query as JSON
collection.find(query)
        .projection(projection)
        .forEach(doc -> System.out.println(doc.toJson()));

コード スニペットの出力は、次のようになります。

{"location": {"address": {"city": "Bronx"}}}
{"location": {"address": {"city": "New York"}}}
{"location": {"address": {"city": "New York"}}}
{"location": {"address": {"city": "Long Island City"}}}
{"location": {"address": {"city": "New York"}}}
{"location": {"address": {"city": "Secaucus"}}}
{"location": {"address": {"city": "Jersey City"}}}
{"location": {"address": {"city": "Elmhurst"}}}
{"location": {"address": {"city": "Flushing"}}}
{"location": {"address": {"city": "Flushing"}}}
{"location": {"address": {"city": "Flushing"}}}
{"location": {"address": {"city": "Elmhurst"}}}

$near演算子の詳細については、 $near の参考ドキュメントを参照してください。

Filtersの詳細については、 フィルター ビルダに関するガイド をご覧ください。

範囲内のクエリ

指定した形状内の地理空間データを検索するには、 Filtersビルダ クラスのgeoWithin()静的ユーティリティ メソッドを使用します。 geoWithin()メソッドは、 $geoWithinクエリ演算子を使用してクエリを構築します。

次の例では、Long Expression の セクションで映画館を検索します。

// Add your MongoCollection setup code here
// Creates a set of points that defines the bounds of a geospatial shape
Polygon longIslandTriangle = new Polygon(Arrays.asList(new Position(-72, 40),
        new Position(-74, 41),
        new Position(-72, 39),
        new Position(-72, 40)));
// Creates a projection to include only the "location.address.city" field in the results
Bson projection = fields(include("location.address.city"), excludeId());
// Creates a query that matches documents containing "location.geo" values within the specified bounds
Bson geoWithinComparison = geoWithin("location.geo", longIslandTriangle);
// Prints the projected field of the results from the geolocation query as JSON
collection.find(geoWithinComparison)
        .projection(projection)
        .forEach(doc -> System.out.println(doc.toJson()));

コード スニペットの出力は、次のようになります。

{"location": {"address": {"city": "Baldwin"}}}
{"location": {"address": {"city": "Levittown"}}}
{"location": {"address": {"city": "Westbury"}}}
{"location": {"address": {"city": "Mount Vernon"}}}
{"location": {"address": {"city": "Massapequa"}}}

次の図は、 longIslandTriangle変数によって定義される多角形と、クエリによって返された映画館の場所を表すドットを示しています。

$geoWithin演算子の詳細については、 $geoWithin の参考ドキュメントを参照してください

クエリで使用できる演算子の詳細については、 MongoDB Server マニュアルの「 地理空間クエリ演算子 」のページを参照してください。