GeoDjango propose quelques champs et composants de formulaires spécialisés afin d’afficher et de modifier visuellement des données géolocalisées sur une carte. Par défaut, ils utilisent des cartes motorisées par OpenLayers, avec une couche de base WMS fournie par la NASA.
\nEn plus des paramètres de champs de formulaires habituels, les champs de formulaires GeoDjango acceptent les paramètres facultatifs suivants.
\nsridLien vers cette rubrique#Il s’agit du code SRID utilisé pour transformer la valeur du champ. Par exemple, si le SRID du composant de carte est différent du SRID utilisé plus généralement par votre application ou base de données, le champ convertit automatiquement les valeurs d’entrée dans ce SRID.
\ngeom_typeLien vers cette rubrique#Cet attribut n’a généralement pas besoin d’être défini ou modifié, car il est automatiquement défini en fonction de la classe du champ. Il correspond au nom d’objet géométrique du standard OpenGIS.
\nmax_geom_collectionsLien vers cette rubrique#The maximum number of geometry collections the field accepts before\nrefusing to parse the input and raising a\nValidationError. This guards against crashes\nin the underlying GEOS library when parsing deeply nested\nGEOMETRYCOLLECTION input. It defaults to 198.
The limit is applied differently depending on the input format: for\nwell-known text (WKT) it bounds the nesting depth, while for well-known\nbinary (WKB and hex-encoded WKB) it bounds the total number of geometry\ncollections (both breadth and depth). As a result, the same value may\naccept a wide, shallow collection as WKT but reject it as WKB. For GeoJSON,\nthe limit is not applied at all, since GDAL parses that input type instead.
\nIncrease this value (or set to None) only if you must accept\nlegitimately deep geometries, since doing so reduces protection against\nfatal errors.
GeometryFieldLien vers cette rubrique#PointFieldLien vers cette rubrique#LineStringFieldLien vers cette rubrique#PolygonFieldLien vers cette rubrique#MultiPointFieldLien vers cette rubrique#MultiLineStringFieldLien vers cette rubrique#MultiPolygonFieldLien vers cette rubrique#GeometryCollectionFieldLien vers cette rubrique#Les composants de formulaires GeoDjango permettent d’afficher et de modifier des données géographiques visuellement sur une carte. Notez qu’aucun des composants actuellement disponibles ne prend en charge les objets géométriques 3D, ce qui fait que les champs géométriques se rabattent sur un composant Textarea s’ils ont affaire à de tels objets.
Les composants GeoDjango sont basés sur les gabarits, ce qui fait que leurs attributs sont majoritairement différents des autres attributs de composants Django.
\nUne chaîne indiquant l’identifiant de la couche cartographique de base par défaut à utiliser par le composant de carte JavaScript correspondant. Elle est transmise dans les options du composant au moment du rendu, permettant à MapWidget de déterminer quel fournisseur de tuiles de carte ou de couche de base à initialiser (vaut None par défaut).
Le type de géométrie OpenGIS, généralement défini par le champ de formulaire.
\nCode SRID utilisé par la carte (la valeur par défaut est 4326).
\nValeur booléenne indiquant si une boîte de saisie de texte affichant la représentation sérialisée de l’objet géométrique en cours est visible, principalement à des fins de débogage (la valeur par défaut est False).
Indique si le composant prend en charge l’édition de données 3D (la valeur par défaut est False).
Le gabarit utilisé pour produire le composant de carte.
\nVous pouvez transmettre des attributs de composants de la même façon que pour tout autre composant Django. Par exemple :
\nfrom django.contrib.gis import forms\n\n\nclass MyGeoForm(forms.Form):\n point = forms.PointField(widget=forms.OSMWidget(attrs={"display_raw": True}))\nBaseGeometryWidget
Il s’agit d’un composant de base abstrait contenant la logique nécessaire aux sous-classes. Il n’est pas possible d’utiliser directement ce composant pour un champ géométrique. Notez que la production de composants GeoDjango est basée sur un nom de couche de base, identifié par l’attribut de classe base_layer.
OpenLayersWidget
Il s’agit du composant par défaut utilisé par tous les champs de formulaires GeoDjango. Ses attributs sont :
\nnasaWorldview
gis/openlayers.html.
3857
OpenLayersWidget et OSMWidget incluent les fichiers ol.js et ol.css hébergés sur le réseau de diffusion de contenu cdn.jsdelivr.net. Ces fichiers peuvent être surchargés en créant une sous-classe du composant et en définissant les propriétés js et css de la classe Media interne (voir Fichiers annexes définis statiquement).
OSMWidget
Ce composant spécialise OpenLayersWidget en utilisant une couche de base OpenStreetMap pour afficher les objets géographiques. Ses attributs sont :
osm
Les latitude et longitude du centre sont respectivement 47 et 5 par défaut, ce qui correspond à un emplacement à l’est de la France.
Le zoom de carte par défaut est 12.
La note OpenLayersWidget au sujet des fichiers statiques externes est aussi valable dans ce cas. Voir aussi cette réponse de FAQ au sujet de l’accès https aux tuiles de cartes.
Pour personnaliser la couche de base affichée dans les composants géométriques basés sur OpenLayers, définissez un nouveau constructeur de couche dans un fichier JavaScript personnalisé. Par exemple :
\nchemin-vers-fichier.js MapWidget.layerBuilder.custom_layer_name = function () {\n // Return an OpenLayers layer instance.\n return new ol.layer.Tile({source: new ol.source.<ChosenSource>()});\n };\nPuis, créez une sous-classe du composant géométrique standard et définissez l’attribut base_layer:
from django.contrib.gis.forms.widgets import OpenLayersWidget\n\n\nclass YourCustomWidget(OpenLayersWidget):\n base_layer = "custom_layer_name"\n\n class Media:\n js = ["path-to-file.js"]\n