Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
ST_DWithin
ST_DWithin renvoie true si la distance euclidienne entre les projections 2D des deux valeurs géométriques en entrée n’est pas supérieure à une valeur seuil.
Syntaxe
ST_DWithin(geom1, geom2, threshold)
Arguments
- geom1
-
Valeur de type de données
GEOMETRYou expression qui est évaluée sur un typeGEOMETRY. - geom2
-
Valeur de type de données
GEOMETRYou expression qui est évaluée sur un typeGEOMETRY. - seuil
-
Valeur du type de données
DOUBLE PRECISION. Cette valeur est dans les unités des arguments d’entrée.
Type de retour
BOOLEAN
Si geom1 ou geom2 est null, null est renvoyé.
Si le seuil est négatif, une erreur est renvoyée.
Si geom1 et geom2 n’ont pas la même valeur pour l’identifiant de système de référence spatiale (SRID), une erreur est renvoyée.
Si geom1 ou geom2 est une collection géométrique, une erreur est renvoyée.
Exemples
Le SQL suivant vérifie si la distance entre deux polygones est comprise dans cinq unités.
SELECT ST_DWithin(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 3,2 1,0 -3,-1 3))'),5);
st_dwithin
-----------
true
