API форм GeoDjango

srid

Field.srid

Это код SRID, к которому должно быть преобразовано значение поля. Например, если SRID виджета карты отличается от SRID, используемого в целом вашей приложением или базой данных, поле автоматически преобразует входные значения в этот SRID.

geom_type

Field.geom_type

Как правило, вам не нужно устанавливать или изменять этот атрибут, который должен быть установлен в зависимости от класса поля. Он соответствует стандартному имени геометрии OpenGIS.

GeometryField

class GeometryField [source]

PointField

class PointField [source]

LineStringField

class LineStringField [source]

PolygonField

class PolygonField [source]

MultiPointField

class MultiPointField [source]

MultiLineStringField

class MultiLineStringField [source]

MultiPolygonField

class MultiPolygonField [source]

GeometryCollectionField

class GeometryCollectionField [source]

Атрибуты виджетов

Виджеты GeoDjango основаны на шаблонах, поэтому их атрибуты в основном отличаются от атрибутов других виджетов Django.

BaseGeometryWidget.geom_type

Тип геометрии OpenGIS, обычно задаваемый полем формы.

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

Классы виджетов

BaseGeometryWidget

class BaseGeometryWidget [source]

Это абстрактный базовый виджет, содержащий логику, необходимую для подклассов. Вы не можете напрямую использовать этот виджет для поля геометрии. Обратите внимание, что отрисовка виджетов GeoDjango основана на шаблоне, определенном атрибутом класса template_name.

OpenLayersWidget

class OpenLayersWidget [source]

Это виджет по умолчанию, используемый всеми полями форм GeoDjango. template_name это gis/openlayers.html.

OpenLayersWidget и OSMWidget используют файл ol.js, размещенный на сети доставки контента cdn.jsdelivr.net. Вы можете подклассировать эти виджеты, чтобы указать вашу собственную версию файла ol.js в свойстве js внутреннего класса Media (см. Аксессуары как статическое определение).

OSMWidget

class OSMWidget [source]

Этот виджет использует базовый слой OpenStreetMap для отображения географических объектов. Атрибуты:

template_name

gis/openlayers-osm.html

default_lat

default_lon

По умолчанию широта и долгота центра карты составляют 47 и 5 соответственно, что является местоположением на востоке Франции.

default_zoom

По умолчанию масштаб карты равен 12.

Примечание о размещении файла JavaScript, приведенное выше для OpenLayersWidget, также относится и сюда. Также обратите внимание на ответ на часто задаваемый вопрос о доступе к тайлам карты https.