The spatial lookups in this section are available for GeometryField.
Pour une vue générale, consultez l”introduction sur les recherches spatiales. Pour un aperçu sur la compatibilité des diverses requêtes en fonction du moteur spatial utilisé, référez-vous au tableau de compatibilité des recherches spatiales.
\nbbcontainsLien vers cette rubrique#Disponibilité : PostGIS, MySQL, SpatiaLite
\nTeste si le rectangle englobant du champ géométrique contient complètement le rectangle englobant de la recherche géométrique.
\nExemple :
\nZipcode.objects.filter(poly__bbcontains=geom)\nMoteur | \nÉquivalent SQL | \n
|---|---|
PostGIS | \n
| \n
MySQL | \n
| \n
SpatiaLite | \n
| \n
bboverlapsLien vers cette rubrique#Disponibilité : PostGIS, MySQL, SpatiaLite
\nTeste si le rectangle englobant du champ géométrique recouvre partiellement le rectangle englobant de la recherche géométrique.
\nExemple :
\nZipcode.objects.filter(poly__bboverlaps=geom)\nMoteur | \nÉquivalent SQL | \n
|---|---|
PostGIS | \n
| \n
MySQL | \n
| \n
SpatiaLite | \n
| \n
containedLien vers cette rubrique#Disponibilité : PostGIS, MySQL, SpatiaLite
\nTeste si le rectangle englobant du champ géométrique est complètement contenu dans le rectangle englobant de la recherche géométrique.
\nExemple :
\nZipcode.objects.filter(poly__contained=geom)\nMoteur | \nÉquivalent SQL | \n
|---|---|
PostGIS | \n
| \n
MySQL | \n
| \n
SpatiaLite | \n
| \n
containsLien vers cette rubrique#Disponibilité : PostGIS, Oracle, MySQL, SpatiaLite
\nTeste si le champ géométrique contient spatialement l’objet géométrique de la recherche.
\nExemple :
\nZipcode.objects.filter(poly__contains=geom)\nMoteur | \nÉquivalent SQL | \n
|---|---|
PostGIS | \n
| \n
Oracle | \n
| \n
MySQL | \n
| \n
SpatiaLite | \n
| \n
contains_properlyLien vers cette rubrique#Disponibilité : PostGIS
\nRenvoie True si l’objet géométrique de la recherche a une intersection avec l’intérieur du champ géométrique, mais pas avec ses limites (ou extérieur). [4]
Exemple :
\nZipcode.objects.filter(poly__contains_properly=geom)\nMoteur | \nÉquivalent SQL | \n
|---|---|
PostGIS | \n
| \n
coveredbyLien vers cette rubrique#Disponibilité : PostGIS, Oracle
\nTeste si aucun point du champ géométrique n’est en dehors de l’objet géométrique de la recherche. [3]
\nExemple :
\nZipcode.objects.filter(poly__coveredby=geom)\nMoteur | \nÉquivalent SQL | \n
|---|---|
PostGIS | \n
| \n
Oracle | \n
| \n
coversLien vers cette rubrique#Disponibilité : PostGIS, Oracle
\nTeste si aucun point de l’objet géométrique de la recherche n’est en dehors du champ géométrique. [3]
\nExemple :
\nZipcode.objects.filter(poly__covers=geom)\nMoteur | \nÉquivalent SQL | \n
|---|---|
PostGIS | \n
| \n
Oracle | \n
| \n
crossesLien vers cette rubrique#Disponibilité : PostGIS, SpatiaLite
\nTeste si le champ géométrique se croise spatialement avec l’objet géométrique de la recherche.
\nExemple :
\nZipcode.objects.filter(poly__crosses=geom)\nMoteur | \nÉquivalent SQL | \n
|---|---|
PostGIS | \n
| \n
SpatiaLite | \n
| \n
disjointLien vers cette rubrique#Disponibilité : PostGIS, Oracle, MySQL, SpatiaLite
\nTeste si le champ géométrique est spatialement distinct de l’objet géométrique de la recherche.
\nExemple :
\nZipcode.objects.filter(poly__disjoint=geom)\nMoteur | \nÉquivalent SQL | \n
|---|---|
PostGIS | \n
| \n
Oracle | \n
| \n
MySQL | \n
| \n
SpatiaLite | \n
| \n
equalsLien vers cette rubrique#Disponibilité : PostGIS, Oracle, MySQL, SpatiaLite
\nexact, same_asLien vers cette rubrique#Disponibilité : PostGIS, Oracle, MySQL, SpatiaLite
\nintersectsLien vers cette rubrique#Disponibilité : PostGIS, Oracle, MySQL, SpatiaLite
\nTeste si le champ géométrique possède une intersection spatiale avec l’objet géométrique de la recherche.
\nExemple :
\nZipcode.objects.filter(poly__intersects=geom)\nMoteur | \nÉquivalent SQL | \n
|---|---|
PostGIS | \n
| \n
Oracle | \n
| \n
MySQL | \n
| \n
SpatiaLite | \n
| \n
overlapsLien vers cette rubrique#Disponibilité : PostGIS, Oracle, MySQL, SpatiaLite
\nrelateLien vers cette rubrique#Disponibilité : PostGIS, Oracle, SpatiaLite
\nTeste si le champ géométrique possède une liaison spatiale avec l’objet géométrique de la recherche en fonction des valeurs indiquées dans le motif donné. Cette recherche nécessite un paramètre sous forme de tuple (géom, motif); la forme de motif dépend du moteur spatial :
Pour ces moteurs spatiaux, le motif d’intersection est une chaîne de neuf caractères qui définissent les intersections entre l’intérieur, les limites et l’extérieur du champ géométrique et de l’objet géométrique de la recherche. La matrice d’intersection ne peut utiliser que les caractères suivants : 1, 2, T, F ou *. Ce type de recherche permet d’affiner une relation géométrique spécifique en cohérence avec le modèle DE-9IM. [1]
Exemple :
\n# A tuple lookup parameter is used to specify the geometry and\n# the intersection pattern (the pattern here is for 'contains').\nZipcode.objects.filter(poly__relate=(geom, 'T*T***FF*'))\nÉquivalent SQL PostGIS :
\nSELECT ... WHERE ST_Relate(poly, geom, 'T*T***FF*')\nÉquivalent SQL SpatiaLite :
\nSELECT ... WHERE Relate(poly, geom, 'T*T***FF*')\nHere the relation pattern is comprised of at least one of the nine relation\nstrings: TOUCH, OVERLAPBDYDISJOINT, OVERLAPBDYINTERSECT,\nEQUAL, INSIDE, COVEREDBY, CONTAINS, COVERS, ON, and\nANYINTERACT. Multiple strings may be combined with the logical Boolean\noperator OR, for example, 'inside+touch'. [2] The relation\nstrings are case-insensitive.
Exemple :
\nZipcode.objects.filter(poly__relate=(geom, 'anyinteract'))\nÉquivalent SQL Oracle :
\nSELECT ... WHERE SDO_RELATE(poly, geom, 'anyinteract')\ntouchesLien vers cette rubrique#Disponibilité : PostGIS, Oracle, MySQL, SpatiaLite
\nTeste si le champ géométrique touche spatialement l’objet géométrique de la recherche.
\nExemple :
\nZipcode.objects.filter(poly__touches=geom)\nMoteur | \nÉquivalent SQL | \n
|---|---|
PostGIS | \n
| \n
MySQL | \n
| \n
Oracle | \n
| \n
SpatiaLite | \n
| \n
withinLien vers cette rubrique#Disponibilité : PostGIS, Oracle, MySQL, SpatiaLite
\nTeste si le champ géométrique est spatialement à l’intérieur de l’objet géométrique de la recherche.
\nExemple :
\nZipcode.objects.filter(poly__within=geom)\nMoteur | \nÉquivalent SQL | \n
|---|---|
PostGIS | \n
| \n
MySQL | \n
| \n
Oracle | \n
| \n
SpatiaLite | \n
| \n
leftLien vers cette rubrique#Disponibilité : PostGIS
\nTeste si le rectangle englobant du champ géométrique est strictement à gauche du rectangle englobant de la recherche géométrique.
\nExemple :
\nZipcode.objects.filter(poly__left=geom)\nÉquivalent PostGIS :
\nSELECT ... WHERE poly << geom\nrightLien vers cette rubrique#Disponibilité : PostGIS
\nTeste si le rectangle englobant du champ géométrique est strictement à droite du rectangle englobant de la recherche géométrique.
\nExemple :
\nZipcode.objects.filter(poly__right=geom)\nÉquivalent PostGIS :
\nSELECT ... WHERE poly >> geom\noverlaps_leftLien vers cette rubrique#Disponibilité : PostGIS
\nTeste si le rectangle englobant du champ géométrique recouvre ou est à gauche du rectangle englobant de la recherche géométrique.
\nExemple :
\nZipcode.objects.filter(poly__overlaps_left=geom)\nÉquivalent PostGIS :
\nSELECT ... WHERE poly &< geom\noverlaps_rightLien vers cette rubrique#Disponibilité : PostGIS
\nTeste si le rectangle englobant du champ géométrique recouvre ou est à droite du rectangle englobant de la recherche géométrique.
\nExemple :
\nZipcode.objects.filter(poly__overlaps_right=geom)\nÉquivalent PostGIS :
\nSELECT ... WHERE poly &> geom\noverlaps_aboveLien vers cette rubrique#Disponibilité : PostGIS
\nTeste si le rectangle englobant du champ géométrique recouvre ou est au-dessus du rectangle englobant de la recherche géométrique.
\nExemple :
\nZipcode.objects.filter(poly__overlaps_above=geom)\nÉquivalent PostGIS :
\nSELECT ... WHERE poly |&> geom\noverlaps_belowLien vers cette rubrique#Disponibilité : PostGIS
\nTeste si le rectangle englobant du champ géométrique recouvre ou est au-dessous du rectangle englobant de la recherche géométrique.
\nExemple :
\nZipcode.objects.filter(poly__overlaps_below=geom)\nÉquivalent PostGIS :
\nSELECT ... WHERE poly &<| geom\nstrictly_aboveLien vers cette rubrique#Disponibilité : PostGIS
\nTeste si le rectangle englobant du champ géométrique est strictement au-dessus du rectangle englobant de la recherche géométrique.
\nExemple :
\nZipcode.objects.filter(poly__strictly_above=geom)\nÉquivalent PostGIS :
\nSELECT ... WHERE poly |>> geom\nstrictly_belowLien vers cette rubrique#Disponibilité : PostGIS
\nTeste si le rectangle englobant du champ géométrique est strictement au-dessous du rectangle englobant de la recherche géométrique.
\nExemple :
\nZipcode.objects.filter(poly__strictly_below=geom)\nÉquivalent PostGIS :
\nSELECT ... WHERE poly <<| geom\nDisponibilité : PostGIS, Oracle, SpatiaLite
\nPour un aperçu sur la construction de requêtes de distance, référez-vous à l”introduction sur les requêtes de distance.
\nLes requêtes de distance se font sous la forme suivante :
\n<field>__<distance lookup>=(<geometry>, <distance value>[, 'spheroid'])\nLa valeur transmise à une requête de distance est un tuple ; les deux premières valeurs sont obligatoires et représentent respectivement l’objet géométrique vers lequel la distance doit être calculée et la valeur de distance (soit en nombre dans l’unité du champ ou un objet Distance). Pour toutes les recherches de distance à l’exception de dwithin, une troisième valeur facultative, 'spheroid', peut être ajoutée pour dire à GeoDjango d’utiliser les fonctions de calcul de distance sphéroïde pour les champs ayant un système de coordonnées géodétique (par ex. ST_Distance_Spheroid serait utilisé à la place de ST_Distance_Sphere ). Dans le cas d’un système de coordonnées projeté, c’est la fonction plus simple ST_Distance qui sera utilisée.
distance_gtLien vers cette rubrique#Renvoie les objets pour lesquels la distance entre le champ géométrique et l’objet géométrique de recherche est plus grande que la valeur de distance donnée.
\nExemple :
\nZipcode.objects.filter(poly__distance_gt=(geom, D(m=5)))\nMoteur | \nÉquivalent SQL | \n
|---|---|
PostGIS | \n
| \n
Oracle | \n
| \n
SpatiaLite | \n
| \n
distance_gteLien vers cette rubrique#Renvoie les objets pour lesquels la distance entre le champ géométrique et l’objet géométrique de recherche est plus grande ou égale à la valeur de distance donnée.
\nExemple :
\nZipcode.objects.filter(poly__distance_gte=(geom, D(m=5)))\nMoteur | \nÉquivalent SQL | \n
|---|---|
PostGIS | \n
| \n
Oracle | \n
| \n
SpatiaLite | \n
| \n
distance_ltLien vers cette rubrique#Renvoie les objets pour lesquels la distance entre le champ géométrique et l’objet géométrique de recherche est plus petite que la valeur de distance donnée.
\nExemple :
\nZipcode.objects.filter(poly__distance_lt=(geom, D(m=5)))\nMoteur | \nÉquivalent SQL | \n
|---|---|
PostGIS | \n
| \n
Oracle | \n
| \n
SpatiaLite | \n
| \n
distance_lteLien vers cette rubrique#Renvoie les objets pour lesquels la distance entre le champ géométrique et l’objet géométrique de recherche est plus petite ou égale à la valeur de distance donnée.
\nExemple :
\nZipcode.objects.filter(poly__distance_lte=(geom, D(m=5)))\nMoteur | \nÉquivalent SQL | \n
|---|---|
PostGIS | \n
| \n
Oracle | \n
| \n
SpatiaLite | \n
| \n
dwithinLien vers cette rubrique#Renvoie les objets pour lesquels la distance entre le champ géométrique et l’objet géométrique de recherche ne dépasse pas la valeur de distance donnée. Notez que vous ne pouvez fournir des objets Distance que si les objets géométriques concernés sont dans un système de coordonnées projeté. Pour des objets géométriques de type géographique, il faut utiliser l’unité du champ géométrique (par exemple des degrés pour WGS84).
Exemple :
\nZipcode.objects.filter(poly__dwithin=(geom, D(m=5)))\nMoteur | \nÉquivalent SQL | \n
|---|---|
PostGIS | \n
| \n
Oracle | \n
| \n
GeoQuerySetLien vers cette rubrique#Les méthodes de GeoQuerySet appliquent une opération spatiale sur chaque champ géographique du jeu de requête et stockent le résultat dans un nouvel attribut du modèle (qui correspond généralement au nom de la méthode GeoQuerySet).
Il existe également des méthodes GeoQuerySet d’agrégation qui renvoient une valeur unique au lieu d’un jeu de requête. Cette section documente l’API et la disponibilité de chaque méthode de GeoQuerySet dans GeoDjango.
À quelques exceptions près, les paramètres nommés suivants peuvent être utilisés avec toutes les méthodes de GeoQuerySet:
Paramètre nommé | \nDescription | \n
|---|---|
| \nPar défaut, les méthodes de Avec PostGIS, le paramètre | \n
| \nPar défaut, les méthodes de Ce paramètre est obligatoire quand un nom de modèle entre en conflit avec une méthode | \n
Disponibilité : PostGIS, Oracle, SpatiaLite
\nareaLien vers cette rubrique#Écrit l’aire du champ géométrique dans un attribut area de chaque élément du GeoQuerySet.
distanceLien vers cette rubrique#Cette méthode accepte un objet géométrique en paramètre et ajoute un attribut distance à chaque modèle du jeu de requête, attribut contenant la distance entre le champ concerné du modèle et l’objet géométrique donné (sous forme d’objet Distance).
Dans l’exemple suivant (tiré des tests de distance de GeoDjango), on calcule la distance entre la ville tasmanienne de Hobart vers tous les autres champs PointField du jeu de requête AustraliaCity:
>>> pnt = AustraliaCity.objects.get(name='Hobart').point\n>>> for city in AustraliaCity.objects.distance(pnt): print(city.name, city.distance)\nWollongong 990071.220408 m\nShellharbour 972804.613941 m\nThirroul 1002334.36351 m\nMittagong 975691.632637 m\nBatemans Bay 834342.185561 m\nCanberra 598140.268959 m\nMelbourne 575337.765042 m\nSydney 1056978.87363 m\nHobart 0.0 m\nAdelaide 1162031.83522 m\nHillsdale 1049200.46122 m\nlengthLien vers cette rubrique#Écrit la longueur du champ géométrique dans un attribut length de chaque élément du jeu de requête (un objet Distance).
perimeterLien vers cette rubrique#Écrit le périmètre du champ géométrique dans un attribut perimeter de chaque élément du jeu de requête (un objet Distance).
Les méthodes suivantes ne demandent aucun paramètre et ajoutent un objet géométrique à chaque élément du jeu de requête GeoQuerySet , objet qui est le résultat d’une fonction de relation évaluée sur le champ géométrique.
centroidLien vers cette rubrique#Disponibilité : PostGIS, Oracle, SpatiaLite
\nÉcrit la valeur de centroïde du champ géométrique dans un attribut centroid de chaque élément du GeoQuerySet.
envelopeLien vers cette rubrique#Disponibilité : PostGIS, SpatiaLite
\nÉcrit un objet géométrique représentant le rectangle englobant du champ géométrique dans un attribut envelope de chaque élément du GeoQuerySet.
point_on_surfaceLien vers cette rubrique#Disponibilité : PostGIS, Oracle, SpatiaLite
\nÉcrit un objet géométrique Point se trouvant de manière certaine dans la surface du champ géométrique dans un attribut point_on_surface de chaque élément du jeu de requête.
force_rhrLien vers cette rubrique#Disponibilité : PostGIS
\nCalcule une version modifiée du (multi)polygone pour lequel toutes les arêtes suivent la « règle de la main droite » et place cet objet dans un attribut force_rhr pour chaque élément du jeu de requête.
reverse_geomLien vers cette rubrique#Disponibilité : PostGIS, Oracle
\nInverse l’ordre des coordonnées du champ géométrique et place l’objet résultant dans un attribut reverse pour chaque élément du jeu de requête.
scaleLien vers cette rubrique#Disponibilité : PostGIS, SpatiaLite
\nsnap_to_gridLien vers cette rubrique#Fait glisser tous les points du champ géométrique selon une grille. La manière d’ajuster l’objet géométrique à la grille dépend du nombre de paramètres numériques fournis (des nombres à virgule, entiers ou entiers longs).
\nNombre de paramètres | \nDescription | \n
|---|---|
1 | \nUne seule taille de cellule de grille (à la fois pour la taille X et Y). | \n
2 | \nTailles X et Y de cellule de grille. | \n
4 | \nTailles de cellule X et Y ainsi que coordonnées X et Y de l’origine de la grille. | \n
transformLien vers cette rubrique#Disponibilité : PostGIS, Oracle, SpatiaLite
\nLa méthode transform transforme le champ géométrique d’un modèle dans le système de référence spatiale indiqué par le paramètre srid. Si ce paramètre est absent, c’est le SRID 4326 (WGS84) qui est utilisé par défaut.
Exemple :
\n>>> qs = Zipcode.objects.all().transform() # Transforms to WGS84\n>>> qs = Zipcode.objects.all().transform(32140) # Transforming to "NAD83 / Texas South Central"\n>>> print(qs[0].poly.srid)\n32140\n>>> print(qs[0].poly)\nPOLYGON ((234055.1698884720099159 4937796.9232223574072123 ...\ntranslateLien vers cette rubrique#Disponibilité : PostGIS, SpatiaLite
\nEffectue une translation du champ géométrique vers un nouvel emplacement en utilisant les paramètres numériques donnés comme vecteurs.
\nDisponibilité : PostGIS, Oracle, SpatiaLite
\nLes méthodes suivantes demandent toutes un objet géométrique en paramètre et ajoutent un objet géométrique à chaque élément du jeu de requête GeoQuerySet résultant de l’opération.
differenceLien vers cette rubrique#Effectue la différence spatiale entre le champ géométrique et l’objet géométrique donné et écrit le résultat dans un attribut difference de chaque élément du GeoQuerySet.
intersectionLien vers cette rubrique#Effectue l’intersection spatiale entre le champ géométrique et l’objet géométrique donné et écrit le résultat dans un attribut intersection de chaque élément du GeoQuerySet.
sym_differenceLien vers cette rubrique#Effectue la différence symétrique entre le champ géométrique et l’objet géométrique donné et écrit le résultat dans un attribut sym_difference de chaque élément du GeoQuerySet.
unionLien vers cette rubrique#Effectue l’union du champ géométrique avec l’objet géométrique donné et écrit le résultat dans un attribut union de chaque élément du GeoQuerySet.
Les méthodes GeoQuerySet suivantes créent pour chaque modèle un nouvel attribut contenant la valeur du champ géométrique converti dans le format de sortie demandé.
geohashLien vers cette rubrique#Ajoute pour chaque modèle du jeu de requête un attribut geohash contenant la représentation GeoHash du champ géométrique.
geojsonLien vers cette rubrique#Disponibilité : PostGIS, SpatiaLite
\nAjoute pour chaque modèle du jeu de requête un attribut geojson contenant la représentation GeoJSON du champ géométrique.
Paramètre nommé | \nDescription | \n
|---|---|
| \nPeut être utilisé pour indiquer le nombre de chiffres significatifs des coordonnées de la représentation GeoJSON, la valeur par défaut étant 8. | \n
| \nÀ définir à | \n
| \nÀ définir à | \n
gmlLien vers cette rubrique#Disponibilité : PostGIS, Oracle, SpatiaLite
\nAjoute pour chaque modèle du jeu de requête un attribut gml contenant la représentation Geographic Markup Language (GML) du champ géométrique.
Exemple :
\n>>> qs = Zipcode.objects.all().gml()\n>>> print(qs[0].gml)\n<gml:Polygon srsName="EPSG:4326"><gml:OuterBoundaryIs>-147.78711,70.245363 ... -147.78711,70.245363</gml:OuterBoundaryIs></gml:Polygon>\nParamètre nommé | \nDescription | \n
|---|---|
| \nCe paramètre n’est valable que pour PostGIS. Il peut être utilisé pour indiquer le nombre de chiffres significatifs des coordonnées de la représentation GML, la valeur par défaut étant 8. | \n
| \nCe paramètre n’est valable que pour PostGIS. Il peut être utilisé pour indiquer la version GML utilisée (2 ou 3). La valeur par défaut est 2. | \n
kmlLien vers cette rubrique#Disponibilité : PostGIS, SpatiaLite
\nAjoute pour chaque modèle du jeu de requête un attribut kml contenant la représentation Keyhole Markup Language (KML) du champ géométrique. Il faut relever que le contenu KML est transformé en WGS84 si nécessaire.
Exemple :
\n>>> qs = Zipcode.objects.all().kml()\n>>> print(qs[0].kml)\n<Polygon><outerBoundaryIs><LinearRing><coordinates>-103.04135,36.217596,0 ... -103.04135,36.217596,0</coordinates></LinearRing></outerBoundaryIs></Polygon>\nParamètre nommé | \nDescription | \n
|---|---|
| \nCe paramètre peut être utilisé pour indiquer le nombre de chiffres significatifs des coordonnées de la représentation KML, la valeur par défaut étant 8. | \n
svgLien vers cette rubrique#Disponibilité : PostGIS, SpatiaLite
\nAjoute pour chaque modèle du jeu de requête un attribut svg contenant les données de chemin Scalable Vector Graphics (SVG) du champ géométrique.
Paramètre nommé | \nDescription | \n
|---|---|
| \nSi défini à | \n
| \nCe paramètre peut être utilisé pour indiquer le nombre de chiffres significatifs des coordonnées de la représentation SVG, la valeur par défaut étant 8. | \n
![Lien vers cette définition#](\"#django.contrib.gis.db.models.GeoQuerySet.svg\"){kind=link}
mem_sizeLien vers cette rubrique#Disponibilité : PostGIS
\nCalcule la taille mémoire (nombre d’octets) consommée par le champ géométrique et écrit le résultat dans un attribut mem_size de chaque élément du GeoQuerySet.
num_geomLien vers cette rubrique#Disponibilité : PostGIS, Oracle, SpatiaLite
\nÉcrit le nombre d’éléments géométriques dans un attribut num_geom de chaque élément du GeoQuerySet, pour autant que le champ géométrique soit une collection (par ex. un champ GEOMETRYCOLLECTION ou MULTI*) ; sinon, l’attribut contiendra None.
num_pointsLien vers cette rubrique#Disponibilité : PostGIS, Oracle, SpatiaLite
\nCalcule le nombre de points du premier élément ligne (linestring) du champ géométrique et écrit le résultat dans un attribut num_points de chaque élément du GeoQuerySet. L’attribut contiendra None s’il n’y a pas de ligne.
collectLien vers cette rubrique#Raccourci pour aggregate(Collect(<champ>)).
extentLien vers cette rubrique#Raccourci pour aggregate(Extent(<champ>)).
extent3dLien vers cette rubrique#Raccourci pour aggregate(Extent3D(<champ>)).
make_lineLien vers cette rubrique#Raccourci pour aggregate(MakeLine(<champ>)).
unionaggLien vers cette rubrique#Raccourci pour aggregate(Union(<champ>)).
Django fournit quelques fonctions d’agrégation spécifiques aux données géographiques. Pour plus de détails sur l’usage de ces fonctions, consultez le guide thématique sur l’agrégation.
\nParamètre nommé | \nDescription | \n
|---|---|
| \nCe paramètre n’est valable que pour Oracle. Il s’agit de la valeur de tolérance utilisée par la procédure | \n
Exemple :
\n>>> from django.contrib.gis.db.models import Extent, Union\n>>> WorldBorder.objects.aggregate(Extent('mpoly'), Union('mpoly'))\nCollectLien vers cette rubrique#Disponibilité : PostGIS, SpatiaLite (≥3.0)
\nRenvoie un objet géométrique GEOMETRYCOLLECTION ou MULTI à partir de la colonne géométrique. C’est un peu comme une version simplifiée de l’agrégation Union, sauf qu’elle peut être vraiment plus rapide qu’une union car elle ne fait qu’accumuler les objets géométriques dans une collection ou une géométrie multiple sans se préoccuper de fusionner les objets.
ExtentLien vers cette rubrique#Disponibilité : PostGIS, Oracle, SpatiaLite (≥3.0)
\nRenvoie l’étendue de tous les champs geo_field du QuerySet sous forme de tuple à 4 éléments formé des coordonnées inférieure gauche et supérieure droite.
Exemple :
\n>>> qs = City.objects.filter(name__in=('Houston', 'Dallas')).aggregate(Extent('poly'))\n>>> print(qs['poly__extent'])\n(-96.8016128540039, 29.7633724212646, -95.3631439208984, 32.782058715820)\nExtent3DLien vers cette rubrique#Disponibilité : PostGIS
\nRenvoie l’étendue 3D de tous les champs geo_field du QuerySet sous forme de tuple à 6 éléments formé des coordonnées inférieure gauche et supérieure droite (chaque fois avec les coordonnées x, y et z).
Exemple :
\n>>> qs = City.objects.filter(name__in=('Houston', 'Dallas')).aggregate(Extent3D('poly'))\n>>> print(qs['poly__extent3d'])\n(-96.8016128540039, 29.7633724212646, 0, -95.3631439208984, 32.782058715820, 0)\nMakeLineLien vers cette rubrique#Disponibilité : PostGIS
\nRenvoie une ligne LineString construite à partir des champs de type point du QuerySet. Actuellement, le tri du jeu de requête n’a pas d’effet.
Exemple :
\n>>> print(City.objects.filter(name__in=('Houston', 'Dallas')\n... ).aggregate(MakeLine('poly'))['poly__makeline']\nLINESTRING (-95.3631510000000020 29.7633739999999989, -96.8016109999999941 32.7820570000000018)\nUnionLien vers cette rubrique#Disponibilité : PostGIS, Oracle, SpatiaLite
\nCette méthode renvoie un objet GEOSGeometry formé de l’union de tous les objets géométriques du jeu de requête. Sachez que l’emploi de Union est très consommateur de ressources et peut prendre un temps considérable pour de gros jeux de requête.
Exemple :
\n>>> u = Zipcode.objects.aggregate(Union(poly)) # This may take a long time.\n>>> u = Zipcode.objects.filter(poly__within=bbox).aggregate(Union(poly)) # A more sensible approach.\nNotes de bas de page
\n\n