Catégories :: Fonctions géospatiales

ST_COVEREDBY¶

Cette fonction renvoie TRUE si aucun point d’un objet géospatial ne se trouve à l’extérieur d’un autre objet géospatial. En d’autres termes :

GEOGRAPHY l’objet g1 est à l’extérieur de GEOGRAPHY l’objet g2.
GEOMETRY l’objet g1 est à l’extérieur de GEOMETRY l’objet g2.

Est équivalent à ST_COVERS(g2, g1).

Bien que ST_COVEREDBY et ST_WITHIN puissent sembler similaires, les deux fonctions présentent des différences subtiles. Pour plus de détails sur les différences entre « covered by » (couvert par) et « within » (dans), 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.

Astuce

Vous pouvez utiliser le service d’optimisation de recherche pour améliorer les performances des requêtes qui appellent cette fonction. Pour plus de détails, voir Service d’optimisation de la recherche.

Voir aussi :: ST_COVERS , ST_WITHIN

Syntaxe¶

ST_COVEREDBY( <geography_expression_1> , <geography_expression_2> )

ST_COVEREDBY( <geometry_expression_1> , <geometry_expression_2> )

Copy

Arguments¶

geography_expression_1: Un objet GEOGRAPHY qui n’est pas un GeometryCollection ou un FeatureCollection.
geography_expression_2: Un objet GEOGRAPHY qui n’est pas un GeometryCollection ou un FeatureCollection.
geometry_expression_1: Un objet GEOMETRY qui n’est pas un GeometryCollection ou un FeatureCollection.
geometry_expression_2: Un objet GEOMETRY qui n’est pas un GeometryCollection ou un FeatureCollection.

Renvoie¶

BOOLEAN.

Notes sur l’utilisation¶

Pour les objets GEOMETRY, la fonction signale une erreur si les deux objets GEOMETRY en entrée ont des SRIDs différents.

Exemples¶

Exemples GEOGRAPHY¶

Cela montre une utilisation simple de la fonction ST_COVEREDBY :

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))');

Copy

SELECT ST_COVEREDBY(g1, g2) 
    FROM geospatial_table_01;
+----------------------+
| ST_COVEREDBY(G1, G2) |
|----------------------|
| False                |
+----------------------+

Copy