Models

Core data models used throughout the Breeze iOS app

Breeze uses strongly-typed Swift structs and enums to represent air quality, pollen, climate data, and user preferences. All models conform to Codable for seamless API integration.

Air Quality Models

AirQuality

The primary model for air quality data from the Open-Meteo API.

usAQI · Int · required

US Air Quality Index (0-500 scale)

pm25 · Double · required

Fine particulate matter ≤2.5 micrometers in µg/m³

pm10 · Double · required

Coarse particulate matter ≤10 micrometers in µg/m³

carbonMonoxide · Double · required

Carbon monoxide concentration in µg/m³

nitrogenDioxide · Double · required

Nitrogen dioxide concentration in µg/m³

sulphurDioxide · Double · required

Sulfur dioxide concentration in µg/m³

ozone · Double · required

Ground-level ozone concentration in µg/m³

BreezeApp/Models/AirQuality.swift

struct AirQuality: Codable {
    let usAQI: Int
    let pm25: Double
    let pm10: Double
    let carbonMonoxide: Double
    let nitrogenDioxide: Double
    let sulphurDioxide: Double
    let ozone: Double
    
    enum CodingKeys: String, CodingKey {
        case usAQI = "us_aqi"
        case pm25 = "pm2_5"
        case pm10
        case carbonMonoxide = "carbon_monoxide"
        case nitrogenDioxide = "nitrogen_dioxide"
        case sulphurDioxide = "sulphur_dioxide"
        case ozone
    }
}

AQIStatus

Provides human-readable status information based on AQI value.

text · String · required

Status label: “Excellent”, “Good”, “Moderate”, “Unhealthy”, etc.

emoji · String · required

Visual emoji representation (✨, 😊, 😷, 🚨, ☠️)

description · String · required

Friendly description of air quality conditions

color · String · required

Color theme identifier (e.g., “aqiGood”, “aqiUnhealthy”)

tips · [String] · required

Array of health tips and recommendations

BreezeApp/Models/AirQuality.swift

static func from(aqi: Int) -> AQIStatus {
    switch aqi {
    case 0...25:
        return AQIStatus(
            text: "Excellent",
            emoji: "✨",
            description: "Air quality is pristine! Perfect day for adventures.",
            color: "aqiGood",
            tips: [
                "Air is exceptionally clean right now",
                "No air quality concerns at this level"
            ]
        )
    case 26...50:
        return AQIStatus(
            text: "Good",
            emoji: "😊",
            description: "Air quality is great. Breathe easy!",
            color: "aqiGood",
            tips: [
                "Air quality meets health standards",
                "Pollutant levels are low"
            ]
        )
    // ... additional cases for Moderate, Unhealthy, Hazardous
    }
}

Pollutant Models

PollutantType

Enum representing individual air pollutants with their properties and thresholds.

BreezeApp/Models/Pollutant.swift

enum PollutantType: String, CaseIterable, Identifiable {
    case pm25 = "PM2.5"
    case pm10 = "PM10"
    case no2 = "NO₂"
    case so2 = "SO₂"
    case o3 = "O₃"
    case co = "CO"
    
    var fullName: String { /* ... */ }
    var description: String { /* ... */ }
    var icon: String { /* SF Symbol name */ }
    var goodLimit: Double { /* µg/m³ threshold */ }
    var moderateLimit: Double { /* µg/m³ threshold */ }
    var unit: String { return "µg/m³" }
}

pm25 · PollutantType

Fine Particulate Matter (PM2.5) - particles ≤2.5 micrometers

• Good limit: 12 µg/m³
• Moderate limit: 35.4 µg/m³
• Icon: wind

pm10 · PollutantType

Coarse Particulate Matter (PM10) - particles ≤10 micrometers

• Good limit: 54 µg/m³
• Moderate limit: 154 µg/m³
• Icon: cloud

no2 · PollutantType

Nitrogen Dioxide - from vehicle emissions

• Good limit: 53 µg/m³
• Moderate limit: 100 µg/m³
• Icon: car.fill

so2 · PollutantType

Sulfur Dioxide - from fossil fuel combustion

• Good limit: 35 µg/m³
• Moderate limit: 75 µg/m³
• Icon: building.2.fill

