{"title":"Référence des API QuerySet GIS","version":"3.0","locale":"fr","docname":"ref/contrib/gis/geoquerysets","url":"/fr/3.0/ref/contrib/gis/geoquerysets/","canonical":"https://djangodocs.dev/fr/3.0/ref/contrib/gis/geoquerysets/","summary":"Recherches spatiales Lien vers cette rubrique # Les requêtes spatiales de cette section sont disponibles à la fois pour GeometryField et RasterField . Pour une vue…","html":"

Référence des API QuerySet GISLien vers cette rubrique#

\n
\n

Recherches spatialesLien vers cette rubrique#

\n

Les requêtes spatiales de cette section sont disponibles à la fois pour GeometryField et RasterField.

\n

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.

\n
\n

Requêtes avec matricesLien vers cette rubrique#

\n

Tous les exemples dans la référence ci-dessous sont donnés pour des champs et des entrées géométriques, mais ces requêtes peuvent très bien être utilisées avec des objets matriciels des deux côtés. Chaque fois qu’une requête ne prend pas en charge les entrées matricielles, l’entrée est automatiquement convertie en objet géométrique quand c’est nécessaire en utilisant la fonction ST_Polygon. Voir aussi l’introduction aux requêtes matricielles.

\n

Les opérateurs de base de données utilisés par les requêtes peuvent être divisés en trois catégories :

\n\n

Les exemples ci-dessous montrent le code SQL équivalent pour les requêtes dans les différents types de prise en charge matricielle. Le même schéma s’applique pour toutes les requêtes spatiales.

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Cas

Requête

Équivalent SQL

N, B

rast__contains=rst

ST_Contains(rast, rst)

N, B

rast__1__contains=(rst, 2)

ST_Contains(rast, 1, rst, 2)

B, C

rast__contains=geom

ST_Contains(ST_Polygon(rast), geom)

B, C

rast__1__contains=geom

ST_Contains(ST_Polygon(rast, 1), geom)

B, C

poly__contains=rst

ST_Contains(poly, ST_Polygon(rst))

B, C

poly__contains=(rst, 1)

ST_Contains(poly, ST_Polygon(rst, 1))

C

rast__crosses=rst

ST_Crosses(ST_Polygon(rast), ST_Polygon(rst))

C

rast__1__crosses=(rst, 2)

ST_Crosses(ST_Polygon(rast, 1), ST_Polygon(rst, 2))

C

rast__crosses=geom

ST_Crosses(ST_Polygon(rast), geom)

C

poly__crosses=rst

ST_Crosses(poly, ST_Polygon(rst))

\n
\n

Les requêtes spatiales avec des objets matriciels ne sont prises en charge que pour le moteur PostGIS (désigné par PGRaster dans cette section).

\n
\n
\n

bbcontainsLien vers cette rubrique#

\n

Disponibilité : PostGIS, MariaDB, MySQL, SpatiaLite, PGRaster (natif)

\n

Teste si le rectangle englobant du champ géométrique ou matriciel contient complètement le rectangle englobant de la recherche géométrique.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__bbcontains=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

poly ~ geom

MariaDB

MBRContains(poly, geom)

MySQL

MBRContains(poly, geom)

SpatiaLite

MbrContains(poly, geom)

\n
\n
\n
\n

bboverlapsLien vers cette rubrique#

\n

Disponibilité : PostGIS, MariaDB, MySQL, SpatiaLite, PGRaster (natif)

\n

Teste si le rectangle englobant du champ géométrique recouvre partiellement le rectangle englobant de la recherche géométrique.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__bboverlaps=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

poly && geom

MariaDB

MBROverlaps(poly, geom)

MySQL

MBROverlaps(poly, geom)

SpatiaLite

MbrOverlaps(poly, geom)

\n
\n
\n
\n

containedLien vers cette rubrique#

\n

Disponibilité : PostGIS, MariaDB, MySQL, SpatiaLite, PGRaster (natif)

\n

Teste si le rectangle englobant du champ géométrique est complètement contenu dans le rectangle englobant de la recherche géométrique.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__contained=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

poly @ geom

MariaDB

MBRWithin(poly, geom)

MySQL

MBRWithin(poly, geom)

SpatiaLite

MbrWithin(poly, geom)

\n
\n
\n
\n

containsLien vers cette rubrique#

\n

Disponibilité : PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (bilatéral)

\n

Teste si le champ géométrique contient spatialement l’objet géométrique de la recherche.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__contains=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

ST_Contains(poly, geom)

Oracle

SDO_CONTAINS(poly, geom)

MariaDB

ST_Contains(poly, geom)

MySQL

ST_Contains(poly, geom)

SpatiaLite

Contains(poly, geom)

\n
\n\n
\n
\n

contains_properlyLien vers cette rubrique#

\n

Disponibilité : PostGIS, PGRaster (bilatéral)

\n

Renvoie 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).

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__contains_properly=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

