GeoDjango provides some specialized form fields and widgets in order to visually display and edit geolocalized data on a map. By default, they use OpenLayers-powered maps, with a base WMS layer provided by NASA.
In addition to the regular form field arguments, GeoDjango form fields take the following optional arguments.
srid
Field.
srid
geom_type
Field.
geom_type
GeometryField
GeometryField
PointField
PointField
LineStringField
LineStringField
PolygonField
PolygonField
MultiPointField
MultiPointField
MultiLineStringField
MultiLineStringField
MultiPolygonField
MultiPolygonField
GeometryCollectionField
GeometryCollectionField
GeoDjango form widgets allow you to display and edit geographic data on a
visual map.
Note that none of the currently available widgets supports 3D geometries, hence
geometry fields will fallback using a Textarea
widget for such data.
GeoDjango widgets are template-based, so their attributes are mostly different from other Django widget attributes.
BaseGeometryWidget.
geom_type
BaseGeometryWidget.
map_height
BaseGeometryWidget.
map_width
BaseGeometryWidget.
map_srid
BaseGeometryWidget.
display_raw
False
).BaseGeometryWidget.
supports_3d
False
).BaseGeometryWidget.
template_name
You can pass widget attributes in the same manner that for any other Django widget. For example:
from django.contrib.gis import forms
class MyGeoForm(forms.Form):
point = forms.PointField(widget=
forms.OSMWidget(attrs={'map_width': 800, 'map_height': 500}))
BaseGeometryWidget
BaseGeometryWidget
template_name
class attribute.OpenLayersWidget
OpenLayersWidget
This is the default widget used by all GeoDjango form fields.
template_name
is gis/openlayers.html
.
OpenLayersWidget
and OSMWidget
use the openlayers.js
file
hosted on the cdnjs.cloudflare.com
content-delivery network. You can
subclass these widgets in order to specify your own version of the
OpenLayers.js
file in the js
property of the inner Media
class
(see 资源作为静态定义).
OSMWidget
OSMWidget
This widget uses an OpenStreetMap base layer to display geographic objects on. Attributes are:
template_name
gis/openlayers-osm.html
default_lat
default_lon
The default center latitude and longitude are 47
and 5
,
respectively, which is a location in eastern France.
default_zoom
The default map zoom is 12
.
The OpenLayersWidget
note about JavaScript file hosting above also
applies here. See also this FAQ answer about https
access to map
tiles.