Struct GnssPosition 

pub struct GnssPosition {
    pub latitude: f64,
    pub longitude: f64,
    pub timestamp: DateTime<FixedOffset>,
    pub crs: String,
    pub metadata: HashMap<String, String>,
}

Represents a single GNSS measurement from a train journey

Each GnssPosition captures a timestamped geographic location with explicit coordinate reference system (CRS) information. Additional metadata can be preserved for audit trails and debugging.

Validation

• Latitude must be in range [-90.0, 90.0]
• Longitude must be in range [-180.0, 180.0]
• Timestamp must include timezone information (RFC3339 format)

Examples

use tp_core::GnssPosition;
use chrono::{DateTime, FixedOffset};

let timestamp = DateTime::parse_from_rfc3339("2025-12-09T14:30:00+01:00")?;

let position = GnssPosition::new(
    50.8503,  // latitude
    4.3517,   // longitude
    timestamp,
    "EPSG:4326".to_string(),
)?;

assert_eq!(position.latitude, 50.8503);
assert_eq!(position.crs, "EPSG:4326");

Fields

latitude: f64

Latitude in decimal degrees (-90.0 to 90.0)

longitude: f64

Longitude in decimal degrees (-180.0 to 180.0)

timestamp: DateTime<FixedOffset>

Timestamp with timezone offset (e.g., 2025-12-09T14:30:00+01:00)

crs: String

Coordinate Reference System (e.g., “EPSG:4326” for WGS84)

metadata: HashMap<String, String>

Additional metadata from CSV (preserved for output)

Implementations

impl GnssPosition

pub fn new( latitude: f64, longitude: f64, timestamp: DateTime<FixedOffset>, crs: String, ) -> Result<Self, ProjectionError>

Create a new GNSS position with validation

pub fn validate_latitude(&self) -> Result<(), ProjectionError>

Validate latitude range

pub fn validate_longitude(&self) -> Result<(), ProjectionError>

Validate longitude range

pub fn validate_timezone(&self) -> Result<(), ProjectionError>

Validate timezone is present (type-level guarantee with DateTime<FixedOffset>)

Trait Implementations

impl Clone for GnssPosition

fn clone(&self) -> GnssPosition

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GnssPosition

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GnssPosition

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GnssPosition

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.