DO NOT USE IN YOUR ROM!!! Read Commit Message

DO NOT MERGE in your own ROM! This isn't because we want to be assholes
about it but because OWM allows only 60 free calls per minute and the
more people that use this API key, the more calls are send their way. We
end up losing access and if you use this then you will lose access.

Nobody wins if you decide to use our keys.

Create your own, takes 30 seconds
https://openweathermap.org/appid#get

f6467bf
2 files changed
tree: a63cb117c275e90c91131dc06a8370f3d1d5b64f
  1. res/
  2. src/
  3. .gitignore
  4. Android.mk
  5. AndroidManifest.xml
  6. proguard-project.txt
  7. README.md
  8. yahoo-weather-condition-codes.xml
README.md

About

OmniJaws "Just another weather service" is a minimized service to fetch weather data from OpenWeatherMap or Yahoo. Thanks to http://openweathermap.org/ for providing an unrestricted API key

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-7.1/res/values/config.xml Check also here how this is used https://github.com/omnirom/android_packages_services_OmniJaws/blob/android-7.1/src/org/omnirom/omnijaws/OpenWeatherMapProvider.java

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-7.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/