ST_ContainsProperly(poly, geom)

\n
\n
\n
\n

coveredbyLien vers cette rubrique#

\n

Disponibilité: PostGIS, Oracle, PGRaster (bilatéral), SpatiaLite

\n

Teste si aucun point du champ géométrique n’est en dehors de l’objet géométrique de la recherche. [3]

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__coveredby=geom)\n
\n\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

ST_CoveredBy(poly, geom)

Oracle

SDO_COVEREDBY(poly, geom)

SpatiaLite

CoveredBy(poly, geom)

\n
\n
\n
\n

coversLien vers cette rubrique#

\n

Disponibilité: PostGIS, Oracle, PGRaster (bilatéral), SpatiaLite

\n

Teste si aucun point de l’objet géométrique de la recherche n’est en dehors du champ géométrique. [3]

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__covers=geom)\n
\n\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

ST_Covers(poly, geom)

Oracle

SDO_COVERS(poly, geom)

SpatiaLite

Covers(poly, geom)

\n
\n
\n
\n

crossesLien vers cette rubrique#

\n

Disponibilité : PostGIS, MariaDB, MySQL, SpatiaLite, PGRaster (conversion)

\n

Teste si le champ géométrique se croise spatialement avec l’objet géométrique de la recherche.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__crosses=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

ST_Crosses(poly, geom)

MariaDB

ST_Crosses(poly, geom)

MySQL

ST_Crosses(poly, geom)

SpatiaLite

Crosses(poly, geom)

\n
\n\n
\n
\n

disjointLien vers cette rubrique#

\n

Disponibilité : PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (bilatéral)

\n

Teste si le champ géométrique est spatialement distinct de l’objet géométrique de la recherche.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__disjoint=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

ST_Disjoint(poly, geom)

Oracle

SDO_GEOM.RELATE(poly, 'DISJOINT', geom, 0.05)

MariaDB

ST_Disjoint(poly, geom)

MySQL

ST_Disjoint(poly, geom)

SpatiaLite

Disjoint(poly, geom)

\n
\n\n
\n
\n

equalsLien vers cette rubrique#

\n

Disponibilité : PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (conversion)

\n

Teste si le champ géométrique est spatialement égal à l’objet géométrique de la recherche.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__equals=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

ST_Equals(poly, geom)

Oracle

SDO_EQUAL(poly, geom)

MariaDB

ST_Equals(poly, geom)

MySQL

ST_Equals(poly, geom)

SpatiaLite

Equals(poly, geom)

\n
\n\n
\n
\n

exact, same_asLien vers cette rubrique#

\n

Disponibilité : PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (bilatéral)

\n

Teste si le champ géométrique est « égal » à l’objet géométrique donné. Avec Oracle, MySQL et Spatialite, le test se fait sur l’égalité spatiale, alors qu’avec PostGIS, le test compare l’égalité des boîtes englobantes.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

poly ~= geom

Oracle

SDO_EQUAL(poly, geom)

MariaDB

ST_Equals(poly, geom)

MySQL

ST_Equals(poly, geom)

SpatiaLite

Equals(poly, geom)

\n
\n\n
\n
\n

intersectsLien vers cette rubrique#

\n

Disponibilité: PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (bilatéral)

\n

Teste si le champ géométrique possède une intersection spatiale avec l’objet géométrique de la recherche.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__intersects=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

ST_Intersects(poly, geom)

Oracle

SDO_OVERLAPBDYINTERSECT(poly, geom)

MariaDB

ST_Intersects(poly, geom)

MySQL

ST_Intersects(poly, geom)

SpatiaLite

Intersects(poly, geom)

\n
\n\n
\n
\n

isvalidLien vers cette rubrique#

\n

