La fonction ST_CONTAINS détermine si value1 contient value2.
Syntaxe
BOOLEAN ST_CONTAINS(GEOGRAPHY <value1>, GEOGRAPHY <value2>)Paramètres
value1, value2 : Obligatoire. Valeurs du type de données GEOGRAPHY. Construisez des objets GEOGRAPHY à l'aide de fonctions telles que ST_GEOGPOINT, ST_GEOGFROMWKB, ST_GEOGFROMTEXT, ST_MAKELINE et ST_MAKEPOLYGON.
Valeur renvoyée
Renvoie une valeur BOOLEAN :
TRUE si chaque point de value2 se trouve dans value1. Sinon, FALSE.
FALSE si value1 ou value2 est un objet géographique vide.
Un objet géographique ne contient pas sa limite.
Exemples
Les exemples suivants vérifient si le polygone POLYGON((0 0, 10 0, 10 10, 0 10, 0 0)) contient trois points : un point extérieur au polygone (20, 20), un point situé sur sa limite (0, 0) et un point intérieur (5, 5).
-- Returns TRUE because POINT(5 5) is inside the polygon.
SELECT ST_CONTAINS(ST_GEOGFROMTEXT('POLYGON((0 0, 10 0, 10 10, 0 10, 0 0))'), ST_GEOGFROMTEXT('POINT(5 5)'));
-- Returns FALSE because POINT(20 20) is outside the polygon.
SELECT ST_CONTAINS(ST_GEOGFROMTEXT('POLYGON((0 0, 10 0, 10 10, 0 10, 0 0))'), ST_GEOGFROMTEXT('POINT(20 20)'));
-- Returns FALSE because POINT(0 0) is on the boundary of the polygon.
SELECT ST_CONTAINS(ST_GEOGFROMTEXT('POLYGON((0 0, 10 0, 10 10, 0 10, 0 0))'), ST_GEOGFROMTEXT('POINT(0 0)'));