o3 · PollutantType

Ground-level Ozone - formed by sunlight and pollutants

• Good limit: 54 µg/m³
• Moderate limit: 70 µg/m³
• Icon: sun.max.fill

co · PollutantType

Carbon Monoxide - from incomplete combustion

• Good limit: 4400 µg/m³
• Moderate limit: 9400 µg/m³
• Icon: flame.fill

PollutantReading

Represents a single pollutant measurement with status calculation.

BreezeApp/Models/Pollutant.swift

struct PollutantReading: Identifiable {
    let id = UUID()
    let type: PollutantType
    let value: Double
    
    var status: PollutantStatus {
        if value <= type.goodLimit {
            return .good
        } else if value <= type.moderateLimit {
            return .moderate
        } else {
            return .unhealthy
        }
    }
}

Pollen Models

PollenItem

Unified model for displaying pollen types and plant-specific data.

id · String · required

Unique identifier (plant code or pollen type code)

name · String · required

Display name (e.g., “Grass”, “Tree”, “Oak”, “Birch”)

value · Int · required

Pollen index value (0-5 scale)

category · String · required

Category description from API (e.g., “Low”, “Moderate”, “High”)

isPlant · Bool · required

Whether this is a specific plant (true) or general pollen type (false)

imageUrl · String?

URL to plant image (only for plant-specific items)

family · String?

Botanical family name

season · String?

Pollination season description

appearance · String?

Visual characteristics of the plant

healthRecommendations · [String]?

Health tips and recommendations

BreezeApp/Models/PollenData.swift

var level: PollenLevel {
    switch value {
    case 0: return .none
    case 1: return .low
    case 2...3: return .moderate
    case 4: return .high
    case 5...: return .veryHigh
    default: return .low
    }
}

PollenLevel

Enum for pollen severity levels with color mapping.

BreezeApp/Models/PollenData.swift

enum PollenLevel: String {
    case none = "None"
    case low = "Low"
    case moderate = "Moderate"
    case high = "High"
    case veryHigh = "Very High"
    
    var colorName: String {
        switch self {
        case .none: return "levelNone"
        case .low: return "levelLow"
        case .moderate: return "levelModerate"
        case .high: return "levelHigh"
        case .veryHigh: return "levelExtreme"
        }
    }
}

Climate Models

ClimateDataPoint

Historical temperature data for climate trend visualization.

id · UUID · required

Auto-generated unique identifier

year · Int · required

Year of measurement (e.g., 1980, 1990, 2000, 2010, 2020)

temperature · Double · required

Maximum temperature in Celsius

BreezeApp/Models/ClimateData.swift

struct ClimateDataPoint: Identifiable {
    let id = UUID()
    let year: Int
    let temperature: Double
}

Location Models

City

Model for city search results and location data.

id · Int · required

Unique city identifier from geocoding API

name · String · required

City name

country · String?

Country name

admin1 · String?

Administrative region (state, province, etc.)

latitude · Double · required

Latitude coordinate

longitude · Double · required

Longitude coordinate

BreezeApp/Models/City.swift

var displayName: String {
    var components = [name]
    if let admin1 = admin1, !admin1.isEmpty {
        components.append(admin1)
    }
    if let country = country, !country.isEmpty {
        components.append(country)
    }
    return components.joined(separator: ", ")
}

var coordinate: CLLocationCoordinate2D {
    CLLocationCoordinate2D(latitude: latitude, longitude: longitude)
}

TopCity

Predefined cities for the ticker display on the landing page.

BreezeApp/Models/City.swift

struct TopCity {
    let name: String
    let country: String
    let lat: Double
    let lon: Double
    
    static let all: [TopCity] = [
        TopCity(name: "New York", country: "USA", lat: 40.7128, lon: -74.0060),
        TopCity(name: "London", country: "UK", lat: 51.5074, lon: -0.1278),
        TopCity(name: "Tokyo", country: "Japan", lat: 35.6762, lon: 139.6503),
        // ... 7 more cities
    ]
}

User Preference Models

AppearanceMode

Enum for theme selection (light, dark, system).

system · AppearanceMode