Disponibilité : MySQL (≥ 5.7.5), PostGIS, Oracle, SpatiaLite

\n

Teste si l’objet géométrique est valide.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__isvalid=True)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

MySQL, PostGIS, SpatiaLite

ST_IsValid(poly)

Oracle

SDO_GEOM.VALIDATE_GEOMETRY_WITH_CONTEXT(poly, 0.05) = 'TRUE'

\n
\n
\n
\n

overlapsLien vers cette rubrique#

\n

Disponibilité : PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (bilatéral)

\n

Teste si le champ géométrique chevauche l’objet géométrique de la recherche.

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

ST_Overlaps(poly, geom)

Oracle

SDO_OVERLAPS(poly, geom)

MariaDB

ST_Overlaps(poly, geom)

MySQL

ST_Overlaps(poly, geom)

SpatiaLite

Overlaps(poly, geom)

\n
\n\n
\n
\n

relateLien vers cette rubrique#

\n

Disponibilité : PostGIS, Oracle, SpatiaLite, PGRaster (conversion)

\n

Teste 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 :

\n
\n

PostGIS et SpatiaLiteLien vers cette rubrique#

\n

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]

\n

Exemple géométrique :

\n
Code
# 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
\n

Équivalent SQL PostGIS :

\n
SQL
SELECT ... WHERE ST_Relate(poly, geom, 'T*T***FF*')\n
\n

Équivalent SQL SpatiaLite :

\n
SQL
SELECT ... WHERE Relate(poly, geom, 'T*T***FF*')\n
\n

Exemple matriciel :

\n
Code
Zipcode.objects.filter(poly__relate=(rast, 1, 'T*T***FF*'))\nZipcode.objects.filter(rast__2__relate=(rast, 1, 'T*T***FF*'))\n
\n

Équivalent SQL PostGIS :

\n
SQL
SELECT ... WHERE ST_Relate(poly, ST_Polygon(rast, 1), 'T*T***FF*')\nSELECT ... WHERE ST_Relate(ST_Polygon(rast, 2), ST_Polygon(rast, 1), 'T*T***FF*')\n
\n
\n
\n

OracleLien vers cette rubrique#

\n

Ici, le motif de relation comprend au moins une des neuf chaînes de relation possibles : TOUCH, OVERLAPBDYDISJOINT, OVERLAPBDYINTERSECT, EQUAL, INSIDE, COVEREDBY, CONTAINS, COVERS, ON et ANYINTERACT. Plusieurs chaînes peuvent être combinées par l’opérateur logique booléen OR, par exemple 'inside+touch'. [2] Les chaînes de relation sont insensibles à la casse.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__relate=(geom, 'anyinteract'))\n
\n

Équivalent SQL Oracle :

\n
SQL
SELECT ... WHERE SDO_RELATE(poly, geom, 'anyinteract')\n
\n
\n
\n
\n

touchesLien vers cette rubrique#

\n

Disponibilité : PostGIS, Oracle, MariaDB, MySQL, SpatiaLite

\n

Teste si le champ géométrique touche spatialement l’objet géométrique de la recherche.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__touches=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

ST_Touches(poly, geom)

MariaDB

ST_Touches(poly, geom)

MySQL

ST_Touches(poly, geom)

Oracle

SDO_TOUCH(poly, geom)

SpatiaLite

Touches(poly, geom)

\n
\n\n
\n
\n

withinLien vers cette rubrique#

\n

Disponibilité : PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (bilatéral)

\n

Teste si le champ géométrique est spatialement à l’intérieur de l’objet géométrique de la recherche.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__within=geom)\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

ST_Within(poly, geom)

MariaDB

ST_Within(poly, geom)

MySQL

ST_Within(poly, geom)

Oracle

SDO_INSIDE(poly, geom)

SpatiaLite

Within(poly, geom)

\n
\n\n
\n
\n

leftLien vers cette rubrique#

\n

Disponibilité : PostGIS, PGRaster (conversion)

\n

Teste si le rectangle englobant du champ géométrique est strictement à gauche du rectangle englobant de la recherche géométrique.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__left=geom)\n
\n

Équivalent PostGIS :

\n
SQL
SELECT ... WHERE poly << geom\n
\n
\n
\n

rightLien vers cette rubrique#

\n

Disponibilité : PostGIS, PGRaster (conversion)

