Le module django.contrib.gis.measure contient des objets qui permettent une représentation pratique des unités de mesure de distance et d’aire. [1] Spécifiquement, il implémente deux objets, Distance et Area qui sont aussi accessibles par les alias simplifiés D et A, respectivement.
Les objets Distance peuvent être créés en utilisant un paramètre nommé indiquant le contexte des unités. Dans l’exemple ci-dessous, deux objets distances différents sont créés dans les unités kilomètre (km) et miles (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\nPour les conversions, accédez à l’attribut correspondant à l’unité souhaitée pour obtenir la mesure convertie de la distance :
\n>>> print(d1.mi) # Converting 5 kilometers to miles\n3.10685596119\n>>> print(d2.km) # Converting 5 miles to kilometers\n8.04672\nDe plus, des opérations arithmétiques peuvent être effectuées entre des objets de distance :
\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\nDeux objets Distance multipliés ensemble génèrent un objet Area qui utilise une unité de mesure au carré :
>>> a = d1 * d2 # Returns an Area object.\n>>> print(a)\n40.2336 sq_km\nPour savoir quel est l’attribut abrégé de l’unité, il est possible d’utiliser la méthode de classe unit_attname:
>>> print(Distance.unit_attname("US Survey Foot"))\nsurvey_ft\n>>> print(Distance.unit_attname("centimeter"))\ncm\nAttribut d’unité | \nNom complet ou alias | \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 (sillon), Furrow Long | \n
| \nNautical Mile | \n
| \nNautical Mile (UK) | \n
| \nGerman legal metre | \n
En plus de l’unité avec le préfixe sq_, les unités suivantes sont également prises en charge par Area:
Attribut d’unité | \nNom complet ou alias | \n
|---|---|
| \nHectare | \n
DistanceLien vers cette rubrique#Pour initialiser un objet distance, passez-lui un paramètre nommé correspondant au nom d’attribut de l’unité souhaitée et contenant la valeur souhaitée. L’exemple suivant crée un objet distance représentant 5 miles :
\n>>> dist = Distance(mi=5)\nRenvoie la mesure de distance en unité correspondante à l’attribut d’unité indiqué. Par exemple :
\n>>> print(dist.km)\n8.04672\nRenvoie le nom d’attribut d’unité de distance correspondant au nom complet d’unité indiqué. Par exemple :
\n>>> Distance.unit_attname("Mile")\n'mi'\nAlias de la classe Distance.
AreaLien vers cette rubrique#Pour initialiser un objet aire, passez-lui un paramètre nommé correspondant au nom d’attribut de l’unité souhaitée et contenant la valeur souhaitée. L’exemple suivant crée un objet aire représentant 5 miles carrés :
\n>>> a = Area(sq_mi=5)\nRenvoie la mesure d’aire en unité correspondante à l’attribut d’unité indiqué. Par exemple :
\n>>> print(a.sq_km)\n12.949940551680001\nRenvoie le nom d’attribut d’unité d’aire correspondant au nom complet d’unité indiqué. Par exemple :
\n>>> Area.unit_attname("Kilometer")\n'sq_km'\nAlias de la classe Area.
Notes de bas de page
\n\n