GeoDjango Forms API

GeoDjango предоставляет некоторые специализированные поля форм и виджеты для визуального отображения и редактирования геолокализованных данных на карте. По умолчанию они используют карты на основе OpenLayers, с базовым слоем WMS, предоставленным NASA.

Аргументы полей

Помимо стандартных аргументов полей форм, поля форм GeoDjango принимают следующие необязательные аргументы.

`srid`

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

`geom_type`

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

Классы полей форм

`GeometryField`

class GeometryField

`PointField`

class PointField

`LineStringField`

class LineStringField

`PolygonField`

class PolygonField

`MultiPointField`

class MultiPointField

`MultiLineStringField`

class MultiLineStringField

`MultiPolygonField`

class MultiPolygonField

`GeometryCollectionField`

class GeometryCollectionField

Виджеты форм

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

BaseGeometryWidget.geom_type: Тип геометрии OpenGIS, обычно устанавливается полем формы.

BaseGeometryWidget.map_height

BaseGeometryWidget.map_width: Высота и ширина карты виджета (по умолчанию 400x600).

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={'map_width': 800, 'map_height': 500}))

BaseGeometryWidget

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

OpenLayersWidget

class OpenLayersWidget

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

OpenLayersWidget и OSMWidget используют файл openlayers.js, размещённый на сети доставки контента cdnjs.cloudflare.com. Вы можете расширить эти виджеты, чтобы указать собственную версию файла OpenLayers.js адаптированную к вашим потребностям в свойстве js внутреннего класса Media (см. Актив как статическое определение).

Изменено в Django 1.11:

Старые версии используют OpenLayers.js из openlayers.org, что непригодно для использования в производстве, так как не гарантирует время работы и работает на медленном сервере.

Также, виджет теперь использует OpenLayers 3 вместо OpenLayers 2.

OSMWidget

class OSMWidget

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

template_name: gis/openlayers-osm.html

default_lat

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

default_zoom: Добавлена в Django 2.0.

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

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