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