Syntaxe
|
ST_WITHIN(geography_1, geography_2)
|
Paramètres
| Nom |
Description |
| geography_1 |
Ce paramètre permet de spécifier la première expression de type GEOGRAPHY, la géométrie que l'on souhaite vérifier si elle est contenue. |
| geography_2 |
Ce paramètre permet de spécifier la deuxième expression de type GEOGRAPHY, la géométrie "contenante" ou la zone de référence. La fonction renvoie TRUE si geography_1 est entièrement contenue dans geography_2 (c'est-à-dire que geography_1 et geography_2 s'intersectent, et que l'intérieur de geography_1 est contenu dans l'intérieur ou la limite de geography_2), et FALSE sinon. ST_WITHIN(A, B) est l'inverse de ST_CONTAINS(B, A). |
Description
Cette fonction permet de vérifier si 2 coordonnées géographique s'entrecroisent que le premier point géographique n'est pas en dehors du deuxième point géographique.
Remarques
- Vérification d'inclusion stricte d'une géométrie dans une autre : La fonction ST_WITHIN sert à déterminer si une géométrie (le premier paramètre) est
totalement incluse à l'intérieur d'une autre géométrie (le second paramètre). Cette inclusion est stricte, ce qui signifie que tous les points de la première géométrie doivent se situer dans l'intérieur ou
sur la limite de la seconde.
- Relation inverse de ST_CONTAINS : ST_WITHIN(A, B) est l'opposé logique de ST_CONTAINS(B, A). Si A est dans B, alors B contient A. Cela permet d'avoir une
flexibilité dans les requêtes spatiales selon la géométrie que l'on souhaite positionner en tant que contenant ou contenu.
- Utilité pour les analyses d'appartenance spatiale : Cette fonction est très utilisée pour vérifier si un point, une ligne ou un polygone appartient à
une zone donnée, par exemple pour savoir si un lieu est situé à l'intérieur d'une région administrative ou si une route est entièrement dans une zone protégée.
- Inclut les points situés sur la limite : Une caractéristique importante est que ST_WITHIN considère qu'une géométrie est contenue même si elle est sur
la limite de la géométrie contenant. Cela signifie que les points à la frontière ne provoquent pas de faux négatifs.
- Fonction sensible à la précision géométrique : Comme toutes les fonctions spatiales, ST_WITHIN dépend fortement de la précision des données géographiques.
De petites erreurs dans les coordonnées peuvent changer le résultat, notamment si une géométrie est très proche de la limite.
- Applicable à tous types de géométries : Que la géométrie soit un point, une ligne, un polygone ou une collection de géométries, ST_WITHIN peut être
utilisée, ce qui en fait un outil très polyvalent pour les requêtes spatiales complexes.
- Indispensable pour les filtrages spatiaux dans les bases de données : Cette fonction est souvent intégrée dans les filtres SQL spatiaux pour extraire
des données strictement contenues dans une zone, ce qui permet des analyses géographiques précises et efficaces sur de grands ensembles de données.
- Attention à la distinction entre inclusion et intersection : ST_WITHIN exige une inclusion totale, contrairement à ST_INTERSECTS ne demandant qu'un simple
chevauchement partiel. Cela est important pour les cas où on doit garantir qu'un objet spatial est complètement à l'intérieur d'un autre.
Dernière mise à jour : Jeudi, le 18 Juin 2020
