Files

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))