django.contrib.gis.measure モジュールには、距離や面積の単位を便利に表現するためのオブジェクトが含まれています。 [1] 具体的には、Distance と Area の 2 つのオブジェクトを実装しており、それぞれ D と A の便利なエイリアスを介してアクセスできます。
Distance objects may be instantiated using a keyword argument\nindicating the context of the units. In the example below, two different\ndistance objects are instantiated in units of kilometers (km) and miles\n(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\nDistance オブジェクト同士を掛け合わせると、その結果は、二乗の単位で表される 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単位 (unit) 属性 | \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
| \nLink | \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 でサポートされています：
単位 (unit) 属性 | \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