ST_DWithin - Amazon Redshift
SyntaxeArgumentsType de retourExemples

Amazon Redshift ne prendra plus en charge la création de nouvelles fonctions Python définies par l’utilisateur à compter du 1er novembre 2025. Si vous souhaitez utiliser des fonctions Python définies par l’utilisateur, créez-les avant cette date. Les fonctions Python définies par l’utilisateur existantes continueront de fonctionner normalement. Pour plus d’informations, consultez le billet de blog .

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 GEOMETRY ou expression qui est évaluée sur un type GEOMETRY.

geom2

Valeur de type de données GEOMETRY ou expression qui est évaluée sur un type GEOMETRY.

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