ST_Equals

:command:`ST_Equals(geometry A, geometry B)` teste l'égalité spatiale de deux géométries.

ST_Equals retourne TRUE si les deux géométries sont du même type et ont des coordonnées x.y identiques.

PremiÚrement, essayons de récupérer la représentation d'un point de notre table nyc_subway_stations. Nous ne prendrons que l'entrée : 'Broad St'.

SELECT name, the_geom, ST_AsText(the_geom)
FROM nyc_subway_stations
WHERE name = 'Broad St';

   name   |                      the_geom                      |      st_astext
----------+----------------------------------------------------+-----------------------
 Broad St | 0101000020266900000EEBD4CF27CF2141BC17D69516315141 | POINT(583571 4506714)

Maintenant, copiez / collez la valeur affichée pour tester la fonction :command:`ST_Equals`:

SELECT name
FROM nyc_subway_stations
WHERE ST_Equals(the_geom, '0101000020266900000EEBD4CF27CF2141BC17D69516315141');

Broad St

ST_Intersects, ST_Disjoint, ST_Crosses et ST_Overlaps

:command:`ST_Intersects`, :command:`ST_Crosses`, et :command:`ST_Overlaps` teste si l'intérieur des géométries s'intersecte, se croise ou se chevauche.

:command:`ST_Intersects(geometry A, geometry B)` retourne t (TRUE) si l'intersection ne renvoie pas un ensemble vide de résultats. Intersects retourne le résultat exactement inverse de la fonction disjoint.

L'opposé de ST_Intersects est :command:`ST_Disjoint(geometry A , geometry B)`. Si deux géométries sont disjointes, elle ne s'intersectent pas et vice-versa. En fait, il est souvent plus efficace de tester si deux géométries ne s'intersectent pas que de tester si elles sont disjointes du fait que le test d'intersection peut être spatialement indexé alors que le test disjoint ne le peut pas.

Pour les comparaisons de couples de types multipoint/polygon, multipoint/linestring, linestring/linestring, linestring/polygon, et linestring/multipolygon, :command:`ST_Crosses(geometry A, geometry B)` retourne t (TRUE) si les résultats de l'intersection sont à l'intérieur des deux géométries.

:command:`ST_Overlaps(geometry A, geometry B)` compare deux géométries de même dimension et retourne TRUE si leur intersection est une géométrie différente des deux fournies mais de même dimension.

Essayons de prendre la station de métro de Broad Street et de déterminer son voisinage en utilisant la fonction :command:`ST_Intersects` :

SELECT name, boroname
FROM nyc_neighborhoods
WHERE ST_Intersects(the_geom, '0101000020266900000EEBD4CF27CF2141BC17D69516315141');

        name        | boroname
--------------------+-----------
 Financial District | Manhattan

ST_Touches

:command:`ST_Touches` teste si deux géométries se touchent en leur contours extérieurs, mais leur contours intérieurs ne s'intersectent pas

:command:`ST_Touches(geometry A, geometry B)` retourne TRUE soit si les contours des géométries s'intersectent ou si l'un des contours intérieurs de l'une intersecte le contour extérieur de l'autre.

ST_Within et ST_Contains

:command:`ST_Within` et :command:`ST_Contains` teste si une géométrie est totalement incluse dans l'autre.

:command:`ST_Within(geometry A , geometry B)` retourne TRUE si la premiÚre géométrie est complÚtement contenue dans l'autre. ST_Within teste l'exact opposé au résultat de ST_Contains.

:command:`ST_Contains(geometry A, geometry B)` retourne TRUE si la seconde géométrie est complÚtement contenue dans la premiÚre géométrie.

ST_Distance et ST_DWithin

Une question fréquente dans le domaine du SIG est "trouver tous les éléments qui se trouvent à une distance X de cet autre élément".

La fonction :command:`ST_Distance(geometry A, geometry B)` calcule la plus courte distance entre deux géométries. Cela est pratique pour récupérer la distance entre les objets.

SELECT ST_Distance(
  ST_GeometryFromText('POINT(0 5)'),
  ST_GeometryFromText('LINESTRING(-2 2, 2 2)'));

3

Pour tester si deux objets sont à la même distance d'un autre, la fonction :command:`ST_DWithin` fournit un test tirant profit des index. Cela est trÚs utile pour répondre a une question telle que: "Combien d'arbres se situent dans un buffer de 500 mÚtres autour de cette route ?". Vous n'avez pas à calculer le buffer, vous avez simplement besoin de tester la distance entre les géométries.

En utilisant de nouveau notre station de métro Broad Street, nous pouvons trouver les rues voisines (à 10 mÚtres de) de la station :

SELECT name
FROM nyc_streets
WHERE ST_DWithin(
        the_geom,
        '0101000020266900000EEBD4CF27CF2141BC17D69516315141',
        10
      );

     name
--------------
   Wall St
   Broad St
   Nassau St

Nous pouvons vérifier la réponse sur une carte. La station Broad St est actuellement à l'intersection des rues Wall, Broad et Nassau.

Liste des fonctions

ST_Contains(geometry A, geometry B) : retourne TRUE si aucun des points de B n'est à l'extérieur de A, et au moins un point de l'intérieur de B est à l'intérieur de A.

ST_Crosses(geometry A, geometry B) : retourne TRUE si la géométrie A a certains, mais pas la totalité, de ses points à l'intérieur de B.

ST_Disjoint(geometry A , geometry B) : retourne TRUE si les géométries ne s'intersectent pas - elles n'ont aucun point en commun.

ST_Distance(geometry A, geometry B) : retourne la distance cartésienne en 2 dimensions minimum entre deux géométries dans l'unité de la projection.

ST_DWithin(geometry A, geometry B, radius) : retourne TRUE si les géométries sont distante (radius) l'une de l'autre.

ST_Equals(geometry A, geometry B) : retourne TRUE si les géométries fournies représentent la même géométrie. L'ordre des entités n'est pas pris en compte.

ST_Intersects(geometry A, geometry B) : retourne TRUE si les géométries s'intersectent - (ont un espace en commun) et FALSE si elles n'en ont pas (elles sont disjointes).

ST_Overlaps(geometry A, geometry B) : retourne TRUE si les géométries ont un espace en commun, sont de la même dimension, mais ne sont pas complÚtement contenues l'une dans l'autre.

ST_Touches(geometry A, geometry B) : retourne TRUE si les géométries ont au moins un point en commun, mais leur intérieurs ne s'intersectent pas.

ST_Within(geometry A , geometry B) : retourne TRUE si la géométrie A est complÚtement à l'intérieur de B