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

ST_Contains

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

This predicate checks if a geometry contains another geometry.

create.select(
  stContains(
    stGeomFromText("POLYGON ((-3 -1, -1 -1, -1 1, -3 1, -3 -1))"),
    stGeomFromText("POINT (-2 0)")
  ),
  stContains(
    stGeomFromText("POLYGON ((3 -1, 1 -1, 1 1, 3 1, 3 -1))"),
    stGeomFromText("POINT (4 0)")
  )
).fetch();

The result being, for example

+-------------+-------------+
| ST_Contains | ST_Contains |
+-------------+-------------+
| true        | false       |
+-------------+-------------+

Or, visually:










Dialect support

This example using jOOQ:

stContains(geometry1, geometry2)

Translates to the following dialect specific expressions:

Aurora MySQL, Aurora Postgres, CockroachDB, DuckDB, MariaDB, MySQL, Postgres, Redshift, Snowflake

st_contains(geometry1, geometry2)

Oracle

((st_contains(geometry1, geometry2) = 'TRUE'))

SQLServer

geometry1.STContains(geometry2) = 1

ASE, Access, BigQuery, ClickHouse, DB2, Derby, Exasol, Firebird, H2, HSQLDB, Hana, Informix, MemSQL, SQLDataWarehouse, SQLite, Sybase, Teradata, Trino, Vertica, YugabyteDB

/* UNSUPPORTED */
Generated with jOOQ 3.20. Translate your own SQL on our website

Feedback

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

The jOOQ Logo