A função ST_CONTAINS determina se value1 contém value2.
Sintaxe
BOOLEAN ST_CONTAINS(GEOGRAPHY <value1>, GEOGRAPHY <value2>)Parâmetros
value1, value2: Obrigatórios. Valores do tipo de dados GEOGRAPHY data type. Construa objetos GEOGRAPHY com funções como ST_GEOGPOINT, ST_GEOGFROMWKB, ST_GEOGFROMTEXT, ST_MAKELINE e ST_MAKEPOLYGON.
Valor de retorno
Retorna um valor BOOLEAN:
TRUE se todos os pontos de value2 estiverem dentro de value1; caso contrário, FALSE.
FALSE se value1 ou value2 for um objeto geográfico vazio.
Um objeto geográfico não contém sua fronteira.
Exemplos
Os exemplos a seguir verificam se o polígono POLYGON((0 0, 10 0, 10 10, 0 10, 0 0)) contém três pontos: um fora do polígono (20, 20), um na fronteira (0, 0) e um no interior (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)'));