distanceWithin

Returns true when the distance between two geometries is within the given distance, false otherwise.

Returns false when negative distance is given or when either geometry is empty.

Distance is in input geometry units.

Parameters

Name	Type	Description
a	Geometry | Prepared<Geometry>	First geometry
b	Geometry	Second geometry
maxDistance	number	The maximum distance

Returns

boolean

true when the distance between the geometries is less than or equal to the given distance, false otherwise

Throws

• GEOSError on unsupported geometry types (curved)

See also

• distance computes the distance between two geometries
• nearestPoints finds the nearest points of two geometries
• prepare improves performance of repeated calls against a single geometry

Examples

const a = point([ 0, 0 ]);
const b = lineString([ [ 0, 10 ], [ 10, 0 ] ]);
const d = distance(a, b); // 7.0710678118654755 = 5 * Math.sqrt(2)
const dwithin_70 = distanceWithin(a, b, 7.0); // false
const dwithin_71 = distanceWithin(a, b, 7.1); // true

const a = point([ 0, 0 ]); const b = lineString([ [ 0, 10 ], [ 10, 0 ] ]); const d = distance(a, b); // 7.0710678118654755 = 5 * Math.sqrt(2) const dwithin_70 = distanceWithin(a, b, 7.0); // false const dwithin_71 = distanceWithin(a, b, 7.1); // true