TEST
Syntax
TEST (POINT lat lon)|(GET key id)|(BOUNDS minlat minlon maxlat maxlon)|(OBJECT geojson)|(CIRCLE lat lon meters)|(TILE x y z)|(QUADKEY quadkey)|(HASH geohash) INTERSECTS|WITHIN [CLIP] (POINT lat lon)|(GET key id)|(BOUNDS minlat minlon maxlat maxlon)|(OBJECT geojson)|(CIRCLE lat lon meters)|(TILE x y z)|(QUADKEY quadkey)|(HASH geohash)|(SECTOR lat lon meters bearing1 bearing2)
Description
The TEST command performs tests on given objects, without searching through the data.
TEST a WITHIN b
returns 1 if a is within b, and 0 otherwise.
TEST a INTERSECTS b
returns 1 if a intersects b, and 0 otherwise.
In the examples above, both a and b can be any of these types: POINT, GET, BOUNDS, OBJECT, CIRCLE, TILE, QUADKEY, HASH.
TEST a INTERSECTS CLIP b
returns 1 if a intersects b, and 0 otherwise. If the result is 1, then it also returns a clipped by b. This only works when b is one of these types: BOUNDS, TILE, QUADKEY, HASH.