Catégories :

Fonctions géospatiales

ST_WITHIN

Renvoie vrai si le premier objet géospatial est entièrement contenu par le deuxième objet géospatial. En d’autres termes :

  • Le premier objet GEOGRAPHY g1 est entièrement contenu par le deuxième objet GEOGRAPHY g2.

  • Le premier objet GEOMETRY g1 est entièrement contenu par le deuxième objet GEOMETRY g2.

L’appel de ST_WITHIN(g1, g2) équivaut à appeler ST_CONTAINS(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_CONTAINS , ST_COVEREDBY

Syntaxe

ST_WITHIN( <geography_expression_1> , <geography_expression_2> )

ST_WITHIN( <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.

Exemples

Exemples GEOGRAPHY

Cela montre une utilisation simple de la fonction ST_WITHIN :

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_WITHIN(g1, g2) 
    FROM geospatial_table_01;
+-------------------+
| ST_WITHIN(G1, G2) |
|-------------------|
| False             |
+-------------------+
Copy