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

  1. Function Update: Starting from SuperMap 2025, the Geodesic Distance method is added. Use this for geographic coordinate systems to ensure accuracy .
  2. Ensure strict coordinate system consistency between the input and query datasets.