> ## Documentation Index
> Fetch the complete documentation index at: https://cockroachlabs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ST_Overlaps

export const InternalLink = ({version, path = "", children, ...props}) => {
  let detectedVersion = version || "stable";
  if (typeof window !== 'undefined' && !version) {
    const match = window.location.pathname.match(/\/docs\/([^/]+)/);
    if (match) {
      detectedVersion = match[1];
    }
  }
  const normalizedPath = path.startsWith("/") ? path.slice(1) : path;
  return <a href={`/docs/${detectedVersion}/${normalizedPath}`} {...props}>
      {children}
    </a>;
};

Given two shapes *A* and *B*, `ST_Overlaps(A, B)` returns `true` if the following criteria are met:

* The shapes share any of the same space -- that is, if any point in the set that comprises *A* is also a member of the set of points that make up *B*.
* Neither of the shapes is contained by the other, in the <InternalLink path="st_contains">`ST_Contains`</InternalLink> sense.

In other words, `ST_Overlaps` returns `true` if the shapes intersect (in the <InternalLink path="st_intersects">`ST_Intersects`</InternalLink> sense), but neither is contained within the other.

`ST_Overlaps` works on the following spatial data types:

* <InternalLink path="architecture/glossary#geometry">`GEOMETRY`</InternalLink>

<Note>
  \`\` will attempt to use any available <InternalLink path="spatial-indexes">spatial index</InternalLink> to speed up its operation.  Use the prefixed variant `_` if you do not want any spatial indexes to be used.
</Note>

## Examples

<Note>
  The screenshots in these examples were generated using [geojson.io](http://geojson.io), but they are designed to showcase the shapes, not the map.  Representing `GEOMETRY` data in GeoJSON can lead to unexpected results if using geometries with <InternalLink path="architecture/glossary#srid">SRIDs</InternalLink> other than 4326 (as shown below).
</Note>

### True

In this example, \`\` returns `true` because:

* There is a Point in the set that comprises Polygon *A* that is also a member of the set of Points that make up Polygon *B*.
* Neither of the shapes is contained by the other, in the <InternalLink path="st_contains">`ST_Contains`</InternalLink> sense.

```sql theme={"theme":{"light":"catppuccin-mocha","dark":"catppuccin-mocha"}}
SELECT st_overlaps(st_geomfromtext('SRID=4326;POLYGON((-87.906471 43.038902, -95.992775 36.153980, -75.704722 36.076944, -87.906471 43.038902))'), st_geomfromtext('SRID=4326;POLYGON((-84.191605 39.758949, -75.165222 39.952583, -78.878738 42.880230, -84.191605 39.758949))'));
```

```
  st_overlaps
---------------
     true

(1 row)
```

<img src="https://mintcdn.com/cockroachlabs/u4HfMUOf0rP4LFyR/images/v26.3/geospatial/st_overlaps_true.png?fit=max&auto=format&n=u4HfMUOf0rP4LFyR&q=85&s=0225e33bb8e653a8654f6066cf84cac6" alt="ST_Overlaps - true" width="1280" height="988" data-path="images/v26.3/geospatial/st_overlaps_true.png" />

### False

In this example, \`\` returns `false` because:

* * There is not any Point in the set that comprises Polygon *A* that is also a member of the set of Points that make up Polygon *B*.

```sql theme={"theme":{"light":"catppuccin-mocha","dark":"catppuccin-mocha"}}
SELECT st_overlaps(st_geomfromtext('SRID=4326;POLYGON((-79.995888 40.440624,-74.666728 40.358244, -76.5 42.443333, -79.995888 40.440624))'), st_geomfromtext('SRID=4326;POLYGON((-79.976111 40.374444, -74.621157 40.323294, -76.609383 39.299236, -79.976111 40.374444))'));
```

```
  st_overlaps
---------------
     false
(1 row)
```

<img src="https://mintcdn.com/cockroachlabs/u4HfMUOf0rP4LFyR/images/v26.3/geospatial/st_overlaps_false.png?fit=max&auto=format&n=u4HfMUOf0rP4LFyR&q=85&s=db2dd59a7481ca0e234edc8d41871860" alt="ST_Overlaps - false" width="1280" height="988" data-path="images/v26.3/geospatial/st_overlaps_false.png" />

## See also

* <InternalLink path="architecture/glossary">Spatial and GIS Glossary of Terms</InternalLink>
* <InternalLink path="spatial-indexes">Spatial indexes</InternalLink>
* <InternalLink path="functions-and-operators">Spatial functions</InternalLink>
* <InternalLink path="st_covers">`ST_Covers`</InternalLink>
* <InternalLink path="st_coveredby">`ST_CoveredBy`</InternalLink>
* <InternalLink path="st_contains">`ST_Contains`</InternalLink>
* <InternalLink path="st_within">`ST_Within`</InternalLink>
* <InternalLink path="st_intersects">`ST_Intersects`</InternalLink>
* <InternalLink path="st_coveredby">`ST_CoveredBy`</InternalLink>
* <InternalLink path="st_covers">`ST_Covers`</InternalLink>
* <InternalLink path="st_disjoint">`ST_Disjoint`</InternalLink>
* <InternalLink path="st_equals">`ST_Equals`</InternalLink>
* <InternalLink path="st_touches">`ST_Touches`</InternalLink>
* <InternalLink path="st_convexhull">`ST_ConvexHull`</InternalLink>
* <InternalLink path="st_union">`ST_Union`</InternalLink>
* <InternalLink path="migrate-from-shapefiles">Migrate from Shapefiles</InternalLink>
* <InternalLink path="migrate-from-geojson">Migrate from GeoJSON</InternalLink>
* <InternalLink path="migrate-from-geopackage">Migrate from GeoPackage</InternalLink>
* <InternalLink path="migrate-from-openstreetmap">Migrate from OpenStreetMap</InternalLink>
* [Introducing Distributed Spatial Data in CockroachDB](https://www.cockroachlabs.com/blog/spatial-data/) (blog post)
