open-weather-map-android-wrapper

Non-official API wrapper of OpenWeatherMap.org for Android made with Retrofit 2.0

Add to your project build.gradle

allprojects {
	repositories {
		...
		maven { url "https://jitpack.io" }
	}
}

Add to your app module build.gradle

dependencies {
        compile 'com.github.zurche:open-weather-map-android-wrapper:v0.1'
}

Also remember to add the INTERNET permission in your Manifest:

<uses-permission android:name="android.permission.INTERNET"/>

Check a usage example of this library here: https://github.com/zurche/color-weather

The wrapper currently supports the following endpoints of OpenWeatherMap API:

• 5 Day Forecast (https://openweathermap.org/forecast5)
• Current Weather (https://openweathermap.org/current)

OWService setup

To use the API you need a valid OpenWeatherMap API KEY, once you get it you are able to setup and create your OWService object:

private OWService mOWService = new OWService("<YOUR API KEY GOES HERE>");

You can configure it with the desired language and metric units in which you need the forecast temperatures retrieved:

mOWService.setLanguage(getActivity().getResources().getConfiguration().locale);
mOWService.setMetricUnits(OWSupportedUnits.METRIC);

five-day forecast

To retrieve 5 Days Forecast the library populates the ExtendedWeather object with the retrieved information. To set the location you need to get the weather forecast create a Coor object with the desired Lat/Lon value:

Coord coordinate = new Coord();
coordinate.setLat(-31.42);
coordinate.setLon(-64.18);

mOWService.getFiveDayForecast(coordinate, new OWRequestListener<ExtendedWeather>() {
      @Override
      public void onResponse(OWResponse<ExtendedWeather> response) {
          ExtendedWeather extendedWeather = response.body();
          //Do something with the object here!
      }

      @Override
      public void onFailure(Throwable t) {
          Log.e(TAG, "Five Day Forecast request failed: " + t.getMessage());
      }
  });

current-day forecast

To get the current day forecast you also need to send the Coord object with the Lat/Lon pair of the location to retrieve the weather from and the library will respond with a CurrentWeather object populated with the temperature information:

Coord coordinate = new Coord();
coordinate.setLat(-31.42);
coordinate.setLon(-64.18);

mOWService.getCurrentDayForecast(coordinate, new OWRequestListener<CurrentWeather>() {
    @Override
    public void onResponse(OWResponse<CurrentWeather> response) {
        CurrentWeather currentWeather = response.body();
        //Do something with the object here!
    }

    @Override
    public void onFailure(Throwable t) {
        Log.e(TAG, "Current Day Forecast request failed: " + t.getMessage());
    }
});

License

Copyright 2016 Alejandro Zürcher

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.