82 lines
2.3 KiB
Python
82 lines
2.3 KiB
Python
"""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))
|