---
title: "Foirmeacha API GeodJango"
version: 5.2
locale: ga
source: https://docs.djangoproject.com/ga/5.2/ref/contrib/gis/forms-api/
canonical: https://djangodocs.dev/ga/5.2/ref/contrib/gis/forms-api/
---
# Foirmeacha API GeodJango

Soláthraíonn GeodJango roinnt réimsí foirme speisialaithe agus giuirléidí d'fhonn sonraí geolocálaithe a thaispeáint agus a chur in eagar ar léarscáil. De réir réamhshocraithe, úsáideann siad léarscáileanna [OpenLayers](https://openlayers.org/) faoi thiomáint, le bonn ciseal WMS a sholáthraíonn [NASA](https://www.earthdata.nasa.gov/).

## Argóintí réimse

Chomh maith leis na rialt:ref: argóintí réimse foirm \<core-field-arguments\>, glacann réimsí foirme GeodJango na hargóintí roghnacha seo a leanas.

### `Srid`

#### `Field.srid`

Is é seo an cód SRID ar chóir luach an réimse a athrú. Mar shampla, má tá an giuirléid léarscáileanna SRID difriúil ón SRID a úsáideann d'fheidhmchlár nó do bhunachar sonraí níos ginearálta, tiontóidh an réimse luachanna ionchuir go huathoibríoch go SRID sin.

### `cineál_geom`

#### `Field.geom_type`

De ghnáth níor cheart go mbeadh ort an tréith sin a shocrú nó a athrú ar chóir a chur ar bun ag brath ar an rang allamuigh. Meaitseálann sé ainm geoiméadrach caighdeánach OpenGIS.

### `max_geom_collections`

#### `Field.max_geom_collections`

> **New in Django 5.2.17**

The maximum number of geometry collections the field accepts before
refusing to parse the input and raising a
[`ValidationError`](/ga/5.2/ref/exceptions/#django.core.exceptions.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.

## Ranganna réimse foirm

### `Réimse Geoiméadraithe`

#### `class GeometryField`

### `Pointfield`

#### `class PointField`

### `Línestringfield`

#### `class LineStringField`

### `Polygonfield`

#### `class PolygonField`

### `Réimse Ilphoint`

#### `class MultiPointField`

### `Páirc Illíneach`

#### `class MultiLineStringField`

### `Multipolygonfield`

#### `class MultiPolygonField`

### `Réimse Bailiúcháin Geoimetrach`

#### `class GeometryCollectionField`

## Giuirléidí foir

Ligeann giuirléidí foirme GeodJango duit sonraí geografacha a thaispeáint agus a chur in eagar ar léarscáil amhairc Tabhair faoi deara nach dtacaíonn aon cheann de na giuirléidí atá ar fáil faoi láthair le geoiméadair 3D, mar sin tiocfaidh réimsí geoiméadachta siar ag úsáid giuirléid Textarea\` le haghaidh sonraí den sórt

### tréithe giuirléid

Tá giuirléidí GeodJango bunaithe ar theimpléad, mar sin tá a gcuid tréithe difriúil den chuid is mó ó thréithe giuirléid Django eile.

#### `BaseGeometryWidget.geom_type`

An cineál geoiméadracht OpenGIS, arna shocrú go ginearálta ag an réimse foirme.

#### `BaseGeometryWidget.map_srid`

Cód SRID a úsáideann an léarscáil (réamhshocraithe ná 4326).

#### `BaseGeometryWidget.display_raw`

Luach Boolean a shonraíonn an bhfuil ionchur textarea a thaispeánann léiriú sraitheach an ghéiméadracht reatha le feiceáil, go príomha chun críocha dífhabhtaithe (is é “False” réamhshocraithe).

#### `BaseGeometryWidget.supports_3d`

Léiríonn sé an dtacaíonn an giuirléid le eagrán sonraí 3D (réamhshocraithe ná `False`).

#### `BaseGeometryWidget.template_name`

An teimpléad a úsáidtear chun an giuirléid léarscáil a

Is féidir leat tréithe giuirléid a rith ar an mbealach céanna le haghaidh aon ghuirléid Django eile. Mar shampla:

```
from django.contrib.gis import forms

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

### Ranganna giuirléid

`BasegeometryWidget`

#### `class BaseGeometryWidget`

Is giuirléid bonn teibí é seo ina bhfuil an loighic a theastaíonn ó fho-aicmí. Ní féidir leat an giuirléid seo a úsáid go díreach do réimse geoiméadrach. Tabhair faoi deara go bhfuil rindreáil giuirléidí GeodJango bunaithe ar theimpléad, a aithnítear ag an tréith aicme:attr: template\_name.

`OpenLayersWidget`

#### `class OpenLayersWidget`

Is é seo an giuirléid réamhshocraithe a úsáideann gach réimse foirme GeodJango. Is é `template_name` gis/openlayers.html\`.

Úsáid `OpenLayersWidget` agus:class: OsmWidget an comhad ```ol.js ``arna óstáil ar an líonra seachadta ábhair ``cdn.jsdelivr.net```. Is féidir leat na giuirléidí seo a fho-aicmiú d'fhonn do leagan féin den chomhad `ol.js` a shonrú i maoin js\` den aicme Meáin istigh (féach:ref: assets-as-a-static-definition).

`OsmWidget`

#### `class OSMWidget`

Úsáideann an giuirléid seo ciseal bonn OpenStreetMap chun rudaí geografacha a thaispeáint. Is iad na tréithe:

#### `template_name`

`gis/openlayers-osm.html`

#### `default_lat`

#### `default_lon`

Is é an domhantead agus an domhanfhad lárnach réamhshocraithe `47` agus `5`, faoi seach, atá ina suíomh in oirthear na Fraince.

#### `default_zoom`

Is é `12` an súmáil léarscáileanna réamhshocraithe.

Tá feidhm ag an nóta:class: OpenLayersWidget faoi óstáil comhad JavaScript thuas anseo freisin. Féach freisin an freagra Ceisteanna Coitianta \`\_ faoi rochtain \`https\` ar tíleanna léarscáileanna.