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

This documentation is for the unreleased development version of jOOQ. Click on the above version links to get this documentation for a supported version of jOOQ.

ST_Overlaps

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

This predicate checks if two geometries overlap, i.e. they intersect, but no geometry completely contains the other. For example:

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

The result being, for example

+-------------+-------------+
| ST_Overlaps | ST_Overlaps |
+-------------+-------------+
| true        | false       |
+-------------+-------------+

Or, visually:










Dialect support

This example using jOOQ:

stOverlaps(geometry1, geometry2)

Translates to the following dialect specific expressions:

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

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

-- SQLSERVER
geometry1.STOverlaps(geometry2) = 1

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

(These are currently generated with jOOQ 3.18, 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