\n

Teste si le rectangle englobant du champ géométrique est strictement à droite du rectangle englobant de la recherche géométrique.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__right=geom)\n
\n

Équivalent PostGIS :

\n
SQL
SELECT ... WHERE poly >> geom\n
\n
\n
\n

overlaps_leftLien vers cette rubrique#

\n

Disponibilité : PostGIS, PGRaster (bilatéral)

\n

Teste si le rectangle englobant du champ géométrique recouvre ou est à gauche du rectangle englobant de la recherche géométrique.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__overlaps_left=geom)\n
\n

Équivalent PostGIS :

\n
SQL
SELECT ... WHERE poly &< geom\n
\n
\n
\n

overlaps_rightLien vers cette rubrique#

\n

Disponibilité : PostGIS, PGRaster (bilatéral)

\n

Teste si le rectangle englobant du champ géométrique recouvre ou est à droite du rectangle englobant de la recherche géométrique.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__overlaps_right=geom)\n
\n

Équivalent PostGIS :

\n
SQL
SELECT ... WHERE poly &> geom\n
\n
\n
\n

overlaps_aboveLien vers cette rubrique#

\n

Disponibilité : PostGIS, PGRaster (conversion)

\n

Teste si le rectangle englobant du champ géométrique recouvre ou est au-dessus du rectangle englobant de la recherche géométrique.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__overlaps_above=geom)\n
\n

Équivalent PostGIS :

\n
SQL
SELECT ... WHERE poly |&> geom\n
\n
\n
\n

overlaps_belowLien vers cette rubrique#

\n

Disponibilité : PostGIS, PGRaster (conversion)

\n

Teste si le rectangle englobant du champ géométrique recouvre ou est au-dessous du rectangle englobant de la recherche géométrique.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__overlaps_below=geom)\n
\n

Équivalent PostGIS :

\n
SQL
SELECT ... WHERE poly &<| geom\n
\n
\n
\n

strictly_aboveLien vers cette rubrique#

\n

Disponibilité : PostGIS, PGRaster (conversion)

\n

Teste si le rectangle englobant du champ géométrique est strictement au-dessus du rectangle englobant de la recherche géométrique.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__strictly_above=geom)\n
\n

Équivalent PostGIS :

\n
SQL
SELECT ... WHERE poly |>> geom\n
\n
\n
\n

strictly_belowLien vers cette rubrique#

\n

Disponibilité : PostGIS, PGRaster (conversion)

\n

Teste si le rectangle englobant du champ géométrique est strictement au-dessous du rectangle englobant de la recherche géométrique.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__strictly_below=geom)\n
\n

Équivalent PostGIS :

\n
SQL
SELECT ... WHERE poly <<| geom\n
\n
\n
\n
\n

Recherches de distanceLien vers cette rubrique#

\n

Disponibilité : PostGIS, Oracle, MariaDB, MySQL, SpatiaLite, PGRaster (natif)

\n

Pour un aperçu sur la construction de requêtes de distance, référez-vous à l”introduction sur les requêtes de distance.

\n

Les requêtes de distance se font sous la forme suivante :

\n
Code
<field>__<distance lookup>=(<geometry/raster>, <distance value>[, 'spheroid'])\n<field>__<distance lookup>=(<raster>, <band_index>, <distance value>[, 'spheroid'])\n<field>__<band_index>__<distance lookup>=(<raster>, <band_index>, <distance value>[, 'spheroid'])\n
\n

La 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 un nombre dans l’unité du champ, un objet Distance ou une expression de requête). Pour transmettre un indice de bande à la requête, utilisez un tuple à 3 éléments où le deuxième est l’indice de bande.

\n

Pour toutes les recherches de distance à l’exception de dwithin, une valeur facultative, 'spheroid', peut être ajoutée pour utiliser les fonctions de calcul de distance sphéroïde pour les champs ayant un système de coordonnées géodétique.

\n

Avec PostgreSQL, l’option 'spheroid' utilise ST_DistanceSpheroid au lieu de ST_DistanceSphere. La fonction plus simple ST_Distance est utilisée avec les systèmes de coordonnées projetées. Les matrices sont converties en géométries pour les requêtes basées sur la sphéroïde.

\n
\n

distance_gtLien vers cette rubrique#

\n

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.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__distance_gt=(geom, D(m=5)))\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

