Forecast.io Java Wrapper

A Java wrapper library for the v2 Forecast API provided by The Dark Sky Company, LLC.

About

The Forecast API lets you query for most locations on the globe, and returns:

• Current conditions
• Minute-by-minute forecasts out to 1 hour (where available)
• Hour-by-hour forecasts out to 48 hours
• Day-by-day forecasts out to 7 days

Usage

You can pull this project via Maven:

Samples

A simple request for the current temperature:

// specify your API key
final String apiKey = "replace-with-your-key";
final ForecastIO forecastIO = new ForecastIO(apiKey);

// coordinates for Dresden, Germany
final double latitude = 51.0504d;
final double longitude = 13.7373d;

// retrieve the current forecast
final Forecast forecast = forecastIO.getForecastFor(latitude, longitude);

System.out.println("Current temperature is " + forecast.getCurrently().getTemperature());
System.out.println("Apparent temperature is " + forecast.getCurrently().getApparentTemperature());

Get sunrise and sunset time for the requested timezone:

// specify your API key
final String apiKey = "replace-with-your-key";
final ForecastIO forecastIO = new ForecastIO(apiKey);

// coordinates for New York, New York, United States
final double latitude = 40.7142d;
final double longitude = -74.0064d;

// retrieve the current forecast
final Forecast forecast = forecastIO.getForecastFor(latitude, longitude);

// get the forecast for today
final DailyDataPoint today = forecast.getToday();
// or forecast.getTomorrow();
// or forecast.getTodayInOneWeek();

// get the datetime for sunrise and sunset
final Date sunriseDate = today.getSunriseTime();
final Date sunsetDate = today.getSunriseTime();

// prepare time format with the correct timezone from the requested location
final SimpleDateFormat isoFormat = new SimpleDateFormat("HH:mm:ss", Locale.US);
isoFormat.setTimeZone(TimeZone.getTimeZone(forecast.getTimezone()));

// do whatever you want ;-)
System.out.println("Sunrise today was at " + isoFormat.format(sunriseDate));
System.out.println("Sunset today will be at " + isoFormat.format(sunsetDate));

Scala

If you`d like to use Scala instead, have a look at forecast-io-scala, which runs on top of Akka.