Initial commit - Trekker V2 source
This commit is contained in:
commit
d71faf19e3
65 files changed
+3615
No files matched your search
@@ -0,0 +1,81 @@
|
||||
"""Canonical route models: TrekkerRoute and its sub-models."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import uuid
|
||||
from datetime import datetime, timezone
|
||||
from typing import Any, Optional
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
|
||||
def utcnow_iso() -> str:
|
||||
return datetime.now(timezone.utc).isoformat()
|
||||
|
||||
|
||||
def new_id() -> str:
|
||||
return uuid.uuid4().hex
|
||||
|
||||
|
||||
class TrkPt(BaseModel):
|
||||
lat: float
|
||||
lon: float
|
||||
ele: Optional[float] = None
|
||||
time: Optional[str] = None # ISO 8601
|
||||
|
||||
|
||||
class Wpt(BaseModel):
|
||||
lat: float
|
||||
lon: float
|
||||
ele: Optional[float] = None
|
||||
time: Optional[str] = None
|
||||
name: Optional[str] = None
|
||||
desc: Optional[str] = None
|
||||
sym: Optional[str] = None
|
||||
type: Optional[str] = None
|
||||
|
||||
|
||||
class Segment(BaseModel):
|
||||
index: int
|
||||
name: str
|
||||
start_wpt: Optional[str] = None
|
||||
end_wpt: Optional[str] = None
|
||||
start_idx: int
|
||||
end_idx: int # inclusive index into route.points
|
||||
distance_m: float = 0.0
|
||||
elevation_gain_m: float = 0.0
|
||||
elevation_loss_m: float = 0.0
|
||||
grade_pct_avg: float = 0.0
|
||||
grade_pct_max: float = 0.0
|
||||
duration_s: Optional[float] = None
|
||||
|
||||
|
||||
class RouteStats(BaseModel):
|
||||
distance_m: float = 0.0
|
||||
elevation_gain_m: float = 0.0
|
||||
elevation_loss_m: float = 0.0
|
||||
elevation_min_m: Optional[float] = None
|
||||
elevation_max_m: Optional[float] = None
|
||||
duration_s: Optional[float] = None
|
||||
|
||||
|
||||
class TrekkerRoute(BaseModel):
|
||||
id: str = Field(default_factory=new_id)
|
||||
name: str = "Unnamed route"
|
||||
source: str = "manual" # gaia | onx | manual
|
||||
trail_guide_id: Optional[str] = None
|
||||
points: list[TrkPt] = Field(default_factory=list)
|
||||
waypoints: list[Wpt] = Field(default_factory=list)
|
||||
segments: list[Segment] = Field(default_factory=list)
|
||||
stats: RouteStats = Field(default_factory=RouteStats)
|
||||
metadata: dict[str, Any] = Field(default_factory=dict)
|
||||
created_at: str = Field(default_factory=utcnow_iso)
|
||||
updated_at: str = Field(default_factory=utcnow_iso)
|
||||
|
||||
def bounds(self) -> Optional[tuple[float, float, float, float]]:
|
||||
"""(min_lon, min_lat, max_lon, max_lat) or None for empty routes."""
|
||||
if not self.points:
|
||||
return None
|
||||
lats = [p.lat for p in self.points]
|
||||
lons = [p.lon for p in self.points]
|
||||
return (min(lons), min(lats), max(lons), max(lats))
|
||||
Reference in new issue
Block a user