ST_Distance/ST_Distance_Sphere(poly, geom) > 5

MariaDB

ST_Distance(poly, geom) > 5

MySQL

ST_Distance(poly, geom) > 5

Oracle

SDO_GEOM.SDO_DISTANCE(poly, geom, 0.05) > 5

SpatiaLite

Distance(poly, geom) > 5

\n
\n
\n
\n

distance_gteLien vers cette rubrique#

\n

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.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__distance_gte=(geom, D(m=5)))\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

ST_Distance/ST_Distance_Sphere(poly, geom) >= 5

MariaDB

ST_Distance(poly, geom) >= 5

MySQL

ST_Distance(poly, geom) >= 5

Oracle

SDO_GEOM.SDO_DISTANCE(poly, geom, 0.05) >= 5

SpatiaLite

Distance(poly, geom) >= 5

\n
\n
\n
\n

distance_ltLien vers cette rubrique#

\n

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.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__distance_lt=(geom, D(m=5)))\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

ST_Distance/ST_Distance_Sphere(poly, geom) < 5

MariaDB

ST_Distance(poly, geom) < 5

MySQL

ST_Distance(poly, geom) < 5

Oracle

SDO_GEOM.SDO_DISTANCE(poly, geom, 0.05) < 5

SpatiaLite

Distance(poly, geom) < 5

\n
\n
\n
\n

distance_lteLien vers cette rubrique#

\n

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.

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__distance_lte=(geom, D(m=5)))\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

ST_Distance/ST_Distance_Sphere(poly, geom) <= 5

MariaDB

ST_Distance(poly, geom) <= 5

MySQL

ST_Distance(poly, geom) <= 5

Oracle

SDO_GEOM.SDO_DISTANCE(poly, geom, 0.05) <= 5

SpatiaLite

Distance(poly, geom) <= 5

\n
\n
\n
\n

dwithinLien vers cette rubrique#

\n

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).

\n

Exemple :

\n
Code
Zipcode.objects.filter(poly__dwithin=(geom, D(m=5)))\n
\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Moteur

Équivalent SQL

PostGIS

ST_DWithin(poly, geom, 5)

Oracle

SDO_WITHIN_DISTANCE(poly, geom, 5)

SpatiaLite

PtDistWithin(poly, geom, 5)

\n
\n
\n
\n

Fonctions d’agrégationLien vers cette rubrique#

\n

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.

\n
\n\n\n\n\n\n\n\n\n\n\n

Paramètre nommé

Description

tolerance

Ce paramètre n’est valable que pour Oracle. Il s’agit de la valeur de tolérance utilisée par la procédure SDOAGGRTYPE; la documentation Oracle contient plus de détails.

\n
\n

Exemple :

\n
Code
>>> from django.contrib.gis.db.models import Extent, Union\n>>> WorldBorder.objects.aggregate(Extent('mpoly'), Union('mpoly'))\n
\n
\n

CollectLien vers cette rubrique#

\n
\n
\nclass Collect(geo_field)Lien vers cette définition#
\n
\n\n

Disponibilité : PostGIS, SpatiaLite

\n

Renvoie 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 accumule les objets géométriques dans une collection ou une géométrie multiple sans se préoccuper de fusionner les objets.

\n
\n
\n

ExtentLien vers cette rubrique#

\n
\n
\nclass Extent(geo_field)Lien vers cette définition#
\n
\n\n

Disponibilité : PostGIS, Oracle, SpatiaLite

\n

Renvoie 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.

\n

Exemple :

\n
Code
>>> 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)\n
\n
\n
\n

Extent3DLien vers cette rubrique#

\n
\n
\nclass Extent3D(geo_field)Lien vers cette définition#
\n
\n\n

Disponibilité : PostGIS

\n

Renvoie 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).

\n

Exemple :

\n
Code
>>> 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)\n
\n
\n
\n

MakeLineLien vers cette rubrique#

\n
\n
\nclass MakeLine(geo_field)Lien vers cette définition#
\n
\n\n

Disponibilité : PostGIS, SpatiaLite

\n

Renvoie 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.

\n

Exemple :

\n
Code
>>> qs = City.objects.filter(name__in=('Houston', 'Dallas')).aggregate(MakeLine('poly'))\n>>> print(qs['poly__makeline'])\nLINESTRING (-95.3631510000000020 29.7633739999999989, -96.8016109999999941 32.7820570000000018)\n
\n
\n
\n

