Catégories :

Fonctions géospatiales

ST_CONTAINS

Intuitivement, cette fonction renvoie TRUE si le deuxième objet géospatial est complètement à l’intérieur du premier objet géospatial.

Plus strictement, l’objet g1 contient l’objet g2 si et seulement si aucun point de g2 ne se trouve à l’extérieur de g1, et au moins un point de l’intérieur de B se trouve à l’intérieur de A. Il y a certaines subtilités dans cette définition qui ne sont pas immédiatement évidentes ; pour plus de détails, voir :

Voir aussi :

ST_WITHIN , ST_COVERS , ST_COVEREDBY

Syntaxe

ST_CONTAINS( <geography_expression_1> , <geography_expression_2> )

Arguments

expression_géographie_1

Un objet GEOGRAPHY.

expression_géographie_2

Un objet GEOGRAPHY.

Renvoie

BOOLEAN.

Exemples

Cela montre une utilisation simple de la fonction ST_CONTAINS :

create table geospatial_table_01 (g1 GEOGRAPHY, g2 GEOGRAPHY);
insert into geospatial_table_01 (g1, g2) values 
    ('POLYGON((0 0, 3 0, 3 3, 0 3, 0 0))', 'POLYGON((1 1, 2 1, 2 2, 1 2, 1 1))');
SELECT ST_CONTAINS(g1, g2) 
    FROM geospatial_table_01;
+---------------------+
| ST_CONTAINS(G1, G2) |
|---------------------|
| True                |
+---------------------+