GeoDjango フォーム API¶
GeoDjango はジオローカライズされたデータを地図上に視覚的に表示・編集するために、いくつかの特殊なフォームフィールドとウィジェットを提供します。デフォルトでは、 NASA が提供する WMS レイヤーをベースとした OpenLayers を利用した地図を使います。
フィールドの引数¶
通常の フォームフィールドの引数 に加えて、 GeoDjango のフォームフィールドは以下のオプションの引数を取ります。
フォームフィールド クラス¶
フォームウィジェット¶
GeoDjango のフォームウィジェットを使うと、ビジュアルマップ上に地理情報を表示したり編集したりできます。現在利用可能なウィジェットはどれも 3D ジオメトリをサポートしていないので、 ジオメトリフィールドは Textarea ウィジェットを使ってフォールバックします。
ウィジェットの属性¶
GeoDjango ウィジェットはテンプレートベースなので、その属性のほとんどは他の Django ウィジェットの属性と異なります。
-
BaseGeometryWidget.geom_type¶ OpenGIS ジオメトリタイプ。通常、フォームフィールドによって設定されます。
-
BaseGeometryWidget.map_height¶
-
BaseGeometryWidget.map_width¶ ウィジェットマップの高さと幅 (デフォルトは400x600)。
バージョン 4.2 で非推奨:
map_height属性とmap_width属性は非推奨となりました。代わりに、マップウィジェットのサイズ指定にはCSSを使用してください。
-
BaseGeometryWidget.map_srid¶ 地図で使用されるSRIDコード (デフォルトは4326)。
-
BaseGeometryWidget.display_raw¶ 主にデバッグのために、現在のジオメトリのシリアライズされた表現を示すテキストエリア入力を表示するかどうかを指定するブール値 (デフォルトは
False).
-
BaseGeometryWidget.supports_3d¶ ウィジェットが3Dデータの編集をサポートしているかどうかを示します (デフォルトは
Falseです) 。
-
BaseGeometryWidget.template_name¶ 地図ウィジェットのレンダリングに使用されるテンプレート。
ウィジェットの属性は、他のDjangoウィジェットと同じように渡すことができます。例えば、次のようにします:
from django.contrib.gis import forms
class MyGeoForm(forms.Form):
point = forms.PointField(widget=forms.OSMWidget(attrs={"display_raw": True}))
Widget クラス¶
BaseGeometryWidget
-
class
BaseGeometryWidget¶ これは、サブクラスが必要とするロジックを含む抽象ベースウィジェットです。このウィジェットを直接ジオメトリフィールドに使うことはできません。GeoDjango ウィジェットのレンダリングは
template_nameクラス属性で識別されるテンプレートに基づいていることに注意してください。
OpenLayersWidget
-
class
OpenLayersWidget¶ これはすべての GeoDjango フォームフィールドで使用されるデフォルトウィジェットです。
template_nameはgis/openlayers.htmlです。OpenLayersWidgetとOSMWidgetはcdn.jsdelivr.netのコンテンツ配信ネットワークでホストされているol.jsファイルを使用します。これらのウィジェットをサブクラス化することで、内部のMediaクラスのjsプロパティにol.jsファイルの独自のバージョンを指定できます (定数として定義されたアセット を参照) 。
OSMWidget
-
class
OSMWidget¶ このウィジェットは地理情報オブジェクトを表示するためにOpenStreetMapベースレイヤーを使用します。属性は以下の通りです:
-
template_name¶ gis/openlayers-osm.html
-
default_lat¶
-
default_lon¶ デフォルトの中心緯度と経度はそれぞれ
47と5で、フランス東部の位置です。
-
default_zoom¶ デフォルトの地図の縮尺は
12です。
OpenLayersWidgetの JavaScript ファイルのホスティングに関する注意はここにも適用されます。マップタイルへのhttpsアクセスに関する FAQ answer も参照してください。-
