Catégories :

Fonctions géospatiales

ST_CONTAINS

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

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 sur la signification de « contains » (contient), voir le modèle à 9 intersections dimensionnellement étendu (DE-9IM).

Note

Cette fonction ne prend pas en charge l’utilisation de GeometryCollection ou de FeatureCollection comme valeurs d’entrée.

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 qui n’est pas un GeometryCollection ou un FeatureCollection.

expression_géographie_2

Un objet GEOGRAPHY qui n’est pas un GeometryCollection ou un FeatureCollection.

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                |
+---------------------+