{"title":"GeoDjango フォーム API","version":"5.0","locale":"ja","docname":"ref/contrib/gis/forms-api","url":"/ja/5.0/ref/contrib/gis/forms-api/","canonical":"https://djangodocs.dev/ja/5.0/ref/contrib/gis/forms-api/","summary":"GeoDjango はジオローカライズされたデータを地図上に視覚的に表示・編集するために、いくつかの特殊なフォームフィールドとウィジェットを提供します。デフォルトでは、 NASA が提供する WMS レイヤーをベースとした OpenLayers を利用した地図を使います。 フィールドの引数 Link to this…","html":"

GeoDjango フォーム APILink to this heading#

\n

GeoDjango はジオローカライズされたデータを地図上に視覚的に表示・編集するために、いくつかの特殊なフォームフィールドとウィジェットを提供します。デフォルトでは、 NASA が提供する WMS レイヤーをベースとした OpenLayers を利用した地図を使います。

\n
\n

フィールドの引数Link to this heading#

\n

通常の フォームフィールドの引数 に加えて、 GeoDjango のフォームフィールドは以下のオプションの引数を取ります。

\n
\n

sridLink to this heading#

\n
\n
\nField.sridLink to this definition#
\n

これはフィールドの値を変換するSRIDコードです。例えば、マップウィジェットのSRIDがアプリケーションやデータベースで一般的に使われるSRIDと異なる場合、フィールドは入力値を自動的にそのSRIDに変換します。

\n
\n\n
\n
\n

geom_typeLink to this heading#

\n
\n
\nField.geom_typeLink to this definition#
\n

通常、その属性を設定または変更する必要はありません。この属性はフィールドクラスに応じて設定されるべきです。これはOpenGIS標準のジオメトリ名に一致します。

\n
\n\n
\n
\n
\n

フォームフィールド クラスLink to this heading#

\n
\n

GeometryFieldLink to this heading#

\n
\n
\nclass GeometryFieldLink to this definition#
\n
\n\n
\n
\n

PointFieldLink to this heading#

\n
\n
\nclass PointFieldLink to this definition#
\n
\n\n
\n
\n

LineStringFieldLink to this heading#

\n
\n
\nclass LineStringFieldLink to this definition#
\n
\n\n
\n
\n

PolygonFieldLink to this heading#

\n
\n
\nclass PolygonFieldLink to this definition#
\n
\n\n
\n
\n

MultiPointFieldLink to this heading#

\n
\n
\nclass MultiPointFieldLink to this definition#
\n
\n\n
\n
\n

MultiLineStringFieldLink to this heading#

\n
\n
\nclass MultiLineStringFieldLink to this definition#
\n
\n\n
\n
\n

MultiPolygonFieldLink to this heading#

\n
\n
\nclass MultiPolygonFieldLink to this definition#
\n
\n\n
\n
\n

GeometryCollectionFieldLink to this heading#

\n
\n
\nclass GeometryCollectionFieldLink to this definition#
\n
\n\n
\n
\n
\n

フォームウィジェットLink to this heading#

\n

GeoDjango のフォームウィジェットを使うと、ビジュアルマップ上に地理情報を表示したり編集したりできます。現在利用可能なウィジェットはどれも 3D ジオメトリをサポートしていないので、 ジオメトリフィールドは Textarea ウィジェットを使ってフォールバックします。

\n
\n

ウィジェットの属性Link to this heading#

\n

GeoDjango ウィジェットはテンプレートベースなので、その属性のほとんどは他の Django ウィジェットの属性と異なります。

\n
\n
\nBaseGeometryWidget.geom_typeLink to this definition#
\n

OpenGIS ジオメトリタイプ。通常、フォームフィールドによって設定されます。

\n
\n\n
\n
\nBaseGeometryWidget.map_heightLink to this definition#
\n
\n\n
\n
\nBaseGeometryWidget.map_widthLink to this definition#
\n

ウィジェットマップの高さと幅 (デフォルトは400x600)。

\n\n
\n\n
\n
\nBaseGeometryWidget.map_sridLink to this definition#
\n

地図で使用されるSRIDコード (デフォルトは4326)。

\n
\n\n
\n
\nBaseGeometryWidget.display_rawLink to this definition#
\n

主にデバッグのために、現在のジオメトリのシリアライズされた表現を示すテキストエリア入力を表示するかどうかを指定するブール値 (デフォルトは False).

\n
\n\n
\n
\nBaseGeometryWidget.supports_3dLink to this definition#
\n

ウィジェットが3Dデータの編集をサポートしているかどうかを示します (デフォルトは False です) 。

\n
\n\n
\n
\nBaseGeometryWidget.template_nameLink to this definition#
\n

地図ウィジェットのレンダリングに使用されるテンプレート。

\n
\n\n

ウィジェットの属性は、他のDjangoウィジェットと同じように渡すことができます。例えば、次のようにします:

\n
Code
from django.contrib.gis import forms\n\n\nclass MyGeoForm(forms.Form):\n    point = forms.PointField(widget=forms.OSMWidget(attrs={"display_raw": True}))\n
\n
\n
\n

Widget クラスLink to this heading#

\n

BaseGeometryWidget

\n
\n
\nclass BaseGeometryWidgetLink to this definition#
\n

これは、サブクラスが必要とするロジックを含む抽象ベースウィジェットです。このウィジェットを直接ジオメトリフィールドに使うことはできません。GeoDjango ウィジェットのレンダリングは template_name クラス属性で識別されるテンプレートに基づいていることに注意してください。

\n
\n\n

OpenLayersWidget

\n
\n
\nclass OpenLayersWidgetLink to this definition#
\n

これはすべての GeoDjango フォームフィールドで使用されるデフォルトウィジェットです。template_name は gis/openlayers.html です。

\n

OpenLayersWidget と OSMWidget は cdn.jsdelivr.net のコンテンツ配信ネットワークでホストされている ol.js ファイルを使用します。これらのウィジェットをサブクラス化することで、内部の Media クラスの js プロパティに ol.js ファイルの独自のバージョンを指定できます (定数として定義されたアセット を参照) 。

\n
\n\n

OSMWidget

\n
\n
\nclass OSMWidgetLink to this definition#
\n

このウィジェットは地理情報オブジェクトを表示するためにOpenStreetMapベースレイヤーを使用します。属性は以下の通りです:

\n
\n
\ntemplate_nameLink to this definition#
\n

gis/openlayers-osm.html

\n
\n\n
\n
\ndefault_latLink to this definition#
\n
\n\n
\n
\ndefault_lonLink to this definition#
\n

デフォルトの中心緯度と経度はそれぞれ 47 と 5 で、フランス東部の位置です。

\n
\n\n
\n
\ndefault_zoomLink to this definition#
\n

デフォルトの地図の縮尺は 12 です。

\n
\n\n

OpenLayersWidget の JavaScript ファイルのホスティングに関する注意はここにも適用されます。マップタイルへの https アクセスに関する FAQ answer も参照してください。

\n
\n\n
\n
","rootId":"module-django.contrib.gis.forms","toc":[{"title":"フィールドの引数","anchor":"field-arguments","children":[{"title":"srid","anchor":"srid","children":[]},{"title":"geom_type","anchor":"geom-type","children":[]}]},{"title":"フォームフィールド クラス","anchor":"form-field-classes","children":[{"title":"GeometryField","anchor":"geometryfield","children":[]},{"title":"PointField","anchor":"pointfield","children":[]},{"title":"LineStringField","anchor":"linestringfield","children":[]},{"title":"PolygonField","anchor":"polygonfield","children":[]},{"title":"MultiPointField","anchor":"multipointfield","children":[]},{"title":"MultiLineStringField","anchor":"multilinestringfield","children":[]},{"title":"MultiPolygonField","anchor":"multipolygonfield","children":[]},{"title":"GeometryCollectionField","anchor":"geometrycollectionfield","children":[]}]},{"title":"フォームウィジェット","anchor":"module-django.contrib.gis.forms.widgets","children":[{"title":"ウィジェットの属性","anchor":"widget-attributes","children":[]},{"title":"Widget クラス","anchor":"widget-classes","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"API リファレンス","url":"/ja/5.0/ref/"},{"docname":"ref/contrib/index","title":"contrib パッケージ","url":"/ja/5.0/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/ja/5.0/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/db-api","title":"GeoDjango データベース API","url":"/ja/5.0/ref/contrib/gis/db-api/"},"next":{"docname":"ref/contrib/gis/geoquerysets","title":"GIS QuerySet API リファレンス","url":"/ja/5.0/ref/contrib/gis/geoquerysets/"},"formats":{"html":"/ja/5.0/ref/contrib/gis/forms-api/","markdown":"/ja/5.0/ref/contrib/gis/forms-api.md","json":"/ja/5.0/ref/contrib/gis/forms-api.json"},"source":"https://github.com/django/django/blob/stable/5.0.x/docs/ref/contrib/gis/forms-api.txt","official":"https://docs.djangoproject.com/ja/5.0/ref/contrib/gis/forms-api/","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","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}