NGeoKDBush 1.0.1
Install-Package NGeoKDBush -Version 1.0.1
dotnet add package NGeoKDBush --version 1.0.1
<PackageReference Include="NGeoKDBush" Version="1.0.1" />
paket add NGeoKDBush --version 1.0.1
#r "nuget: NGeoKDBush, 1.0.1"
// Install NGeoKDBush as a Cake Addin
#addin nuget:?package=NGeoKDBush&version=1.0.1
// Install NGeoKDBush as a Cake Tool
#tool nuget:?package=NGeoKDBush&version=1.0.1
NGeoKDBush
This library allows indexing geographical points, and then querying for all points of interest that are some distance from some location. The points will be returned ordered by being closet to furthest.
It implements fast nearest neighbors queries for locations on Earth, taking Earth curvature and date line wrapping into account. Direct port of geokdbush which itself was inspired by sphere-knn, but uses a different algorithm.
A geographic extension for nkdbush.
Example
var index = new KDBush<City>(cities.ToArray(), p => p.Lon, p => p.Lat);
var geoKdBush = new GeoKDBush<City>();
var nearest = geoKdBush.Around(index, -119.7051, 34.4363, 5);
API
Around(IKDBush<T> index, double lng, double lat, int? maxResults = null, double? maxDistance = null, Predicate<T> predicate = null)
Returns an array of the closest points from a given location in order of increasing distance.
index
: nkdbush index.lng
: query point longitude.lat
: query point latitude.maxResults
: (optional) maximum number of points to return (int.MaxValue
by default).maxDistance
: (optional) maximum distance in kilometers to search within (double.MaxValue
by default).predicate
: (optional) a lambda to filter the results with.
Distance(double lng, double lat, double lng2, double lat2)
Returns great circle distance between two locations in kilometers.
Performance
I have found the performance of this port fast enough for my purposes, so I haven't yet had the justification to run micro-bechmarks.
However, I'm sure many performance improvements are possilbe and I might get to it someday.
Product | Versions |
---|---|
.NET | net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows |
.NET Core | netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1 |
.NET Standard | netstandard2.0 netstandard2.1 |
.NET Framework | net461 net462 net463 net47 net471 net472 net48 |
MonoAndroid | monoandroid |
MonoMac | monomac |
MonoTouch | monotouch |
Tizen | tizen40 tizen60 |
Xamarin.iOS | xamarinios |
Xamarin.Mac | xamarinmac |
Xamarin.TVOS | xamarintvos |
Xamarin.WatchOS | xamarinwatchos |
-
.NETStandard 2.0
- NKDBush (>= 1.0.0)
- OptimizedPriorityQueue (>= 4.1.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.