1. Help Center
  2. Documentation
  3. Toolkits
  4. Android SDK
  5. Getting Started

Android SDK

AerisWeather Demo App

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

  1. Sign up for the AerisWeather 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 AerisWeather API docs 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**

Google Maps Configuration for the AerisWeather Demo App

The AerisWeather 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 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 Config

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 AerisWeather API access, Android permissions, etc.

GitHub

If you would prefer to skip right to the code, the demo project lives on Github at: https://github.com/aerisweather/AerisAndroidSDK

Last modified: July 27, 2021