GeoDjango 表单 APILink to this heading#

sridLink to this heading#

Field.sridLink to this definition#

这是字段值应该转换为的 SRID 代码。例如，如果地图小部件的 SRID 与您的应用程序或数据库通常使用的 SRID 不同，该字段将自动将输入值转换为该 SRID。

geom_typeLink to this heading#

Field.geom_typeLink to this definition#

通常情况下，您不应该设置或更改该属性，它应该根据字段类进行设置。它与 OpenGIS 标准的几何名称相匹配。

max_geom_collectionsLink to this heading#

Field.max_geom_collectionsLink to this definition#

The maximum number of geometry collections the field accepts before refusing to parse the input and raising a ValidationError. This guards against crashes in the underlying GEOS library when parsing deeply nested GEOMETRYCOLLECTION input. It defaults to 198.

The limit is applied differently depending on the input format: for well-known text (WKT) it bounds the nesting depth, while for well-known binary (WKB and hex-encoded WKB) it bounds the total number of geometry collections (both breadth and depth). As a result, the same value may accept a wide, shallow collection as WKT but reject it as WKB. For GeoJSON, the limit is not applied at all, since GDAL parses that input type instead.

Increase this value (or set to None) only if you must accept legitimately deep geometries, since doing so reduces protection against fatal errors.

GeometryFieldLink to this heading#

class GeometryFieldLink to this definition#

PointFieldLink to this heading#

class PointFieldLink to this definition#

LineStringFieldLink to this heading#

class LineStringFieldLink to this definition#

PolygonFieldLink to this heading#

class PolygonFieldLink to this definition#

MultiPointFieldLink to this heading#

class MultiPointFieldLink to this definition#

MultiLineStringFieldLink to this heading#

class MultiLineStringFieldLink to this definition#

MultiPolygonFieldLink to this heading#

class MultiPolygonFieldLink to this definition#

GeometryCollectionFieldLink to this heading#

class GeometryCollectionFieldLink to this definition#

表单属性Link to this heading#

GeoDjango 的小部件是基于模板的，因此它们的属性大部分与其他 Django 小部件的属性不同。

BaseGeometryWidget.base_layerLink to this definition#

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).

BaseGeometryWidget.geom_typeLink to this definition#

OpenGIS 几何类型，通常由表单字段设置。

BaseGeometryWidget.map_sridLink to this definition#

地图使用的 SRID 代码（默认为 4326）。

BaseGeometryWidget.display_rawLink to this definition#

布尔值，指定是否可见一个文本区域输入框，显示当前几何形状的序列化表示，主要用于调试目的（默认为 False）。

BaseGeometryWidget.supports_3dLink to this definition#

指示小部件是否支持编辑 3D 数据的属性（默认为 False）。

BaseGeometryWidget.template_nameLink to this definition#

用于呈现地图小部件的模板。

您可以以与任何其他 Django 小部件相同的方式传递小部件属性。例如：

from django.contrib.gis import forms


class MyGeoForm(forms.Form):
    point = forms.PointField(widget=forms.OSMWidget(attrs={"display_raw": True}))

部件类Link to this heading#

BaseGeometryWidget

class BaseGeometryWidgetLink to this definition#

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

class OpenLayersWidgetLink to this definition#

This is the default widget used by all GeoDjango form fields. Attributes are:

base_layerLink to this definition#

nasaWorldview

template_nameLink to this definition#

gis/openlayers.html.

map_sridLink to this definition#

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 资源作为静态定义).

OSMWidget

class OSMWidgetLink to this definition#

This widget specialized OpenLayersWidget and uses an OpenStreetMap base layer to display geographic objects on. Attributes are:

base_layerLink to this definition#

osm

default_latLink to this definition#

default_lonLink to this definition#

默认的中心纬度和经度分别是 47 和 5，这是法国东部的一个位置。

default_zoomLink to this definition#

默认的地图缩放级别是 12。

The OpenLayersWidget note about using external assets also applies here. See also this FAQ answer about https access to map tiles.

Customizing the base layer used in OpenLayers-based widgetsLink to this heading#

To customize the base layer displayed in OpenLayers-based geometry widgets, define a new layer builder in a custom JavaScript file. For example:

 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"]