/OmniJaws

Primary LanguageJava

About

OmniJaws "Just another weather service" is a minimized service to fetch weather data from OpenWeatherMap or Yahoo.

OpenWeatherMap API http://openweathermap.org/current

IMPORTANT: please request your own API key from OpenWeatherMap at https://openweathermap.org/appid#get and enter it here https://github.com/omnirom/android_packages_services_OmniJaws/blob/android-8.1/res/values/config.xml

Yahoo weather API https://developer.yahoo.com/weather/

Thanks to the original creators and contributors of the LockClock app https://github.com/CyanogenMod/android_packages_apps_LockClock

It provided a lot of insights and knowledge how to do this Some parts of the code like the provider access have been taken from it with minor modificatioons. Please check the file copyright headers for the origins of the files.

If you already include LockClock with your ROM you should consider if you really need this. The provider API is similiar and you dont need two different providers.

The default condition icon pack has also been extracted from LockClock

Client access

Here is a client code example using the content provider to access weather data https://github.com/omnirom/android_packages_services_OmniJaws/blob/android-8.1/src/org/omnirom/omnijaws/client/OmniJawsClient.java

Broadcasts and content observers

There are two ways to register for changes on weather data

Using ContentObserver on URI

content://org.omnirom.omnijaws.provider/weather

Using broadcasts

private static final String ACTION_BROADCAST = "org.omnirom.omnijaws.WEATHER_UPDATE";
private static final String ACTION_ERROR = "org.omnirom.omnijaws.WEATHER_ERROR";

Units

Depending on the value of the metric setting the following units are used to display the weather

Temperature:
metric = "C"
imperial = "F"

Wind speed:
metric = "km/h"
imperial = "mph"

Condition icon packs support

add activity with action "org.omnirom.WeatherIconPack" the name is used to defined the prefix for the image names default should be .weather.

		<activity
			android:name=".weather_vclouds"
			android:label="LockClock (vclouds)" >
			<intent-filter>
				<action android:name="org.omnirom.WeatherIconPack" />

				<category android:name="android.intent.category.DEFAULT" />
			</intent-filter>
		</activity>

An example can be found here https://github.com/maxwen/WeatherIconSample

Icons: Outline weather icon set is used with permission from http://emske.com/25-outline-weather-icons/