モデル地理空間データ

Overview

このガイドでは、Diango MongoDBバックエンドを使用して地理空間データを保存する方法を学習できます。Dlango MongoDBバックフレームワークは、Dください。

重要

GeoDiango の制限

Dlango MongoDBバックエンドの GeoDiango サポートにはいくつかの制限があります。制限のリストを表示するには、 Dpango とMongoDB機能の互換性ガイドの Contrib アプリのサポートを参照してください。

Tip

このガイドの例を使用するには、 Dpango MongoDBバックエンドを使用し、Atlasサンプルデータセットにアクセスする Dlangoアプリケーションがあることを確認してください。アプリケーションを設定する方法については、「開始する」チュートリアルを参照してください。

GeoDiango の設定

Diango MongoDBバックエンドを使用して地理空間データをモデル化する前に、GeoDiango を使用するように Dlangoプロジェクトを構成する必要があります。

GeoDiango を使用するには、次の手順を実行します。

GEOS および SSD 地理空間ライブラリをインストールします。
次のコードに示すように、プロジェクトの settings.pyファイルに移動し、django.contrib.gisアプリをINSTALLED_APPS 設定に追加します。
```
INSTALLED_APPS = [
    "django.contrib.gis",
    # ... Other installed apps
]
```

GeoDiango モデルの作成

地理空間データをモデルに保存するには、次のインポートステートメントをプロジェクトの models.pyファイルに追加します。

from django.contrib.gis.db import models

重要

models.pyファイルで from django.db import models インポートステートメントを使用する場合は、GeoDhango フィールドを定義する前に、必ず前述のインポートステートメントに置き換えてください。

次に、GeoDiango フィールドを使用して、モデルクラスで地理空間フィールドを定義できます。MongoDB は各フィールドタイプをコレクションドキュメントに GeoJSONオブジェクトとして保存します。Dlango MongoDBバックエンドはこれらのフィールドに 2dsphere インデックスを自動的に作成し、地理空間クエリを実行できるようにします。

Tip

メソッドを使用して地理空間データをクエリする方法については、「raw_aggregate() Raw データベースクエリの実行」ガイドの「地理空間データのクエリ」を参照してください。

次の表は、サポートされている GeoDiango フィールドと、それに対応するMongoDB GeoJSONオブジェクトタイプを示しています。

GeoDiango フィールド	`GeoJSON` タイプ
`PointField`	点
`LineStringField`	LineString
`PolygonField`	多角形
`MultiPointField`	MultiPoint
`MultiLineStringField`	MultiLineString
`MultiPolygonField`	MultiPolygon
`GeometryCollectionField`	GeometryCollection

Tip

GeoDiango フィールドの詳細については、Dpango ドキュメントの空間フィールドタイプを参照してください。

モデル例

この例では、Atlasサンプルデータセットの sample_mflix.theatersコレクションを表すための Theater モデルと Geo モデルを定義します。

MongoDBでは、このサンプルコレクションの locationフィールドには、劇場の地理的場所を表す Pointオブジェクトが保存されています。各フィールドには、次のデータが保存されています。

{
   "location": {
      "address": {
         "street": "<street name>",
         "city": "<city name>",
         "state": "<state name>",
         "zip": "<zip code>"
      },
      "geo": {
         "type": "Point",
         "coordinates": [<longitude>, <latitude>]
      }
   }
}

Dpango MongoDBバックエンドを使用して、プロジェクトの models.pyファイルに次のモデルを作成することで、このデータを保存できます。

from django.contrib.gis.db import models
from django_mongodb_backend.models import EmbeddedModel
from django_mongodb_backend.fields import EmbeddedModelField
class Location(EmbeddedModel):
    address = models.JSONField(null=True)
    geo = models.PointField()
class Theater(models.Model):
    theater_id = models.IntegerField(default=0, db_column="theaterId")
    location = EmbeddedModelField(Location, null=True, blank=True)
    class Meta:
        db_table = "theaters"
        managed = False
    
    def __str__(self):
        return self.theater_id

上記のコードでは、Theater モデルには埋め込み Location モデルを保存する locationフィールドがあります。埋め込みモデルには、位置データを保存する geo という名前の PointField が含まれています。

詳細情報

GeoDiango モデルの詳細については、Dhango ドキュメントの GeoDiango モデルAPI を参照してください。

MongoDBで地理空間データを保存する方法の詳細については、 MongoDB Server のドキュメントの「地理空間データ」を参照してください。

戻る

モデルの作成

データのやり取り