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博士关于机器人尺寸单位的工作的启发。