GEOGRAPHY_WITHIN_DISTANCE

This function takes in two geospatial objects and determines whether any part of them is within the given distance, in meters.

Syntax

GEOGRAPHY_WITHIN_DISTANCE ( geo1, geo2, meters )

Arguments

  • geo1, geo2: any valid geospatial object or WKT string: path, point or polygon.

  • meters: the maximum range, in meters

Return Type

Boolean

Examples

Important

The two queries below give equivalent results, but WITHIN_DISTANCE can take advantage of any spatial indexes on the columns for faster execution.

SELECT name FROM neighborhoods WHERE
GEOGRAPHY_WITHIN_DISTANCE("POINT(-73.94990499 40.69150746)", shape, 10000);
SELECT name FROM neighborhoods WHERE
GEOGRAPHY_DISTANCE("POINT(-73.94990499 40.69150746)", shape) <= 10000;

For more information about working with geospatial data, see Working with Geospatial Features.

Last modified: June 29, 2022

Was this article helpful?