AR1/docs/analysis-tools/nearest.md

59 lines
1.3 KiB
Markdown

# Nearest Neighbor Analysis
Find nearest features from a target dataset for each feature in a source dataset.
## Overview
Nearest neighbor analysis identifies the closest features between two datasets, calculating distances and joining attributes.
## Inputs
- **Source Dataset**: Dataset to find nearest neighbors for
- **Target Dataset**: Dataset to search for neighbors
- **Max Distance**: Maximum search distance (optional)
- **Limit**: Maximum neighbors per feature (default: 1)
## Outputs
New dataset containing:
- Source feature geometry
- Nearest target feature information
- **Distance**: Distance to nearest neighbor
- Attributes from both datasets
## Example
```json
{
"source_dataset_id": 123,
"target_dataset_id": 124,
"max_distance": 5000,
"limit": 1
}
```
## Background Jobs
This analysis runs as a background job. See [Nearest Analysis Worker](../workers/nearest_analysis.md) for details.
## Use Cases
- Service accessibility analysis
- Nearest facility identification
- Distance calculations
- Spatial joins
## Notes
- Spatial indexes critical for performance
- Large max_distance values may slow processing
- Multiple neighbors can be found per feature
- Results include distance in dataset units
## Related Documentation
- [Nearest Analysis Worker](../workers/nearest_analysis.md)
- [Analysis API](../api/analysis.md)