UnionLien vers cette rubrique#

\n
\n
\nclass Union(geo_field)Lien vers cette définition#
\n
\n\n

Disponibilité : PostGIS, Oracle, SpatiaLite

\n

Cette 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.

\n\n

Exemple :

\n
Code
>>> 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.\n
\n

Notes de bas de page

\n\n
\n
\n
","rootId":"gis-queryset-api-reference","toc":[{"title":"Recherches spatiales","anchor":"spatial-lookups","children":[{"title":"Requêtes avec matrices","anchor":"lookups-with-rasters","children":[]},{"title":"bbcontains","anchor":"bbcontains","children":[]},{"title":"bboverlaps","anchor":"bboverlaps","children":[]},{"title":"contained","anchor":"contained","children":[]},{"title":"contains","anchor":"contains","children":[]},{"title":"contains_properly","anchor":"contains-properly","children":[]},{"title":"coveredby","anchor":"coveredby","children":[]},{"title":"covers","anchor":"covers","children":[]},{"title":"crosses","anchor":"crosses","children":[]},{"title":"disjoint","anchor":"disjoint","children":[]},{"title":"equals","anchor":"equals","children":[]},{"title":"exact, same_as","anchor":"exact-same-as","children":[]},{"title":"intersects","anchor":"intersects","children":[]},{"title":"isvalid","anchor":"isvalid","children":[]},{"title":"overlaps","anchor":"overlaps","children":[]},{"title":"relate","anchor":"relate","children":[{"title":"PostGIS et SpatiaLite","anchor":"postgis-spatialite","children":[]},{"title":"Oracle","anchor":"oracle","children":[]}]},{"title":"touches","anchor":"touches","children":[]},{"title":"within","anchor":"within","children":[]},{"title":"left","anchor":"left","children":[]},{"title":"right","anchor":"right","children":[]},{"title":"overlaps_left","anchor":"overlaps-left","children":[]},{"title":"overlaps_right","anchor":"overlaps-right","children":[]},{"title":"overlaps_above","anchor":"overlaps-above","children":[]},{"title":"overlaps_below","anchor":"overlaps-below","children":[]},{"title":"strictly_above","anchor":"strictly-above","children":[]},{"title":"strictly_below","anchor":"strictly-below","children":[]}]},{"title":"Recherches de distance","anchor":"distance-lookups","children":[{"title":"distance_gt","anchor":"distance-gt","children":[]},{"title":"distance_gte","anchor":"distance-gte","children":[]},{"title":"distance_lt","anchor":"distance-lt","children":[]},{"title":"distance_lte","anchor":"distance-lte","children":[]},{"title":"dwithin","anchor":"dwithin","children":[]},{"title":"Fonctions d’agrégation","anchor":"aggregate-functions","children":[{"title":"Collect","anchor":"collect","children":[]},{"title":"Extent","anchor":"extent","children":[]},{"title":"Extent3D","anchor":"extent3d","children":[]},{"title":"MakeLine","anchor":"makeline","children":[]},{"title":"Union","anchor":"union","children":[]}]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Référence de l’API","url":"/fr/3.0/ref/"},{"docname":"ref/contrib/index","title":"Paquets contrib","url":"/fr/3.0/ref/contrib/"},{"docname":"ref/contrib/gis/index","title":"GeoDjango","url":"/fr/3.0/ref/contrib/gis/"}],"prev":{"docname":"ref/contrib/gis/forms-api","title":"API des formulaires GeoDjango","url":"/fr/3.0/ref/contrib/gis/forms-api/"},"next":{"docname":"ref/contrib/gis/functions","title":"Fonctions de base de données géographiques","url":"/fr/3.0/ref/contrib/gis/functions/"},"formats":{"html":"/fr/3.0/ref/contrib/gis/geoquerysets/","markdown":"/fr/3.0/ref/contrib/gis/geoquerysets.md","json":"/fr/3.0/ref/contrib/gis/geoquerysets.json"},"source":"https://github.com/django/django/blob/stable/3.0.x/docs/ref/contrib/gis/geoquerysets.txt","official":"https://docs.djangoproject.com/fr/3.0/ref/contrib/gis/geoquerysets/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}