# rain_viewer
Rust bindings to the free Rain Viewer API <https://www.rainviewer.com/weather-radar-map-live.html>
Provides easy access to satellite-imagery-style precipitation radar imagery
for the entire world.
## Example
```rust
#[tokio::main]
async fn main() {
    // Query what data is available
    let maps = rain_viewer::available().await.unwrap();
    // Pick the first past entry in the past to sample
    let frame = &maps.past_radar[0];
    // Setup the arguments for the tile we want to access
    // Parameters are x, y and zoom following the satellite imagery style
    let mut args = rain_viewer::RequestArguments::new_tile(4, 7, 6).unwrap();
    // Use this pretty color scheme
    args.set_color(rain_viewer::ColorKind::Titan);
    // Enable showing snow in addition to rain
    args.set_snow(true);
    // Smooth out the tile image (looks nicer from tile to tile)
    args.set_smooth(false);
    // Make an API call to get the time image data using our parameters
    let png = rain_viewer::get_tile(&maps, frame, args)
        .await
        .unwrap();
    //Check for PNG magic to make sure we got an image
    assert_eq!(&png[0..4], &[0x89, 0x50, 0x4e, 0x47]);
}
```
[`available`] is the entry point to obtaining radar imagery. This returns
historical data and forecast data that is available.
From there, most users call [`get_tile`] to download a PNG of a specific satellite tile.
License: MIT