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

单位属性全名或别名
km公里,公里
mi英里
m米,米
yd
ft脚,脚(国际)
survey_ft我们。脚,美国调查脚
inch英寸
cm厘米
mm毫米,毫米
um千分尺,微米
british_ft英国脚(Sears 1922)
british_yd英国码头(Sears 1922)
british_chain_sears英国链(Sears 1922)
indian_yd印度庭院,院子(印度)
sears_yd院子(西尔斯)
clarke_ft克拉克的脚
chain
chain_benoit链(Benoit)
chain_sears链(Sears)
british_chain_benoit英国链(Benoit 1895 B)
british_chain_sears_truncated英国链(Sears 1922 truncated)
gold_coast_ft黄金海岸脚
link链接
link_benoit链接(Benoit)
link_sears链接(Sears)
clarke_linkClarke的链接
fathom捉摸
rod竿
nm海里
nm_ukNautical Mile(英国)
german_m德国法律表

注意

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

Measurement API

Distance

class Distance(**kwargs)[source]

要初始化距离对象,请传入与所需值相对应的关键字unit attribute name例如,以下创建表示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]

要初始化区域对象,请传入与所需值unit attribute name对应的关键字。例如,以下内容创建了表示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类的别名。

脚注

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