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.