Catégories :

Fonctions géospatiales

ST_DWITHIN

Renvoie TRUE si la distance géodésique minimale entre deux points (deux objets GEOGRAPHY) est dans la distance spécifiée. Sinon, renvoie FALSE.

Si les paramètres sont des valeurs GEOGRAPHY qui ne sont pas des points (par exemple, des lignes ou des polygones), cela renvoie TRUE ou FALSE en fonction de la distance géodésique minimale entre les deux points les plus proches des deux valeurs.

Astuce

Vous pouvez utiliser le service d’optimisation de recherche pour améliorer les performances des requêtes qui appellent cette fonction. Pour plus de détails, voir Service d’optimisation de la recherche.

Syntaxe

ST_DWITHIN( <geography_expression_1> , <geography_expression_2> , <distance_in_meters> )
Copy

Arguments

geography_expression_1

L’argument doit être une expression de type GEOGRAPHY.

geography_expression_2

L’argument doit être une expression de type GEOGRAPHY.

distance_in_meters

L’argument doit être une expression de type REAL. La distance est en mètres.

Renvoie

Renvoie un BOOLEAN.

Notes sur l’utilisation

  • Renvoie NULL si une entrée est NULL.

Exemples

Cela renvoie TRUE car la distance en mètres entre deux points distants de 1 degré le long de l’équateur est inférieure à 150 000 mètres :

SELECT ST_DWITHIN (ST_MAKEPOINT(0, 0), ST_MAKEPOINT(1, 0), 150000);
+-------------------------------------------------------------+
| ST_DWITHIN (ST_MAKEPOINT(0, 0), ST_MAKEPOINT(1, 0), 150000) |
|-------------------------------------------------------------|
| True                                                        |
+-------------------------------------------------------------+
Copy