This section contains reference documentation for the ST_Contains function.
Returns true if and only if no points of the second geometry/geography lie in the exterior of the first geometry/geography, and at least one point of the interior of the first geometry lies in the interior of the second geometry.
ST_Contains(geometry/geography, geometry/geography)
ST_Contains on Geography only give close approximation: we use geometry computation on geography objects, which can give close approximation on small areas, but not work well on for areas cross the 180th meridian.
These examples are based on the .
Index usage can be checked with EXPLAIN command:
which ought to return plan ending with:
where InclusionFilterH3Index means that query uses H3 index lookup.
POINT (-73.99 40.75)
1
New York
POINT (-73.99 40.75)
1
New York
POINT (-73.99 40.75)
1
New York
POINT (-73.99 40.75)
1
Staten Island
POINT (-74.15 40.61)
1
8
New York
select group_city,
ST_AsText(location) AS locationString,
ST_Contains(
ST_GeomFromText('POLYGON ((
-74.171737 40.607377,
-74.089339 40.753180,
-73.911498 40.769303,
-74.016555 40.604249,
-74.171737 40.607377))'),
toGeometry(location)
) AS inPolygon
from meetupRsvp
order by inPolygon DESC
limit 5select count(*)
from meetupRsvp
WHERE ST_Contains(
ST_GeomFromText('POLYGON ((
-74.171737 40.607377,
-74.089339 40.753180,
-73.911498 40.769303,
-74.016555 40.604249,
-74.171737 40.607377))'),
toGeometry(location)
) = 1select count(*)
from meetupRsvp
WHERE ST_Contains(
ST_GeogFromText('POLYGON ((
-74.171737 40.607377,
-74.089339 40.753180,
-73.911498 40.769303,
-74.016555 40.604249,
-74.171737 40.607377))'),
location ) = 1SET explainAskingServers=true;
explain plan for
SELECT event_id
FROM meetupRsvp
WHERE ST_Contains(
ST_GeogFromText('POLYGON ((
-74.171737 40.607377,
-74.089339 40.753180,
-73.911498 40.769303,
-74.016555 40.604249,
-74.171737 40.607377))'), location) = 1
limit 1000Project(columns=[[event_id]])
DocIdSet(maxDocs=[10000])
InclusionFilterH3Index(predicate=[stcontains('84000000010000000500000000c0528afdbd2fa0d740444dbe878fabdac05285b7baecd0784044606833c6002ac0527a55fbb517a440446278854cdb7bc052810f3cb3e57540444d5807fed203c0528afdbd2fa0d740444dbe878fabda',location) = '1'], operator=[EQ])