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