Follow system appearance settings (default)

light · AppearanceMode

Always use light mode

dark · AppearanceMode

Always use dark mode

BreezeApp/Models/AppearanceMode.swift

enum AppearanceMode: Int, CaseIterable, Identifiable {
    case system = 0
    case light = 1
    case dark = 2
    
    var displayName: String {
        switch self {
        case .system: return "System"
        case .light: return "Light"
        case .dark: return "Dark"
        }
    }
    
    var colorScheme: ColorScheme? {
        switch self {
        case .system: return nil
        case .light: return .light
        case .dark: return .dark
        }
    }
}

API Response Wrappers

AirQualityResponse

struct AirQualityResponse: Codable {
    let current: AirQuality?
}

GeocodingResponse

struct GeocodingResponse: Codable {
    let results: [City]?
}

PollenResponse

struct PollenResponse: Codable {
    let dailyInfo: [DailyPollenInfo]?
}

ClimateArchiveResponse

struct ClimateArchiveResponse: Codable {
    let daily: ClimateDaily?
}

Theme Colors

Breeze defines custom color extensions for consistent theming across the app.

Background Colors

appBackground · Color

Primary app background color (adaptive to light/dark mode)

cardBackground · Color

Card and surface backgrounds with improved contrast

• Dark mode: UIColor(white: 0.15, alpha: 1.0)
• Light mode: UIColor(white: 0.91, alpha: 1.0)

searchBarBackground · Color

Search bar background color

• Dark mode: UIColor(white: 0.2, alpha: 1.0)
• Light mode: UIColor(white: 0.92, alpha: 1.0)

AQI Status Colors

aqiGood · Color

Green color for Good air quality (#34c759)

aqiModerate · Color

Orange color for Moderate air quality (#ff9500)

aqiUnhealthySensitive · Color

Orange-red for Unhealthy for Sensitive Groups (#ff6b00)

aqiUnhealthy · Color

Red color for Unhealthy air quality (#ff3b30)

aqiVeryUnhealthy · Color

Purple color for Very Unhealthy (#af52de)

aqiHazardous · Color

Dark red for Hazardous air quality (#8e0000)

Pollen Level Colors

levelNone · Color

Green for no pollen (#34c759)

levelLow · Color

Green for low pollen levels (#34c759)

levelModerate · Color

Orange for moderate pollen levels (#ff9500)

levelHigh · Color

Red for high pollen levels (#ff3b30)

levelExtreme · Color

Dark red for extreme pollen levels (#8e0000)

Climate Trend Colors

climateNeutral · Color

Gray for neutral temperature change

climateCool · Color

Green for cooling trends (#34c759)

climateWarm · Color

Orange for warming trends (#ff9500)

climateHot · Color

Red for significant warming (#ff3b30)

BreezeApp/Extensions/Color+Theme.swift:3-40

extension Color {
    // MARK: - Background Colors
    static let appBackground = Color("Background")
    
    static let cardBackground = Color(UIColor { traitCollection in
        traitCollection.userInterfaceStyle == .dark
            ? UIColor(white: 0.15, alpha: 1.0)
            : UIColor(white: 0.91, alpha: 1.0)
    })
    
    // MARK: - AQI Colors
    static let aqiGood = Color(hex: "34c759")
    static let aqiModerate = Color(hex: "ff9500")
    static let aqiUnhealthySensitive = Color(hex: "ff6b00")
    static let aqiUnhealthy = Color(hex: "ff3b30")
    static let aqiVeryUnhealthy = Color(hex: "af52de")
    static let aqiHazardous = Color(hex: "8e0000")
    
    // MARK: - Pollen Level Colors
    static let levelNone = Color(hex: "34c759")
    static let levelLow = Color(hex: "34c759")
    static let levelModerate = Color(hex: "ff9500")
    static let levelHigh = Color(hex: "ff3b30")
    static let levelExtreme = Color(hex: "8e0000")
    
    // MARK: - Climate Colors
    static let climateNeutral = Color.gray
    static let climateCool = Color(hex: "34c759")
    static let climateWarm = Color(hex: "ff9500")
    static let climateHot = Color(hex: "ff3b30")
}