Weather Livebook

Mix.install(
  [{:weather, "~> 0.4.0"}]
)

Getting Started

Fetching Fake Data

First, let’s make sure our dependencies installed correctly and ensure we can fetch some fake weather data. For this step, we don’t need an OpenWeather API Token.

opts = Weather.Opts.new!(test: "rain")
{:ok, fake_response} = Weather.API.fetch_weather(opts)
fake_response.body

Fetching Real Data

1. Create an API Key for the OpenWeather One Call API 3.0 here
2. Try running the block of code below. It will fail and you will see a message that looks like Missing secret "OPENWEATHER_API_KEY" with an “Add secret” button. Click the “Add Secret” button.
3. Enter your API key in the “Value” input (leave the “Name” input with the prefilled name of “OPENWEATHER_API_KEY”). Click “+Add”.
4. Reevaluate the block of code below. If everything worked correctly, you should see a “success!!” return value.

api_key = System.fetch_env!("LB_OPENWEATHER_API_KEY")
"success!!"

Now that we’ve configured our API Key, we can fetch some real weather data:

opts =
  Weather.Opts.new!(
    api_key: api_key,
    zip: "30-003,PL",
    units: "metric",
    twelve: false
  )

{:ok, real_response} = Weather.API.fetch_weather(opts)
real_response.body

If you don’t care about the raw response and just want some pretty output, you can use Weather.get!/1:

opts
|> Weather.get!()
|> IO.puts()

Examples

Setup:

api_key = System.fetch_env!("LB_OPENWEATHER_API_KEY")

opts =
  Weather.Opts.new!(
    api_key: api_key,
    latitude: 50.05905800533713,
    longitude: 19.937632449794567,
    label: "Kraków",
    units: "metric",
    twelve: false
  )

Fetch weather for every hour for the next 5 hours:

%Weather.Opts{opts | every_n_hours: 1, hours: 5}
|> Weather.get!()
|> IO.puts()

Lookup the latitude, longitude, and name of a location by ZIP code:

o = Weather.Opts.new!(api_key: api_key, zip: "60618,US")
{o.latitude, o.longitude, o.label}

View the temp in Fahrenheit using 12-hour time, for the next 48 hours, every 6 hours, using custom colors:

%Weather.Opts{
  opts
  | units: "imperial",
    twelve: true,
    hours: 48,
    every_n_hours: 6,
    color_codes: %{
      arctic: 30,
      freezing: 31,
      cold: 32,
      chilly: 33,
      cool: 34,
      mild: 35,
      warm: 36,
      hot: 37,
      very_hot: 38,
      scorching: 39
    }
}
|> Weather.get!()
|> IO.puts()