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.