Proximity Query
Instructions for Use
Based on spatial proximity relationships, this tool rapidly searches for features in another dataset that meet spatial adjacency conditions within a specified radius for each feature in the input dataset. The qualifying features from the query dataset are returned to the result dataset (FeatureRDD).
Application Scenarios
- Land Use Planning: Evaluate the proximity of specific parcels (e.g., residential or industrial land) to surrounding facilities (e.g., schools, hospitals, parks). For example, identify all undeveloped land within 500 meters of a major road for rational development planning.
- Transportation Planning: Analyze the proximity of transportation hubs (e.g., railway stations, airports) to commercial facilities to assess service capacity. For instance, find all commercial centers within 1 kilometer of a railway station to study their impact on passenger consumption behavior.
Parameter Description
Parameter Name | Description | Parameter Type |
---|---|---|
Dataset to be queried | Input dataset (point, line, or polygon) via the Read Vector Data tool. | FeatureRDD |
Query dataset | Dataset containing proximity features (point, line, or polygon). Must share the same coordinate system as the input dataset. | FeatureRDD |
Proximity query distance | Search radius and unit (e.g., 100m ). Defaults to meters if no unit is specified. |
JavaDistance |
Distance calculation method | Options: - Geodesic Distance: Considers ellipsoid curvature for shortest path on Earth's surface. - Planar Distance: Calculates straight-line distance on a projected plane. |
DistanceCalculateMethod |
Retain geometry | Whether to preserve geometry in the result. Defaults to true . |
Boolean |
Retain attribute fields | Whether to retain all attribute fields in the result. Defaults to true . |
Boolean |
Query object ID field | Field to store IDs of queried objects. Multiple IDs are separated by commas. | String |
Proximity distance field | Field to store proximity distances. Multiple distances are separated by commas. | String |
Convert distance to meters | Whether to convert stored distances to meters. Valid only for geographic coordinate systems. | Boolean |
Output Result
Parameter Name | Description | Parameter Type |
---|---|---|
Result dataset | Output FeatureRDD requiring Save Vector Data tool to write to databases or local files. | FeatureRDD |
Notes
- Function Update: Starting from SuperMap 2025, the Geodesic Distance method is added. Use this for geographic coordinate systems to ensure accuracy .
- Ensure strict coordinate system consistency between the input and query datasets.