noaa_weather_client 1.3.0

A client library for the NOAA weather.gov API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

//! Basic usage example for the NOAA Weather Client
//!
//! This example demonstrates how to:
//! - Get point metadata for coordinates
//! - Fetch active weather alerts
//! - Get current weather observations
//! - Retrieve forecasts
//!
//! Run with: just example-basic
//! Or: cargo run --example basic_usage --manifest-path noaa_weather_client/Cargo.toml

use noaa_weather_client::apis::configuration::Configuration;
use noaa_weather_client::apis::{alerts, points, stations};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let config = Configuration::default();

    println!("NOAA Weather Client - Basic Usage Example\n");

    // Example coordinates (Kansas City, MO)
    let latitude = 39.7456;
    let longitude = -94.5692;
    println!(
        "Getting weather information for coordinates: {},{}",
        latitude, longitude
    );

    // 1. Get point metadata
    println!("\n[1] Getting point metadata...");
    match points::get_point(&config, latitude, longitude).await {
        Ok(point_data) => {
            let properties = &point_data.properties;
            println!("  Forecast Office: {:?}", properties.forecast_office);
            println!(
                "  Grid Coordinates: {},{}",
                properties.grid_x.unwrap_or(0),
                properties.grid_y.unwrap_or(0)
            );
            if let Some(time_zone) = &properties.time_zone {
                println!("  Time Zone: {}", time_zone);
            }
        }
        Err(error) => {
            eprintln!("  Error getting point data: {}", error);
        }
    }

    // 2. Get active weather alerts (limited to first 3)
    println!("\n[2] Getting active weather alerts...");
    let alert_params = alerts::ActiveAlertsParams::default();
    match alerts::get_active_alerts(&config, alert_params).await {
        Ok(alerts_data) => {
            println!("  Found {} active alerts", alerts_data.features.len());
            for (index, alert_feature) in alerts_data.features.iter().take(3).enumerate() {
                if let Some(properties) = &alert_feature.properties {
                    println!(
                        "    {}. {}",
                        index + 1,
                        properties.event.as_deref().unwrap_or("Unknown Event")
                    );
                    if let Some(areas) = &properties.area_desc {
                        println!("       Areas: {}", areas);
                    }
                }
            }
        }
        Err(error) => {
            eprintln!("  Error getting alerts: {}", error);
        }
    }

    // 3. Get stations near the point
    println!("\n[3] Getting nearby weather stations...");
    match points::get_point_stations(&config, latitude, longitude).await {
        Ok(stations_data) => {
            println!("  Found {} nearby stations", stations_data.features.len());

            // Try to get observation from the first station
            if let Some(first_station) = stations_data.features.first()
                && let Some(station_id) = &first_station.properties.station_identifier
            {
                println!("  Getting latest observation from station: {}", station_id);

                match stations::get_latest_observations(&config, station_id, None).await {
                    Ok(observation) => {
                        let props = &observation.properties;
                        println!(
                            "    Station: {}",
                            props.station_name.as_deref().unwrap_or("Unknown")
                        );

                        if let Some(temp) = &props.temperature
                            && let Some(temp_value) = temp.value
                        {
                            println!("    Temperature: {:.1} C", temp_value);
                        }

                        if let Some(desc) = &props.text_description {
                            println!("    Conditions: {}", desc);
                        }

                        if let Some(timestamp) = &props.timestamp {
                            println!("    Observed: {}", timestamp);
                        }
                    }
                    Err(error) => {
                        eprintln!("    Error getting observation: {}", error);
                    }
                }
            }
        }
        Err(error) => {
            eprintln!("  Error getting stations: {}", error);
        }
    }

    println!("\nExample completed!");
    println!("\nTry running other examples:");
    println!("   just example-alerts");
    println!("   just examples        # Run all examples");

    Ok(())
}