测量对象

django.contrib.gis.measure 模块包含了方便表示距离和面积单位的对象。[1] 具体来说，它实现了两个对象，Distance 和 Area —— 这两个对象都可以通过分别使用 D 和 A 的便捷别名来访问。

例如

可以使用指示单位上下文的关键字参数来实例化 Distance 对象。在下面的示例中，使用单位为千米（km）和英里（mi）来实例化两个不同的距离对象：

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

要进行转换，访问首选单位属性以获取转换后的距离数量：

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

此外，可以在距离对象之间执行算术操作：

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

两个 Distance 对象相乘将产生一个 Area 对象，它使用单位的平方：

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

要确定单位的属性缩写是什么，可以使用 unit_attname 类方法：

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

支持的单位

单位属性

全名或别名

km

Kilometre, Kilometer

mi

Mile

m

Meter, Metre

yd

Yard

ft

Foot, Foot (International)

survey_ft

U.S. Foot, US survey foot

inch

Inches

cm

Centimeter

mm

Millimetre, Millimeter

um

Micrometer, Micrometre

british_ft

British foot (Sears 1922)

british_yd

British yard (Sears 1922)

british_chain_sears

British chain (Sears 1922)

indian_yd

Indian yard, Yard (Indian)

sears_yd

Yard (Sears)

clarke_ft

Clarke's Foot

chain

Chain

chain_benoit

Chain (Benoit)

chain_sears

Chain (Sears)

british_chain_benoit

British chain (Benoit 1895 B)

british_chain_sears_truncated

British chain (Sears 1922 truncated)

gold_coast_ft

Gold Coast foot

link

链接

link_benoit

Link (Benoit)

link_sears

Link (Sears)

clarke_link

Clarke's link

fathom

Fathom

rod

Rod

furlong

Furlong, Furrow Long

nm

Nautical Mile

nm_uk

Nautical Mile (UK)

german_m

German legal metre

Note

Area 的属性与 Distance 的属性相同，只是它们以 sq_ 为前缀（面积单位是平方单位）。例如，Area(sq_m=2) 创建一个表示两平方米的 Area 对象。

In addition to unit with the sq_ prefix, the following units are also supported on Area:

单位属性

全名或别名

ha

Hectare
Changed in Django 5.1:

Support for the ha unit was added.

测量 API

Distance

class Distance(**kwargs)[source]

要初始化一个距离对象，请传递一个关键字，该关键字对应于所需的 单位属性名称 并设置所需的值。例如，以下代码创建一个表示 5 英里的距离对象：

>>> dist = Distance(mi=5)
__getattr__(unit_att)

返回与给定单位属性对应的距离值。例如：

>>> print(dist.km)
8.04672
classmethod unit_attname(unit_name)

返回给定完整单位名称的距离单位属性名称。例如：

>>> Distance.unit_attname("Mile")
'mi'
class D

Distance 类的别名。

Area

class Area(**kwargs)[source]

要初始化一个面积对象，请传入一个与所需的 单位属性名称 对应的关键字，并设置所需的值。例如，以下代码创建了一个表示 5 平方英里的面积对象：

>>> a = Area(sq_mi=5)
__getattr__(unit_att)

返回与给定单位属性对应的面积值。例如：

>>> print(a.sq_km)
12.949940551680001
classmethod unit_attname(unit_name)

返回给定完整单位名称的面积单位属性名称。例如：

>>> Area.unit_attname("Kilometer")
'sq_km'
class A

Area 类的别名。

脚注

Back to Top