---
title: "Rudaí Tomhais"
version: 6.0
locale: ga
source: https://docs.djangoproject.com/ga/6.0/ref/contrib/gis/measure/
canonical: https://djangodocs.dev/ga/6.0/ref/contrib/gis/measure/
---
# Rudaí Tomhais

Tá rudaí sa mhodúl:MOD: django.contrib.gis.measur a cheadaíonn léiriú áisiúil ar aonaid achair agus limistéar tomhais. \[#\] \_ Go sonrach, cuireann sé dhá rud i bhfeidhm, :class: Fistance agus:class: A agus: aicme: A aistrithe, faoi seach.

## Sampla

[`Distance`](#django.contrib.gis.measure.Distance) objects may be instantiated using a keyword argument
indicating the context of the units. In the example below, two different
distance objects are instantiated in units of kilometers (`km`) and miles
(`mi`):

```pycon
>>> from django.contrib.gis.measure import D, Distance
>>> d1 = Distance(km=5)
>>> print(d1)
5.0 km
>>> d2 = D(mi=5)  # `D` is an alias for `Distance`
>>> print(d2)
5.0 mi
```

Maidir le tiontaithe, rochtain ar an tréith aonaid is fearr leat chun cainníocht achair tiontaithe a fháil:

```pycon
>>> print(d1.mi)  # Converting 5 kilometers to miles
3.10685596119
>>> print(d2.km)  # Converting 5 miles to kilometers
8.04672
```

Thairis sin, féadfar oibríochtaí uimhríochta a dhéanamh idir na rudaí achair:

```pycon
>>> print(d1 + d2)  # Adding 5 miles to 5 kilometers
13.04672 km
>>> print(d2 - d1)  # Subtracting 5 kilometers from 5 miles
1.89314403881 mi
```

Dhá: aicme: réad “Fad” a iolraítear le chéile torfaidh réad: aicme: Limistéar, a úsáideann aonaid tomhais cearnacha:

```pycon
>>> a = d1 * d2  # Returns an Area object.
>>> print(a)
40.2336 sq_km
```

Chun a chinneadh cad é an giorrúchán tréithe aonaid, féadfar an modh aicme unit\_attname\` a úsáid:

```pycon
>>> print(Distance.unit_attname("US Survey Foot"))
survey_ft
>>> print(Distance.unit_attname("centimeter"))
cm
```

## Aonaid tacaithe

| Tréith Aonad | Ainm iomlán nó ainm (í) |
| --- | --- |
| `km` | Kiliméadar, Ciliméadar |
| Mi \`\` | Míle |
| `m` | Méadar, Méadar |
| `yd` | Clós |
| `` `ft `` | Cos, Cos (Idirnáisiúnta) |
| `suirbhé_ft` | Cos na SA, cos suirbhé na SA |
| `orl` | orlach |
| `cm` | Ceintiméadar |
| `mm` | Milliméadar, Milliméadar |
| `um` | Micriméadar, Micriméadar |
| British\_ft \`\` | Cos na Breataine (Sears 1922) |
| British\_yd \`\` | Clós na Breataine (Sears 1922) |
| `Seach_slabhra_na Breataine` | Slabhra na Breataine (Sears 1922) |
| Indian\_yd \`\` | Clós Indiach, Clós (Indiach) |
| `sears_yd` | Clós (Sears) |
| `clarke_ft` | Cos Clarke |
| `slabhra` | Slabhra |
| `slabhra_benoit` | Slabhra (Benoit) |
| `chain_sears` | Slabhra (Sears) |
| `British_chain_benoit` | Slabhra na Breataine (Benoit 1895 B) |
| `` `Slabhra_British_sears_truncaded `` | Slabhra na Breataine (Sears 1922 gearrtha) |
| `ór_cósta_ft` | Cos an Chósta Óir |
| `nasc` | Nasc |
| `nasc_benoit` | Nasc (Benoit) |
| `nasc_sears` | Nasc (Sears) |
| `clarke_nasc` | Nasc Clarke |
| `Fathom` | Fathom |
| `` `sland `` | Slat |
| `furlong` | Furlong, Furrow Long |
| `nm` | Míle Farraige |
| `nm_uk` | Míle Mhuir (RA) |
| `Gearmáin_m` | Méadar dlí na Gearmáine |

> **Note**
>
> [`Area`](#django.contrib.gis.measure.Area) attributes are the same as [`Distance`](#django.contrib.gis.measure.Distance) attributes,
> except they are prefixed with `sq_` (area units are square in nature).
> For example, `Area(sq_m=2)` creates an [`Area`](#django.contrib.gis.measure.Area) object
> representing two square meters.

Chomh maith le haonad leis an réimír sq\_\`, tacaítear leis na haonaid seo a leanas freisin ar:class: Area:

| Tréith Aonad | Ainm iomlán nó ainm (í) |
| --- | --- |
| `ha` | Heicteár |

## API Tomhais

### Fad \`\`

#### `class Distance(**kwargs)`

Chun réad achair a thionscnamh, cuir isteach eochairfhocal a fhreagraíonn don ainm tréith aonaid atá ag teastáil leis an luach atá ag teastáil: ref: ainm tréithe aonaid \<supported\_units\>\`atá leagtha Mar shampla, cruthaíonn an méid seo a leanas réad achair a léiríonn 5 míle:

```pycon
>>> dist = Distance(mi=5)
```

#### `__getattr__(unit_att)`

Tugann an luach achair ar ais in aonaid a fhreagraíonn don tréith aonaid a thugtar. Mar shampla:

```pycon
>>> print(dist.km)
8.04672
```

#### `classmethod unit_attname(unit_name)`

Tugann ainm tréith an aonaid achair ar ais don ainm iomlán aonaid a thugtar. Mar shampla:

```pycon
>>> Distance.unit_attname("Mile")
'mi'
```

#### `class D`

Alias le haghaidh: aicme: Fad aicme.

### `Limistéar`

#### `class Area(**kwargs)`

Chun réad limistéar a thionscnamh, cuir isteach eochairfhocal a fhreagraíonn don ainm tréith aonaid atá ag teastáil leis an luach atá ag teast \<supported\_units\>áil. Mar shampla, cruthaíonn an méid seo a leanas réad ceantair a léiríonn 5 míle cearnach:

```pycon
>>> a = Area(sq_mi=5)
```

#### `__getattr__(unit_att)`

Tugann luach an limistéar ar ais in aonaid a fhreagraíonn don tréith aonaid a thugtar. Mar shampla:

```pycon
>>> print(a.sq_km)
12.949940551680001
```

#### `classmethod unit_attname(unit_name)`

Tugann ainm tréithe an aonaid limistéar ar ais don ainm iomlán aonaid a thugtar. Mar shampla:

```pycon
>>> Area.unit_attname("Kilometer")
'sq_km'
```

#### `class A`

Alias le haghaidh: aicme: Limistéar aicme.

**Fonótaí**

[^1]: \< <https://koordinates.com/>\>Is é [Robert Coup](#robert-coup) údar tosaigh na rudaí tomhais, agus spreagadh é ag obair Brian Beck in obair PhD [geopy](#geopy) agus \< <https://github.com/geopy/geopy/>\> Geoff Biggs' ar aonaid toisíthe do róbataic.