Measurement Objects

django.contrib.gis.measure模块包含允许方便地表示距离和面积测量单位的对象。 [1] Specifically, it implements two objects, Distance and Area – both of which may be accessed via the D and A convenience aliases, respectively.

Example

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

>>> from django.contrib.gis.measure import Distance, D
>>> 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

Supported units

单位属性 全名或别名
千米 公里，公里
MI 英里
m 米，米
YD 码
FT 脚，脚（国际）
survey_ft 我们。 脚，美国调查脚
英寸 英寸
厘米 厘米
毫米 毫米，毫米
UM 千分尺，微米
british_ft 英国脚（Sears 1922）
british_yd 英国码头（Sears 1922）
british_chain_sears 英国链（Sears 1922）
indian_yd 印度庭院，院子（印度）
sears_yd 院子（西尔斯）
clarke_ft 克拉克的脚
链 链
chain_benoit 链（Benoit）
chain_sears 链（Sears）
british_chain_benoit 英国链（Benoit 1895 B）
british_chain_sears_truncated 英国链（Sears 1922 truncated）
gold_coast_ft 黄金海岸脚
链接 链接
link_benoit 链接（Benoit）
link_sears 链接（Sears）
clarke_link Clarke的链接
捉摸 捉摸
竿 竿
纳米 海里
nm_uk Nautical Mile（英国）
german_m 德国法律表

注

Area属性与Distance属性相同，但它们以sq_（区域单位本质上是正方形）为前缀。 例如，Area(sq_m=2)创建一个表示两平方米的Area对象。

Measurement API

Distance

类 Distance(**kwargs)[source]

要初始化距离对象，请传入与所需值相对应的关键字unit attribute name。 例如，以下创建表示5英里的距离对象：

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

返回与给定单位属性对应的单位的距离值。 像这样：

>>> print(dist.km)
8.04672
类方法 unit_attname T0>（ UNIT_NAME T1>）¶ T2>

返回给定完整单元名称的距离单位属性名称。 像这样：

>>> Distance.unit_attname('Mile')
'mi'
类 ð T0> ¶ T1>

Distance类的别名。

Area

类 Area(**kwargs)[source]

要初始化区域对象，请传入与所需值unit attribute name对应的关键字。 例如，以下内容创建了表示5平方英里的区域对象：

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

返回与给定单位属性对应的单位的面积值。 像这样：

>>> print(a.sq_km)
12.949940551680001
类方法 unit_attname T0>（ UNIT_NAME T1>）¶ T2>

返回给定完整单元名称的区域单位属性名称。 像这样：

>>> Area.unit_attname('Kilometer')
'sq_km'
类 A T0> ¶ T1>

Area类的别名。

脚注

[1]Robert Coup是测量对象的初始作者，受到Brian Beck在geopy和Geoff Biggs博士关于机器人尺寸单位的工作的启发。