Weather Wise

Overview

Welcome to Weather Wise, a Python module for accurate and reliable weather information. Weather Wise uses the National Weather Service (NWS) to fetch the current weather forecast and other weather-related details from a zipcode. This module uses the U.S. Census 2022 Gazetteer (Zip Code Tabulation Areas). The original file has been modified to JSON.

Usage

import json
from weather_wise.weather_wise import WeatherWise

weather = WeatherWise("32904")

# Internal weather methods.
print(weather._load_json_data())
print(weather._get_latitude_longitude())
print(weather._get_weather_forecast_url())
print(json.dumps(weather._get_weather_data(), indent=2))

# Get the short forecast.
short_forecast = weather.get_short_forecast()
print(short_forecast)

# Get the temperature in fahrenheit.
temperature_in_fahrenheit_with_unit = weather.get_temperature_in_fahrenheit(temperature_unit=True)
temperature_in_fahrenheit = weather.get_temperature_in_fahrenheit()
print(temperature_in_fahrenheit_with_unit)
print(temperature_in_fahrenheit)

# Get the temperature in celsius.
temperature_in_celsius_with_unit = weather.get_temperature_in_celsius(temperature_unit=True)
temperature_in_celsius = weather.get_temperature_in_celsius()
print(temperature_in_celsius_with_unit)
print(temperature_in_celsius)

# Get the probability of precipitation.
probability_of_precipitation_with_unit = weather.get_probability_of_precipitation(percentage_unit=True)
probability_of_precipitation = weather.get_probability_of_precipitation()
print(probability_of_precipitation_with_unit)
print(probability_of_precipitation)

# Get the relative humidity.
relative_humidity_with_unit = weather.get_relative_humidity(percentage_unit=True)
relative_humidity = weather.get_relative_humidity()
print(relative_humidity_with_unit)
print(relative_humidity)

# Get the wind speed.
wind_speed = weather.get_wind_speed()
wind_speed_without_unit = weather.get_wind_speed(wind_unit=False)
print(wind_speed)
print(wind_speed_without_unit)

# Get the wind direction.
wind_direction = weather.get_wind_direction()
print(wind_direction)

# Get the weather icon url.
icon_url = weather.get_weather_icon_url()
print(icon_url)

References

• Gazetteer Files

  • https://www.census.gov/geographies/reference-files/time-series/geo/gazetteer-files.html

• API Documentation

  • https://www.weather.gov/documentation/services-web-api

• API Discussion

  • https://github.com/weather-gov/api/discussions

• Outage & Status Messages

  • https://www.nco.ncep.noaa.gov/status/messages/

TODO

• Get severe weather alerts.
  • Active Alerts
    • https://api.weather.gov/alerts/active?point=38.9807,-76.9373
  • All Alerts
    • https://api.weather.gov/alerts?point=38.9807,-76.9373