{"title":"GeoDjango チュートリアル","version":"6.0","locale":"ja","docname":"ref/contrib/gis/tutorial","url":"/ja/6.0/ref/contrib/gis/tutorial/","canonical":"https://djangodocs.dev/ja/6.0/ref/contrib/gis/tutorial/","summary":"はじめに Link to this heading #…","html":"

GeoDjango チュートリアルLink to this heading#

\n
\n

はじめにLink to this heading#

\n

GeoDjangoは、Django用の標準のcontribモジュールであり、それを世界クラスの地理情報Webフレームワークに変えます。GeoDjangoは、位置情報サービスなどの地理情報Webアプリケーションを作成するのを可能な限り簡単にすることを目指しています。その特徴は次のとおりです:

\n\n

このチュートリアルは Django に慣れていることを前提にしています。従って、 Django が初めての方は、まず 通常のチュートリアル を読んで Django に慣れてください。

\n\n

このチュートリアルでは、地理情報を表示するためのウェブアプリケーションの作成方法を説明します。このチュートリアルでは、world borders [1] を表示します。このチュートリアルで使用されるコードの一部は、GeoDjango basic apps プロジェクトから取得されたか、その影響を受けています。 [2]

\n\n
\n
\n

セットアップLink to this heading#

\n
\n

空間データベースを作成するLink to this heading#

\n

通常、特別な設定は必要ないので、他のプロジェクトと同じようにデータベースを作成できます。選択したデータベースについて、いくつかのヒントを提供します:

\n\n
\n
\n

新しいプロジェクトを作成するLink to this heading#

\n

標準の django-admin スクリプトを使って、 geodjango というプロジェクトを作成します:

\n

Linux / macOS

Shell
$ django-admin startproject geodjango\n
\n

Windows

Windows
...\\> django-admin startproject geodjango\n
\n

これで新しいプロジェクトが初期化されます。ここで、 geodjango プロジェクトの中に world Django アプリケーションを作成します:

\n

Linux / macOS

Shell
$ cd geodjango\n$ python manage.py startapp world\n
\n

Windows

Windows
...\\> cd geodjango\n...\\> py manage.py startapp world\n
\n
\n
\n

settings.py の設定Link to this heading#

\n

geodjango プロジェクトの設定は geodjango/settings.py ファイルに保存されています。データベース接続設定を編集して、自分の環境に合わせてください:

\n
Code
DATABASES = {\n    "default": {\n        "ENGINE": "django.contrib.gis.db.backends.postgis",\n        "NAME": "geodjango",\n        "USER": "geo",\n    },\n}\n
\n

さらに、 INSTALLED_APPS 設定を変更して、 django.contrib.admin, django.contrib.gis, world (新しく作成したアプリケーション) を含めるようにします:

\n
Code
INSTALLED_APPS = [\n    "django.contrib.admin",\n    "django.contrib.auth",\n    "django.contrib.contenttypes",\n    "django.contrib.sessions",\n    "django.contrib.messages",\n    "django.contrib.staticfiles",\n    "django.contrib.gis",\n    "world",\n]\n
\n
\n
\n
\n

地理データLink to this heading#

\n
\n

世界の国境Link to this heading#

\n

The world borders data is available in this zip file. Create a data\ndirectory in the world application, download the world borders data, and\nunzip. On GNU/Linux platforms, use the following commands:

\n

Linux / macOS

Shell
$ mkdir world/data\n$ cd world/data\n$ wget https://web.archive.org/web/20231220150759/https://thematicmapping.org/downloads/TM_WORLD_BORDERS-0.3.zip\n$ unzip TM_WORLD_BORDERS-0.3.zip\n$ cd ../..\n
\n

Windows

Windows
...\\> mkdir world\\data\n...\\> cd world\\data\n...\\> wget https://web.archive.org/web/20231220150759/https://thematicmapping.org/downloads/TM_WORLD_BORDERS-0.3.zip\n...\\> unzip TM_WORLD_BORDERS-0.3.zip\n...\\> cd ..\\..\n
\n

The world borders ZIP file contains a set of data files collectively known as\nan ESRI Shapefile, one of the most popular geospatial data formats. When\nunzipped, the world borders dataset includes files with the following\nextensions:

\n\n
\n
\n

ogrinfo を使って空間データを調べるLink to this heading#

\n

GDAL の ogrinfo ユーティリティを使うと、シェープファイルやその他のベクトルデータソースのメタデータを調べることができます:

\n

Linux / macOS

Shell
$ ogrinfo world/data/TM_WORLD_BORDERS-0.3.shp\nINFO: Open of `world/data/TM_WORLD_BORDERS-0.3.shp'\n      using driver `ESRI Shapefile' successful.\n1: TM_WORLD_BORDERS-0.3 (Polygon)\n
\n

Windows

Windows
...\\> ogrinfo world\\data\\TM_WORLD_BORDERS-0.3.shp\nINFO: Open of `world/data/TM_WORLD_BORDERS-0.3.shp'\n      using driver `ESRI Shapefile' successful.\n1: TM_WORLD_BORDERS-0.3 (Polygon)\n
\n

ogrinfo tells us that the shapefile has one layer, and that this\nlayer contains polygon data. To find out more, we'll specify the layer name\nand use the -so option to get only the important summary information:

\n

Linux / macOS

Shell
$ ogrinfo -so world/data/TM_WORLD_BORDERS-0.3.shp TM_WORLD_BORDERS-0.3\nINFO: Open of `world/data/TM_WORLD_BORDERS-0.3.shp'\n      using driver `ESRI Shapefile' successful.\n\nLayer name: TM_WORLD_BORDERS-0.3\nMetadata:\n  DBF_DATE_LAST_UPDATE=2008-07-30\nGeometry: Polygon\nFeature Count: 246\nExtent: (-180.000000, -90.000000) - (180.000000, 83.623596)\nLayer SRS WKT:\nGEOGCRS["WGS 84",\n    DATUM["World Geodetic System 1984",\n        ELLIPSOID["WGS 84",6378137,298.257223563,\n            LENGTHUNIT["metre",1]]],\n    PRIMEM["Greenwich",0,\n        ANGLEUNIT["degree",0.0174532925199433]],\n    CS[ellipsoidal,2],\n        AXIS["latitude",north,\n            ORDER[1],\n            ANGLEUNIT["degree",0.0174532925199433]],\n        AXIS["longitude",east,\n            ORDER[2],\n            ANGLEUNIT["degree",0.0174532925199433]],\n    ID["EPSG",4326]]\nData axis to CRS axis mapping: 2,1\nFIPS: String (2.0)\nISO2: String (2.0)\nISO3: String (3.0)\nUN: Integer (3.0)\nNAME: String (50.0)\nAREA: Integer (7.0)\nPOP2005: Integer64 (10.0)\nREGION: Integer (3.0)\nSUBREGION: Integer (3.0)\nLON: Real (8.3)\nLAT: Real (7.3)\n
\n

Windows

Windows
...\\> ogrinfo -so world\\data\\TM_WORLD_BORDERS-0.3.shp TM_WORLD_BORDERS-0.3\nINFO: Open of `world/data/TM_WORLD_BORDERS-0.3.shp'\n      using driver `ESRI Shapefile' successful.\n\nLayer name: TM_WORLD_BORDERS-0.3\nMetadata:\n  DBF_DATE_LAST_UPDATE=2008-07-30\nGeometry: Polygon\nFeature Count: 246\nExtent: (-180.000000, -90.000000) - (180.000000, 83.623596)\nLayer SRS WKT:\nGEOGCRS["WGS 84",\n    DATUM["World Geodetic System 1984",\n        ELLIPSOID["WGS 84",6378137,298.257223563,\n            LENGTHUNIT["metre",1]]],\n    PRIMEM["Greenwich",0,\n        ANGLEUNIT["degree",0.0174532925199433]],\n    CS[ellipsoidal,2],\n        AXIS["latitude",north,\n            ORDER[1],\n            ANGLEUNIT["degree",0.0174532925199433]],\n        AXIS["longitude",east,\n            ORDER[2],\n            ANGLEUNIT["degree",0.0174532925199433]],\n    ID["EPSG",4326]]\nData axis to CRS axis mapping: 2,1\nFIPS: String (2.0)\nISO2: String (2.0)\nISO3: String (3.0)\nUN: Integer (3.0)\nNAME: String (50.0)\nAREA: Integer (7.0)\nPOP2005: Integer64 (10.0)\nREGION: Integer (3.0)\nSUBREGION: Integer (3.0)\nLON: Real (8.3)\nLAT: Real (7.3)\n
\n

This detailed summary information tells us the number of features in the layer\n(246), the geographic bounds of the data, the spatial reference system\n("SRS WKT"), as well as type information for each attribute field. For example,\nFIPS: String (2.0) indicates that the FIPS character field has\na maximum length of 2. Similarly, LON: Real (8.3) is a floating-point\nfield that holds a maximum of 8 digits up to three decimal places.

\n
\n
\n
\n

地理情報モデルLink to this heading#

\n
\n

地理情報モデルを定義するLink to this heading#

\n

さて、 ogrinfo を使ってデータセットを調べたので、このデータを表す GeoDjango モデルを作成しましょう:

\n
Code
from django.contrib.gis.db import models\n\n\nclass WorldBorder(models.Model):\n    # Regular Django fields corresponding to the attributes in the\n    # world borders shapefile.\n    name = models.CharField(max_length=50)\n    area = models.IntegerField()\n    pop2005 = models.IntegerField("Population 2005")\n    fips = models.CharField("FIPS Code", max_length=2, null=True)\n    iso2 = models.CharField("2 Digit ISO", max_length=2)\n    iso3 = models.CharField("3 Digit ISO", max_length=3)\n    un = models.IntegerField("United Nations Code")\n    region = models.IntegerField("Region Code")\n    subregion = models.IntegerField("Sub-Region Code")\n    lon = models.FloatField()\n    lat = models.FloatField()\n\n    # GeoDjango-specific: a geometry field (MultiPolygonField)\n    mpoly = models.MultiPolygonField()\n\n    # Returns the string representation of the model.\n    def __str__(self):\n        return self.name\n
\n

models モジュールが django.contrib.gis.db からインポートされていることに注意してください。

\n

The default spatial reference system for geometry fields is WGS84 (meaning\nthe SRID is 4326) -- in other words, the field coordinates are in\nlongitude, latitude pairs in units of degrees. To use a different\ncoordinate system, set the SRID of the geometry field with the srid\nargument. Use an integer representing the coordinate system's EPSG code.

\n
\n
\n

migrate を実行するLink to this heading#

\n

モデルを定義した後、データベースと同期する必要があります。まず、データベースマイグレーションを作成してください:

\n

Linux / macOS

Shell
$ python manage.py makemigrations\nMigrations for 'world':\n  world/migrations/0001_initial.py:\n    + Create model WorldBorder\n
\n

Windows

Windows
...\\> py manage.py makemigrations\nMigrations for 'world':\n  world/migrations/0001_initial.py:\n    + Create model WorldBorder\n
\n

WorldBorder モデルのテーブルを生成するSQLを見てみましょう:

\n

Linux / macOS

Shell
$ python manage.py sqlmigrate world 0001\n
\n

Windows

Windows
...\\> py manage.py sqlmigrate world 0001\n
\n

このコマンドを実行すると、次の出力が生成されるはずです:

\n
SQL
BEGIN;\n--\n-- Create model WorldBorder\n--\nCREATE TABLE "world_worldborder" (\n    "id" bigint NOT NULL PRIMARY KEY GENERATED BY DEFAULT AS IDENTITY,\n    "name" varchar(50) NOT NULL,\n    "area" integer NOT NULL,\n    "pop2005" integer NOT NULL,\n    "fips" varchar(2) NOT NULL,\n    "iso2" varchar(2) NOT NULL,\n    "iso3" varchar(3) NOT NULL,\n    "un" integer NOT NULL,\n    "region" integer NOT NULL,\n    "subregion" integer NOT NULL,\n    "lon" double precision NOT NULL,\n    "lat" double precision NOT NULL\n    "mpoly" geometry(MULTIPOLYGON,4326) NOT NULL\n)\n;\nCREATE INDEX "world_worldborder_mpoly_id" ON "world_worldborder" USING GIST ("mpoly");\nCOMMIT;\n
\n

これが正しければ、 migrate を実行して、このテーブルをデータベースに作成してください。

\n

Linux / macOS

Shell
$ python manage.py migrate\nOperations to perform:\n  Apply all migrations: admin, auth, contenttypes, sessions, world\nRunning migrations:\n  ...\n  Applying world.0001_initial... OK\n
\n

Windows

Windows
...\\> py manage.py migrate\nOperations to perform:\n  Apply all migrations: admin, auth, contenttypes, sessions, world\nRunning migrations:\n  ...\n  Applying world.0001_initial... OK\n
\n
\n
\n
\n

空間データをインポートするLink to this heading#

\n

This section will show you how to import the world borders shapefile into the\ndatabase via GeoDjango models using the LayerMapping データインポートユーティリティ.

\n

空間データベースにデータをインポートする方法は色々あります。GeoDjango に含まれるツール以外にも、以下のような方法があります:

\n\n
\n

GDAL インターフェースLink to this heading#

\n

Earlier, you used ogrinfo to examine the contents of the world borders\nshapefile. GeoDjango also includes a Pythonic interface to GDAL's powerful OGR\nlibrary that can work with all the vector data sources that OGR supports.

\n

まず、Django シェルを起動します:

\n

Linux / macOS

Shell
$ python manage.py shell\n
\n

Windows

Windows
...\\> py manage.py shell\n
\n

チュートリアルの最初の方で 世界の国境 データをダウンロードしている場合は、Pythonの pathlib.Path を使用してそのパスを指定できます:

\n
Python console
>>> from pathlib import Path\n>>> import world\n>>> world_shp = Path(world.__file__).resolve().parent / "data" / "TM_WORLD_BORDERS-0.3.shp"\n
\n

ここで、GeoDjango の DataSource インタフェースを使って、 world borders shapefile を開いてください:

\n
Python console
>>> from django.contrib.gis.gdal import DataSource\n>>> ds = DataSource(world_shp)\n>>> print(ds)\n/ ... /geodjango/world/data/TM_WORLD_BORDERS-0.3.shp (ESRI Shapefile)\n
\n

データソースオブジェクトは異なるレイヤーの地理空間フィーチャを持つことができます。しかし、シェープファイルは 1 つのレイヤーしか持つことができません:

\n
Python console
>>> print(len(ds))\n1\n>>> lyr = ds[0]\n>>> print(lyr)\nTM_WORLD_BORDERS-0.3\n
\n

レイヤーのジオメトリタイプと、含まれているフィーチャの数を確認できます:

\n
Python console
>>> print(lyr.geom_type)\nPolygon\n>>> print(len(lyr))\n246\n
\n\n

The Layer may also have a spatial reference\nsystem associated with it. If it does, the srs attribute will return a\nSpatialReference object:

\n
Python console
>>> srs = lyr.srs\n>>> print(srs)\nGEOGCS["WGS 84",\nDATUM["WGS_1984",\n    SPHEROID["WGS 84",6378137,298.257223563,\n        AUTHORITY["EPSG","7030"]],\n    AUTHORITY["EPSG","6326"]],\nPRIMEM["Greenwich",0,\n    AUTHORITY["EPSG","8901"]],\nUNIT["degree",0.0174532925199433,\n    AUTHORITY["EPSG","9122"]],\nAXIS["Latitude",NORTH],\nAXIS["Longitude",EAST],\nAUTHORITY["EPSG","4326"]]\n>>> srs.proj  # PROJ representation\n'+proj=longlat +datum=WGS84 +no_defs'\n
\n

このシェープファイルは一般的なWGS84空間参照システム、つまりデータは度の単位で経度緯度の組を使用しています。

\n

In addition, shapefiles also support attribute fields that may contain\nadditional data. Here are the fields on the World Borders layer:

\n
Python console
>>> print(lyr.fields)\n['FIPS', 'ISO2', 'ISO3', 'UN', 'NAME', 'AREA', 'POP2005', 'REGION', 'SUBREGION', 'LON', 'LAT']\n
\n

以下のコードで、各フィールドに関連するOGRタイプ (整数や文字列など) を調べることができます:

\n
Python console
>>> [fld.__name__ for fld in lyr.field_types]\n['OFTString', 'OFTString', 'OFTString', 'OFTInteger', 'OFTString', 'OFTInteger', 'OFTInteger64', 'OFTInteger', 'OFTInteger', 'OFTReal', 'OFTReal']\n
\n

レイヤー内の各フィーチャをイテレートし、フィーチャのジオメトリ (geom 属性でアクセス) とフィーチャの属性フィールド (get() メソッドで 値 にアクセス) の両方から情報を抽出できます:

\n
Python console
>>> for feat in lyr:\n...     print(feat.get("NAME"), feat.geom.num_points)\n...\nGuernsey 18\nJersey 26\nSouth Georgia South Sandwich Islands 338\nTaiwan 363\n
\n

Layer オブジェクトはスライス可能です。

\n
Python console
>>> lyr[0:2]\n[<django.contrib.gis.gdal.feature.Feature object at 0x2f47690>, <django.contrib.gis.gdal.feature.Feature object at 0x2f47650>]\n
\n

また、個々のフィーチャは、フィーチャ ID で検索できます:

\n
Python console
>>> feat = lyr[234]\n>>> print(feat.get("NAME"))\nSan Marino\n
\n

国境ジオメトリは、WKT および GeoJSON としてエクスポートできます:

\n
Python console
>>> geom = feat.geom\n>>> print(geom.wkt)\nPOLYGON ((12.415798 43.957954,12.450554 ...\n>>> print(geom.json)\n{ "type": "Polygon", "coordinates": [ [ [ 12.415798, 43.957954 ], [ 12.450554, 43.979721 ], ...\n
\n
\n
\n

LayerMappingLink to this heading#

\n

データをインポートするには、Pythonスクリプト内で LayerMapping を使用します。次のコードを含む world アプリケーション内に load.py というファイルを作成してください:

\n
Code
from pathlib import Path\nfrom django.contrib.gis.utils import LayerMapping\nfrom .models import WorldBorder\n\nworld_mapping = {\n    "fips": "FIPS",\n    "iso2": "ISO2",\n    "iso3": "ISO3",\n    "un": "UN",\n    "name": "NAME",\n    "area": "AREA",\n    "pop2005": "POP2005",\n    "region": "REGION",\n    "subregion": "SUBREGION",\n    "lon": "LON",\n    "lat": "LAT",\n    "mpoly": "MULTIPOLYGON",\n}\n\nworld_shp = Path(__file__).resolve().parent / "data" / "TM_WORLD_BORDERS-0.3.shp"\n\n\ndef run(verbose=True):\n    lm = LayerMapping(WorldBorder, world_shp, world_mapping, transform=False)\n    lm.save(strict=True, verbose=verbose)\n
\n

何が起こっているかについての、ちょっとしたノート:

\n\n

その後、geodjango プロジェクトディレクトリから Django シェルを呼び出してください。

\n

Linux / macOS

Shell
$ python manage.py shell\n
\n

Windows

Windows
...\\> py manage.py shell\n
\n

次に、load モジュールをインポートし、 run ルーチンを呼び出して、 LayerMapping が作業を行う様子を見てください:

\n
Python console
>>> from world import load\n>>> load.run()\n
\n
\n
\n

ogrinspect を試すLink to this heading#

\n

Now that you've seen how to define geographic models and import data with the\nLayerMapping データインポートユーティリティ, it's possible to further automate this\nprocess with use of the ogrinspect management command. The\nogrinspect command introspects a GDAL-supported vector data source\n(e.g., a shapefile) and generates a model definition and LayerMapping\ndictionary automatically.

\n

コマンドの一般的な使用法は以下の通りです:

\n

Linux / macOS

Shell
$ python manage.py ogrinspect [options] <data_source> <model_name> [options]\n
\n

Windows

Windows
...\\> py manage.py ogrinspect [options] <data_source> <model_name> [options]\n
\n

data_source is the path to the GDAL-supported data source and\nmodel_name is the name to use for the model. Command-line options may\nbe used to further define how the model is generated.

\n

たとえば、以下のコマンドを実行すると、ほぼ先ほど作成した WorldBorder モデルとマッピング辞書を自動的に再現します。

\n

Linux / macOS

Shell
$ python manage.py ogrinspect world/data/TM_WORLD_BORDERS-0.3.shp WorldBorder \\\n    --srid=4326 --mapping --multi\n
\n

Windows

Windows
...\\> py manage.py ogrinspect world\\data\\TM_WORLD_BORDERS-0.3.shp WorldBorder \\\n    --srid=4326 --mapping --multi\n
\n

上記のコマンドラインオプションに関していくつかの注意点があります:

\n\n

このコマンドは次のような出力をします。GeoDjango アプリケーションの models.py に直接コピーできます:

\n
Code
# This is an auto-generated Django model module created by ogrinspect.\nfrom django.contrib.gis.db import models\n\n\nclass WorldBorder(models.Model):\n    fips = models.CharField(max_length=2)\n    iso2 = models.CharField(max_length=2)\n    iso3 = models.CharField(max_length=3)\n    un = models.IntegerField()\n    name = models.CharField(max_length=50)\n    area = models.IntegerField()\n    pop2005 = models.IntegerField()\n    region = models.IntegerField()\n    subregion = models.IntegerField()\n    lon = models.FloatField()\n    lat = models.FloatField()\n    geom = models.MultiPolygonField(srid=4326)\n\n\n# Auto-generated `LayerMapping` dictionary for WorldBorder model\nworldborders_mapping = {\n    "fips": "FIPS",\n    "iso2": "ISO2",\n    "iso3": "ISO3",\n    "un": "UN",\n    "name": "NAME",\n    "area": "AREA",\n    "pop2005": "POP2005",\n    "region": "REGION",\n    "subregion": "SUBREGION",\n    "lon": "LON",\n    "lat": "LAT",\n    "geom": "MULTIPOLYGON",\n}\n
\n
\n
\n
\n

空間クエリLink to this heading#

\n
\n

空間のルックアップ (Spatial Lookup)Link to this heading#

\n

GeoDjango adds spatial lookups to the Django ORM. For example, you\ncan find the country in the WorldBorder table that contains\na particular point. First, fire up the management shell:

\n

Linux / macOS

Shell
$ python manage.py shell\n
\n

Windows

Windows
...\\> py manage.py shell\n
\n

ここで、注目するポイント [3] を定義します:

\n
Python console
>>> pnt_wkt = "POINT(-95.3385 29.7245)"\n
\n

The pnt_wkt string represents the point at -95.3385 degrees longitude,\n29.7245 degrees latitude. The geometry is in a format known as\nWell Known Text (WKT), a standard issued by the Open Geospatial\nConsortium (OGC). [4] Import the WorldBorder model, and perform\na contains lookup using the pnt_wkt as the parameter:

\n
Python console
>>> from world.models import WorldBorder\n>>> WorldBorder.objects.filter(mpoly__contains=pnt_wkt)\n<QuerySet [<WorldBorder: United States>]>\n
\n

ここでは、米国の国境という1つのモデルのみを持つ QuerySet を取得しました (まさに期待通りです)。

\n

Similarly, you may also use a GEOS geometry object. Here, you can combine the intersects spatial\nlookup with the get method to retrieve only the WorldBorder instance\nfor San Marino instead of a queryset:

\n
Python console
>>> from django.contrib.gis.geos import Point\n>>> pnt = Point(12.4604, 43.9420)\n>>> WorldBorder.objects.get(mpoly__intersects=pnt)\n<WorldBorder: San Marino>\n
\n

The contains and intersects lookups are just a subset of the available\nqueries -- the GeoDjango データベース API documentation has more.

\n
\n
\n

座標系の自動変換Link to this heading#

\n

When doing spatial queries, GeoDjango automatically transforms\ngeometries if they're in a different coordinate system. In the following\nexample, coordinates will be expressed in EPSG SRID 32140,\na coordinate system specific to south Texas only and in units of\nmeters, not degrees:

\n
Python console
>>> from django.contrib.gis.geos import GEOSGeometry, Point\n>>> pnt = Point(954158.1, 4215137.1, srid=32140)\n
\n

pnt は、SRIDを含むWKTの拡張形式であるEWKTで構築することもできることに注意してください。

\n
Python console
>>> pnt = GEOSGeometry("SRID=32140;POINT(954158.1 4215137.1)")\n
\n

GeoDjango の ORM は、ジオメトリの値を自動的に変換 SQL でラップし、開発者がより高い抽象度で作業できるようにします:

\n
Python console
>>> qs = WorldBorder.objects.filter(mpoly__intersects=pnt)\n>>> print(qs.query)  # Generating the SQL\nSELECT "world_worldborder"."id", "world_worldborder"."name", "world_worldborder"."area",\n"world_worldborder"."pop2005", "world_worldborder"."fips", "world_worldborder"."iso2",\n"world_worldborder"."iso3", "world_worldborder"."un", "world_worldborder"."region",\n"world_worldborder"."subregion", "world_worldborder"."lon", "world_worldborder"."lat",\n"world_worldborder"."mpoly" FROM "world_worldborder"\nWHERE ST_Intersects("world_worldborder"."mpoly", ST_Transform(%s, 4326))\n>>> qs  # printing evaluates the queryset\n<QuerySet [<WorldBorder: United States>]>\n
\n\n
\n
\n

ジオメトリの遅延評価Link to this heading#

\n

GeoDjango loads geometries in a standardized textual representation. When the\ngeometry field is first accessed, GeoDjango creates a\nGEOSGeometry object, exposing powerful\nfunctionality, such as serialization properties for popular geospatial\nformats:

\n
Python console
>>> sm = WorldBorder.objects.get(name="San Marino")\n>>> sm.mpoly\n<MultiPolygon object at 0x24c6798>\n>>> sm.mpoly.wkt  # WKT\nMULTIPOLYGON (((12.4157980000000006 43.9579540000000009, 12.4505540000000003 43.9797209999999978, ...\n>>> sm.mpoly.wkb  # WKB (as Python binary buffer)\n<read-only buffer for 0x1fe2c70, size -1, offset 0 at 0x2564c40>\n>>> sm.mpoly.geojson  # GeoJSON\n'{ "type": "MultiPolygon", "coordinates": [ [ [ [ 12.415798, 43.957954 ], [ 12.450554, 43.979721 ], ...\n
\n

これには、GEOSライブラリが提供するすべての高度な幾何演算へのアクセスが含まれます:

\n
Python console
>>> pnt = Point(12.4604, 43.9420)\n>>> sm.mpoly.contains(pnt)\nTrue\n>>> pnt.contains(sm.mpoly)\nFalse\n
\n
\n
\n

地理情報のアノテーションLink to this heading#

\n

GeoDjango also offers a set of geographic annotations to compute distances and\nseveral other operations (intersection, difference, etc.). See the\n地理情報データベース関数 documentation.

\n
\n
\n
\n

データを地図上に配置するLink to this heading#

\n
\n

地理情報の AdminLink to this heading#

\n

Django の admin アプリケーション はジオメトリフィールドの編集をサポートしています。

\n
\n

基本Link to this heading#

\n

Django のadmin アプリケーションでは、ユーザが JavaScript のスリッピーマップ (OpenLayers を利用) 上でジオメトリを作成したり変更したりできます。

\n

さあ、始めましょう。次のコードを含む world アプリケーション内に admin.py という名前のファイルを作成します:

\n
Code
from django.contrib.gis import admin\nfrom .models import WorldBorder\n\nadmin.site.register(WorldBorder, admin.ModelAdmin)\n
\n

次に、 geodjango アプリケーションフォルダにある urls.py を以下のように編集してください:

\n
Code
from django.contrib import admin\nfrom django.urls import include, path\n\nurlpatterns = [\n    path("admin/", admin.site.urls),\n]\n
\n

admin ユーザーを作成します:

\n

Linux / macOS

Shell
$ python manage.py createsuperuser\n
\n

Windows

Windows
...\\> py manage.py createsuperuser\n
\n

次に、Django 開発サーバを起動します:

\n

Linux / macOS

Shell
$ python manage.py runserver\n
\n

Windows

Windows
...\\> py manage.py runserver\n
\n

最後に http://localhost:8000/admin/ にアクセスし、先ほど作成したユーザーでログインします。 WorldBorder のエントリーをブラウズし、ポリゴンをクリックして頂点を好きな位置までドラッグすることで、境界線を編集できます。

\n
\n
\n

GISModelAdminLink to this heading#

\n

GISModelAdmin を使用すると、GeoDjango は admin アプリケーションで OpenStreetMap レイヤーを使用します。これにより、 ModelAdmin が使用する Vector Map Level 0 WMSデータセット (OSGeo でホストされている) よりも、より多くのコンテキスト (通りや通路の詳細を含む) が提供されます。

\n

PROJの座標変換ファイルがインストールされている必要があります (詳しくは PROJ installation instructions を参照してください) 。

\n

この要件を満たしている場合は、 admin.py ファイルで GISModelAdmin オプションクラスを使用してください:

\n
Code
admin.site.register(WorldBorder, admin.GISModelAdmin)\n
\n

脚注

\n\n
\n
\n
","rootId":"geodjango-tutorial","toc":[{"title":"はじめに","anchor":"introduction","children":[]},{"title":"セットアップ","anchor":"setting-up","children":[{"title":"空間データベースを作成する","anchor":"create-a-spatial-database","children":[]},{"title":"新しいプロジェクトを作成する","anchor":"create-a-new-project","children":[]},{"title":"settings.py の設定","anchor":"configure-settings-py","children":[]}]},{"title":"地理データ","anchor":"geographic-data","children":[{"title":"世界の国境","anchor":"worldborders","children":[]},{"title":"ogrinfo を使って空間データを調べる","anchor":"use-ogrinfo-to-examine-spatial-data","children":[]}]},{"title":"地理情報モデル","anchor":"geographic-models","children":[{"title":"地理情報モデルを定義する","anchor":"defining-a-geographic-model","children":[]},{"title":"migrate を実行する","anchor":"run-migrate","children":[]}]},{"title":"空間データをインポートする","anchor":"importing-spatial-data","children":[{"title":"GDAL インターフェース","anchor":"gdal-interface","children":[]},{"title":"LayerMapping","anchor":"layermapping","children":[]},{"title":"ogrinspect を試す","anchor":"try-ogrinspect","children":[]}]},{"title":"空間クエリ","anchor":"spatial-queries","children":[{"title":"空間のルックアップ (Spatial Lookup)","anchor":"spatial-lookups","children":[]},{"title":"座標系の自動変換","anchor":"automatic-spatial-transformations","children":[]},{"title":"ジオメトリの遅延評価","anchor":"lazy-geometries","children":[]},{"title":"地理情報のアノテーション","anchor":"geographic-annotations","children":[]}]},{"title":"データを地図上に配置する","anchor":"putting-your-data-on-the-map","children":[{"title":"地理情報の Admin","anchor":"geographic-admin","children":[{"title":"基本","anchor":"basics","children":[]},{"title":"GISModelAdmin","anchor":"gismodeladmin","children":[]}]}]}],"breadcrumbs":[{"docname":"ref/index","title":"API リファレンス","url":"/ja/6.0/ref/"},{"docname":"ref/contrib/index","title":"contrib パッケージ","url":"/ja/6.0/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/ja/6.0/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/ja/6.0/ref/contrib/gis/"},"next":{"docname":"ref/contrib/gis/install/index","title":"GeoDjango のインストール","url":"/ja/6.0/ref/contrib/gis/install/"},"formats":{"html":"/ja/6.0/ref/contrib/gis/tutorial/","markdown":"/ja/6.0/ref/contrib/gis/tutorial.md","json":"/ja/6.0/ref/contrib/gis/tutorial.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/ref/contrib/gis/tutorial.txt","official":"https://docs.djangoproject.com/ja/6.0/ref/contrib/gis/tutorial/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}