Tellurian.Geospatial

A strongly-typed, high-performance .NET library for geospatial calculations. Zero heap allocations - all types are value types optimized for tracking and real-time applications.

Features

• Calculate distances and bearings between coordinates
• Track positions along routes with cross-track and on-track distance
• Transform between geodetic (lat/lon) and planar grid coordinates (UTM, SWEREF99, RT90)
• Define geofences with circular and polygonal surfaces
• Full serialization support (System.Text.Json and DataContractSerializer)

Installation

dotnet add package Tellurian.Geospatial

Quick Start

Calculate distance and bearing between two positions

var stockholm = Position.FromDegrees(59.3262, 17.8420);
var london = Position.FromDegrees(51.5074, -0.1278);

var stretch = Stretch.Between(stockholm, london);

Console.WriteLine($"Distance: {stretch.Distance.Kilometers:F0} km");      // 1435 km
Console.WriteLine($"Direction: {stretch.Direction.Degrees:F1}°");         // 236.5°
Console.WriteLine($"Initial bearing: {stretch.InitialBearing.Degrees:F1}°"); // 227.5°

Find destination from a starting point

var start = Position.FromDegrees(58.0338, 11.7450);
var bearing = Angle.FromDegrees(97);
var distance = Distance.FromMeters(562);

var destination = start.Destination(bearing, distance);
// Position: 58.0332, 11.7545

Check if a position is within a geofence

var center = Position.FromDegrees(58.0724, 11.8233);
var geofence = new CircularSurface(center, Distance.FromMeters(100));

var vehicle = Position.FromDegrees(58.0725, 11.8235);
if (geofence.Includes(vehicle))
{
    Console.WriteLine("Vehicle is inside the geofence");
}

Track position along a route

var routeStart = Position.FromDegrees(58.0338, 11.7450);
var routeEnd = Position.FromDegrees(58.0332, 11.7545);
var route = Stretch.Between(routeStart, routeEnd);

var currentPosition = Position.FromDegrees(58.0333, 11.7502);

var crossTrack = route.CrossTrackDistance(currentPosition);  // Distance from route
var onTrack = route.OnTrackDistance(currentPosition);        // Progress along route

Console.WriteLine($"Off track: {crossTrack.Meters:F1} m");   // 15.9 m
Console.WriteLine($"Progress: {onTrack.Meters:F0} m");       // 311 m