Modulen django.contrib.gis.measure innehåller objekt som gör det möjligt att på ett bekvämt sätt representera måttenheter för avstånd och yta. [Specifikt implementerar den två objekt, Distance och Area – som båda kan nås via D respektive A bekvämlighetsalias.
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\nFör konverteringar kan du använda attributet för önskad enhet för att få en konverterad avståndsmängd:
\n>>> print(d1.mi) # Converting 5 kilometers to miles\n3.10685596119\n>>> print(d2.km) # Converting 5 miles to kilometers\n8.04672\nDessutom kan aritmetiska operationer utföras mellan avståndsobjekten:
\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\nTvå Distance-objekt multiplicerade med varandra ger ett Area-objekt, som använder kvadrerade måttenheter:
>>> a = d1 * d2 # Returns an Area object.\n>>> print(a)\n40.2336 sq_km\nFör att bestämma vad attributförkortningen för en enhet är, kan klassmetoden unit_attname användas:
>>> print(Distance.unit_attname("US Survey Foot"))\nsurvey_ft\n>>> print(Distance.unit_attname("centimeter"))\ncm\nEnhet Attribut | \nFullständigt namn eller alias | \n
|---|---|
| \nKilometer, Kilometer | \n
| \nMiles | \n
| \nMeter, Meter | \n
| \nGård | \n
| \nFoot, Foot (Internationell) | \n
| \nU.S. fot, amerikansk undersökning fot | \n
| \nTum | \n
| \nCentimeter | \n
| \nMillimeter, Millimeter | \n
| \nMikrometer, mikrometer | \n
”brittisk_ft | \nBrittisk fot (Sears 1922) | \n
”brittisk_yd | \nBrittiskt varv (Sears 1922) | \n
”Brittisk kedja | \nBrittisk kedja (Sears 1922) | \n
| \nIndian yard, Yard (Indian) | \n
| \nYard (Sears) | \n
| \nClarkes fot | \n
| \nIndustri | \n
| \nKedja (Benoit) | \n
| \nKedja (Sears) | \n
”brittisk kedja” (british_chain_benoit) | \nBrittisk kedja (Benoit 1895 B) | \n
| \nBrittisk kedja (Sears 1922 avkortad) | \n
”guldkust | \nGold Coast fot | \n
| \nLänk | \n
| \nLänk (Benoit) | \n
| \nLänk (Sears) | \n
| \nClarkes länk | \n
| \nFathom | \n
| \nStång | \n
| \nFurlong, Furrow Long | \n
| \nNautisk mil | \n
| \nNautisk mil (Storbritannien) | \n
| \nTysk juridisk meter | \n
Förutom enheter med prefixet sq_ stöds även följande enheter på Area:
Enhet Attribut | \nFullständigt namn eller alias | \n
|---|---|
| \nHectare | \n
AvståndLink to this heading#För att initiera ett avståndsobjekt skickar du in ett nyckelord som motsvarar det önskade enhetens attributnamn med önskat värde. Exempelvis skapar följande ett avståndsobjekt som representerar 5 miles:
\n>>> dist = Distance(mi=5)\nReturnerar avståndsvärdet i enheter som motsvarar det angivna enhetsattributet. Till exempel:
\n>>> print(dist.km)\n8.04672\nReturnerar attributnamnet för avståndsenheten för det angivna fullständiga enhetsnamnet. Till exempel:
\n>>> Distance.unit_attname("Mile")\n'mi'\nAlias för klassen Distance.
AreaLink to this heading#För att initiera ett områdesobjekt skickar du in ett nyckelord som motsvarar önskad enhet attributnamn med önskat värde. Följande skapar till exempel ett områdesobjekt som representerar 5 kvadratmil:
\n>>> a = Area(sq_mi=5)\nReturnerar områdets värde i enheter som motsvarar det angivna enhetsattributet. Till exempel:
\n>>> print(a.sq_km)\n12.949940551680001\nReturnerar attributnamnet för områdesenheten för det angivna fullständiga enhetsnamnet. Till exempel:
\n>>> Area.unit_attname("Kilometer")\n'sq_km'\nAlias för klassen Area.
Fotnoter
\n\n