django.contrib.gis.measure 模块包含了方便表示距离和面积单位的对象。[1] 具体来说，它实现了两个对象，Distance 和 Area —— 这两个对象都可以通过分别使用 D 和 A 的便捷别名来访问。
可以使用指示单位上下文的关键字参数来实例化 Distance 对象。在下面的示例中，使用单位为千米（km）和英里（mi）来实例化两个不同的距离对象：
>>> from django.contrib.gis.measure import D, Distance\n>>> d1 = Distance(km=5)\n>>> print(d1)\n5.0 km\n>>> d2 = D(mi=5) # `D` is an alias for `Distance`\n>>> print(d2)\n5.0 mi\n要进行转换，访问首选单位属性以获取转换后的距离数量：
\n>>> print(d1.mi) # Converting 5 kilometers to miles\n3.10685596119\n>>> print(d2.km) # Converting 5 miles to kilometers\n8.04672\n此外，可以在距离对象之间执行算术操作：
\n>>> print(d1 + d2) # Adding 5 miles to 5 kilometers\n13.04672 km\n>>> print(d2 - d1) # Subtracting 5 kilometers from 5 miles\n1.89314403881 mi\n两个 Distance 对象相乘将产生一个 Area 对象，它使用单位的平方：
>>> a = d1 * d2 # Returns an Area object.\n>>> print(a)\n40.2336 sq_km\n要确定单位的属性缩写是什么，可以使用 unit_attname 类方法：
>>> print(Distance.unit_attname("US Survey Foot"))\nsurvey_ft\n>>> print(Distance.unit_attname("centimeter"))\ncm\n单位属性 | \n全名或别名 | \n
|---|---|
| \nKilometre, Kilometer | \n
| \nMile | \n
| \nMeter, Metre | \n
| \nYard | \n
| \nFoot, Foot (International) | \n
| \nU.S. Foot, US survey foot | \n
| \nInches | \n
| \nCentimeter | \n
| \nMillimetre, Millimeter | \n
| \nMicrometer, Micrometre | \n
| \nBritish foot (Sears 1922) | \n
| \nBritish yard (Sears 1922) | \n
| \nBritish chain (Sears 1922) | \n
| \nIndian yard, Yard (Indian) | \n
| \nYard (Sears) | \n
| \nClarke's Foot | \n
| \nChain | \n
| \nChain (Benoit) | \n
| \nChain (Sears) | \n
| \nBritish chain (Benoit 1895 B) | \n
| \nBritish chain (Sears 1922 truncated) | \n
| \nGold Coast foot | \n
| \n链接 | \n
| \nLink (Benoit) | \n
| \nLink (Sears) | \n
| \nClarke's link | \n
| \nFathom | \n
| \nRod | \n
| \nFurlong, Furrow Long | \n
| \nNautical Mile | \n
| \nNautical Mile (UK) | \n
| \nGerman legal metre | \n
除了带有 sq_ 前缀的单位外，以下单位也支持 Area：
单位属性 | \n全名或别名 | \n
|---|---|
| \n公顷 | \n
DistanceLink to this heading#要初始化一个距离对象，请传递一个关键字，该关键字对应于所需的 单位属性名称 并设置所需的值。例如，以下代码创建一个表示 5 英里的距离对象：
\n>>> dist = Distance(mi=5)\n返回与给定单位属性对应的距离值。例如：
\n>>> print(dist.km)\n8.04672\n返回给定完整单位名称的距离单位属性名称。例如：
\n>>> Distance.unit_attname("Mile")\n'mi'\nDistance 类的别名。
AreaLink to this heading#要初始化一个面积对象，请传入一个与所需的 单位属性名称 对应的关键字，并设置所需的值。例如，以下代码创建了一个表示 5 平方英里的面积对象：
\n>>> a = Area(sq_mi=5)\n返回与给定单位属性对应的面积值。例如：
\n>>> print(a.sq_km)\n12.949940551680001\n返回给定完整单位名称的面积单位属性名称。例如：
\n>>> Area.unit_attname("Kilometer")\n'sq_km'\nArea 类的别名。
脚注
\n\n