driving_weather 0.1.1

Weather condition model for driving applications — snow, ice, visibility, and hazardous conditions detection. Precipitation type/intensity, wind speed, ice risk, and temperature monitoring. Includes O [...]

driving_weather

Weather condition model and provider abstraction for driving applications.

Features

• WeatherCondition — Equatable model with precipitation type/intensity, temperature, visibility, wind speed, and ice risk
• WeatherProvider — Abstract interface for pluggable weather data sources
• OpenMeteoWeatherProvider — Real weather from Open-Meteo (free, no API key) with offline fallback
• SimulatedWeatherProvider — Demo provider with a realistic mountain-pass snow scenario

Usage

import 'package:driving_weather/driving_weather.dart';

// Real weather from Open-Meteo (Nagoya region default)
final provider = OpenMeteoWeatherProvider(
  latitude: 35.18,
  longitude: 136.91,
);
await provider.startMonitoring();

provider.conditions.listen((condition) {
  print('${condition.precipType.name} ${condition.intensity.name}');
  print('Visibility: ${condition.visibilityMeters}m');

  if (condition.isHazardous) {
    print('⚠ Hazardous conditions detected');
  }
  if (condition.iceRisk) {
    print('⚠ Ice risk — temperature: ${condition.temperatureCelsius}°C');
  }
});

Simulated weather (for demos and testing)

final sim = SimulatedWeatherProvider(
  interval: Duration(seconds: 5),
);
await sim.startMonitoring();
// Cycles: clear → light snow → moderate → heavy → ice → clearing

Custom weather source

class MyFleetWeatherProvider implements WeatherProvider {
  // Implement the 4 methods: conditions, startMonitoring,
  // stopMonitoring, dispose
}

Model

Field	Type	Description
precipType	PrecipitationType	none, rain, snow, sleet, hail
intensity	PrecipitationIntensity	none, light, moderate, heavy
temperatureCelsius	double	Temperature in °C
visibilityMeters	double	10000 = clear, <1000 = reduced, <200 = hazardous
windSpeedKmh	double	Wind speed
iceRisk	bool	Black ice / road icing risk
timestamp	DateTime	Observation time

Convenience getters

• isSnowing — snow at any intensity
• hasReducedVisibility — visibility < 1 km
• isHazardous — heavy precip, very low visibility, or ice
• isFreezing — temperature ≤ 0°C

Safety

ASIL-QM — display and advisory only. Not for vehicle control.

See Also

• kalman_dr — Dead reckoning through GPS loss (tunnels, urban canyons)
• routing_engine — Engine-agnostic routing (OSRM + Valhalla)
• driving_consent — Privacy consent with Jidoka semantics (UNKNOWN = DENIED)
• fleet_hazard — Fleet telemetry hazard model and geographic clustering
• driving_conditions — Pure Dart computation models for road surface, visibility, and safety score simulation
• navigation_safety — Flutter navigation safety state machine and safety overlay
• map_viewport_bloc — Flutter viewport and layer composition state machine
• routing_bloc — Flutter route lifecycle state machine and progress UI
• offline_tiles — Flutter offline tile manager with MBTiles fallback

All ten extracted packages are part of SNGNav, a driver-assisting navigation reference product.