# Weather Web-Scraper

> **CAUTION**  
> The following utility is in EARLY developement. Many promises made in this
> readme might not actually be true. Hopefully one day we'll be out of beta ~and
> be releasing on time~

An utility to scrape italian weather websites to collect and compare weather
information

## Usage

> **WARNING**  
> The script is configured to run on Nix, and because of this is more
> complicated than it needs to be. You can remove unnecessary stuff if you're
> not running this on nix

The scraper collects data and arranges in the following scheme

```json
{
    "today": {
        "[0..23]": {
            "temperature": {
                "type": "number",
                "unitOfMeasurement": "degrees",
                "description": "expected temperature at the given hour"
            },
            "precipitation": {
                "type": "number",
                "unitOfMeasurement": "mm",
                "description": "expected precipitation at the given hour"
            },
            "weatherCode": {
                "type": "string",
                "description": "weather code (sunny / cloudy / ...)"
            }
        }
    },
    "tomorrow": {
        "[0..23]": {
            "temperature": {
                "type": "number",
                "unitOfMeasurement": "degrees",
                "description": "expected temperature at the given hour"
            },
            "precipitation": {
                "type": "number",
                "unitOfMeasurement": "mm",
                "description": "expected precipitation at the given hour"
            },
            "weatherCode": {
                "type": "string",
                "description": "weather code (sunny / cloudy / ...)"
            }
        }
    },
    "dayAfterTomorrow": {
        "[0..23]": {
            "temperature": {
                "type": "number",
                "unitOfMeasurement": "degrees",
                "description": "expected temperature at the given hour"
            },
            "precipitation": {
                "type": "number",
                "unitOfMeasurement": "mm",
                "description": "expected precipitation at the given hour"
            },
            "weatherCode": {
                "type": "string",
                "description": "weather code (sunny / cloudy / ...)"
            }
        }
    },
    "week": {
        "[0..6]": {
            "minimumTemperature": {
                "type": "number",
                "unitOfMeasurement": "degrees",
                "description": "minimum expected temperature for the day"
            },
            "maximumTemperature": {
                "type": "number",
                "unitOfMeasurement": "degrees",
                "description": "maximum expected temperature for the day"
            },
            "precipitationSum": {
                "type": "number",
                "unitOfMeasurement": "mm",
                "description": "total expected precipitation for the day"
            },
            "weatherCode": {
                "type": "string",
                "description": "weather code (sunny / cloudy / ...)"
            }
        }
    }
}
```

The keys for the `week` entry are intended as an offset from today. That is, the
object at `0` will be the results for today, the object at `1` will be the
results for tomorrow, and the object at `6` will be the results for 6 days from
now

### Sources

These are the sources that are currently implemented or will be implemented
eventually, together with the current level of implementation

```
✅ = implemented
🚧 = partially implemented
⛔️ = Not implemented
```

| Source                                               | Status | Comments                                 |
| ---------------------------------------------------- | ------ | ---------------------------------------- |
| [iLMeteo](https://www.ilmeteo.it)                    | 🚧     | Weather Code not working                 |
| [3Bmeteo](https://www.3bmeteo.com/)                  | 🚧     | Precipitation might not work as intended |
| [OpenMeteo](https://open-meteo.com/)                 | 🚧     | Weather Code are given in WMO Code       |
| [Meteo Aeronautica Militare](http://www.meteoam.it/) | ⛔️    |                                          |