Demo Android SDK App

The Xweather Android SDK includes a demo app to help get you started. To allow the demo project to access data using the Xweather Weather API, you will need to configure the Xweather Demo project to use your unique credentials. Just sign up for a free developer account and register yourself and your application with Xweather, to get your unique client Id and secret.

You can access the demo project on Github at: https://github.com/aerisweather/AerisAndroidSDK (opens in a new tab)

1. Sign up (opens in a new tab) for the Xweather Weather API service. Developer accounts are Free!
2. Log in to your account to register your application for an API access key. Each application requires its own unique access key. Check out the Xweather Weather API docs (opens in a new tab) for more info.*
3. Add the client_id and the secret_key to the res/values/strings.xml of the Demo application. Specifically, the aeris_client_id and aeris_client_secret values.

* The DemoApp namespace/package name can be found around line 3 of the manifest.xml file and will look similiar too: **com.example.demoaerisproject**

Configuring Google Maps

The Xweather Raster Maps library project currently supports only Google maps. To use the Google Maps API, you'll need to register for a an API key in the Google Maps API Console. Visit the Google Maps Android API page (opens in a new tab) and click the "GET A KEY" button for detailed instructions on getting your Google Maps key.

Once you have your Google Maps API account set up:

1. In the Services page, verify that the “Google Maps Android API v2” is enabled.
2. In the left navigation bar, click API Access.
3. In the resulting page, click Create New Android Key.
4. In the resulting dialog, enter the SHA-1 fingerprint, then a semicolon, then The Demo project's package name. For example: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75;com.example.demoaerisproject
5. The Google API Console responds by displaying Key for Android apps (with certificates) followed by a forty-character API key, for example: AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

In your Android project, update the meta tag in the Demo Project's Manifest:

<meta-data            
    android:name="com.google.android.maps.v2.API_KEY"            
    android:value="your_api_key">

Setup and configuration

If you've already read and completed the setup and configuration steps, you should be all set. If not, please refer to the SDK Installation page and verify that you have the necessary Xweather Weather API access, Android permissions, etc.