Available in versions: Dev (3.19) | Latest (3.18) | 3.17 | 3.16

ST_Equals

Applies to ❌ Open Source Edition   ✅ Express Edition   ✅ Professional Edition   ✅ Enterprise Edition

This predicate checks if a geometry is "spatially equal" to another geometry (i.e. the ordering of points is irrelevant for this equality). For example:

create.select(field(stEquals(
  stGeomFromText("LINESTRING (-1 -1, 1 1)"), 
  stGeomFromText("LINESTRING (1 1, -1 -1)")
))).fetch();

The result being, for example

+-----------+
| ST_Equals |
+-----------+
| true      |
+-----------+

Or, visually:






Dialect support

This example using jOOQ:

stEquals(geometry1, geometry2)

Translates to the following dialect specific expressions:

-- AURORA_MYSQL, AURORA_POSTGRES, COCKROACHDB, MARIADB, MYSQL, POSTGRES, REDSHIFT, SNOWFLAKE
st_equals(geometry1, geometry2)

-- ORACLE
((st_equal(geometry1, geometry2) = 'TRUE'))

-- SQLSERVER
geometry1.STEquals(geometry2) = 1

-- ACCESS, ASE, BIGQUERY, DB2, DERBY, DUCKDB, EXASOL, FIREBIRD, H2, HANA, HSQLDB, INFORMIX, MEMSQL, SQLDATAWAREHOUSE, 
-- SQLITE, SYBASE, TERADATA, TRINO, VERTICA, YUGABYTEDB
/* UNSUPPORTED */

(These are currently generated with jOOQ 3.19, see #10141), or translate your own on our website

Feedback

Do you have any feedback about this page? We'd love to hear it!

The jOOQ Logo