GeoDjango はジオローカライズされたデータを地図上に視覚的に表示・編集するために、いくつかの特殊なフォームフィールドとウィジェットを提供します。デフォルトでは、 NASA が提供する WMS レイヤーをベースとした OpenLayers を利用した地図を使います。
通常の フォームフィールドの引数 に加えて、 GeoDjango のフォームフィールドは以下のオプションの引数を取ります。
srid¶これはフィールドの値を変換するSRIDコードです。例えば、マップウィジェットのSRIDがアプリケーションやデータベースで一般的に使われるSRIDと異なる場合、フィールドは入力値を自動的にそのSRIDに変換します。
geom_type¶通常、その属性を設定または変更する必要はありません。この属性はフィールドクラスに応じて設定されるべきです。これはOpenGIS標準のジオメトリ名に一致します。
GeometryField¶PointField¶LineStringField¶PolygonField¶MultiPointField¶MultiLineStringField¶MultiPolygonField¶GeometryCollectionField¶GeoDjango のフォームウィジェットを使うと、ビジュアルマップ上に地理情報を表示したり編集したりできます。現在利用可能なウィジェットはどれも 3D ジオメトリをサポートしていないので、 ジオメトリフィールドは Textarea ウィジェットを使ってフォールバックします。
GeoDjango ウィジェットはテンプレートベースなので、その属性のほとんどは他の Django ウィジェットの属性と異なります。
A string that specifies the identifier for the default base map layer to be
used by the corresponding JavaScript map widget. It is passed as part of
the widget options when rendering, allowing the MapWidget to determine
which map tile provider or base layer to initialize (default is None).
OpenGIS ジオメトリタイプ。通常、フォームフィールドによって設定されます。
地図で使用されるSRIDコード (デフォルトは4326)。
主にデバッグのために、現在のジオメトリのシリアライズされた表現を示すテキストエリア入力を表示するかどうかを指定するブール値 (デフォルトは False).
ウィジェットが3Dデータの編集をサポートしているかどうかを示します (デフォルトは False です) 。
地図ウィジェットのレンダリングに使用されるテンプレート。
ウィジェットの属性は、他のDjangoウィジェットと同じように渡すことができます。例えば、次のようにします:
from django.contrib.gis import forms
class MyGeoForm(forms.Form):
point = forms.PointField(widget=forms.OSMWidget(attrs={"display_raw": True}))
BaseGeometryWidget
This is an abstract base widget containing the logic needed by subclasses.
You cannot directly use this widget for a geometry field.
Note that the rendering of GeoDjango widgets is based on a base layer name,
identified by the base_layer class attribute.
OpenLayersWidget
This is the default widget used by all GeoDjango form fields. Attributes are:
nasaWorldview
gis/openlayers.html.
3857
OpenLayersWidget and OSMWidget include the ol.js and
ol.css files hosted on the cdn.jsdelivr.net content-delivery
network. These files can be overridden by subclassing the widget and
setting the js and css properties of the inner Media class (see
定数として定義されたアセット).
External assets with CSP
When ContentSecurityPolicyMiddleware is
enabled, the default OpenLayers CDN assets (ol.js and ol.css)
will be blocked unless explicitly allowed. This can be addressed in one
of two ways: serve assets locally by subclassing the widget and
provide local copies of the JavaScript and CSS files, or
allow the CDN in the CSP policy.
For example, to allow the default NASA Worldview base layer (replace
x.y.z with the actual version):
from django.utils.csp import CSP
SECURE_CSP = {
"default-src": [CSP.SELF],
"script-src": [CSP.SELF, "https://cdn.jsdelivr.net/npm/ol@x.y.z/dist/ol.js"],
"style-src": [CSP.SELF, "https://cdn.jsdelivr.net/npm/ol@x.y.z/ol.css"],
"img-src": [CSP.SELF, "https://*.earthdata.nasa.gov"],
}
OSMWidget
This widget specialized OpenLayersWidget and uses an OpenStreetMap
base layer to display geographic objects on. Attributes are:
osm
デフォルトの中心緯度と経度はそれぞれ 47 と 5 で、フランス東部の位置です。
デフォルトの地図の縮尺は 12 です。
The OpenLayersWidget note about using external assets also applies
here. See also this FAQ answer about https access to map tiles.
OpenStreetMap tiles with CSP
This widget uses OpenStreetMap tiles instead of NASA Worldview. If
Content Security Policy enabled, both the OpenLayers CDN resources (as
required by OpenLayersWidget) and the OpenStreetMap tile
servers must be allowed:
from django.utils.csp import CSP
SECURE_CSP = {
# other directives
"img-src": [CSP.SELF, "https://tile.openstreetmap.org"],
}
The OSMWidget no longer uses a custom template. Consequently, the
gis/openlayers-osm.html template was removed.
To customize the base layer displayed in OpenLayers-based geometry widgets, define a new layer builder in a custom JavaScript file. For example:
path-to-file.js¶ MapWidget.layerBuilder.custom_layer_name = function () {
// Return an OpenLayers layer instance.
return new ol.layer.Tile({source: new ol.source.<ChosenSource>()});
};
Then, subclass a standard geometry widget and set the base_layer:
from django.contrib.gis.forms.widgets import OpenLayersWidget
class YourCustomWidget(OpenLayersWidget):
base_layer = "custom_layer_name"
class Media:
js = ["path-to-file.js"]
12月 04, 2025