{"id":21769932,"url":"https://github.com/aerisweather/aerisandroidsdk","last_synced_at":"2026-01-11T17:46:43.820Z","repository":{"id":15863333,"uuid":"18603828","full_name":"aerisweather/AerisAndroidSDK","owner":"aerisweather","description":"AerisWeather Android SDK Demo App","archived":false,"fork":false,"pushed_at":"2023-07-03T13:06:47.000Z","size":94012,"stargazers_count":12,"open_issues_count":0,"forks_count":8,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-27T07:21:30.065Z","etag":null,"topics":["android","java","kotlin","maps","weather"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aerisweather.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.TXT","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-04-09T16:09:54.000Z","updated_at":"2022-11-02T19:19:39.000Z","dependencies_parsed_at":"2023-01-14T12:38:42.402Z","dependency_job_id":null,"html_url":"https://github.com/aerisweather/AerisAndroidSDK","commit_stats":null,"previous_names":["hamweather/aerisandroidlibrary"],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aerisweather%2FAerisAndroidSDK","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aerisweather%2FAerisAndroidSDK/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aerisweather%2FAerisAndroidSDK/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aerisweather%2FAerisAndroidSDK/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aerisweather","download_url":"https://codeload.github.com/aerisweather/AerisAndroidSDK/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248744024,"owners_count":21154792,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","java","kotlin","maps","weather"],"created_at":"2024-11-26T14:10:40.617Z","updated_at":"2026-01-11T17:46:43.778Z","avatar_url":"https://github.com/aerisweather.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"AerisWeatherAndroidSDK\n================\n\nThe AerisWeather Android SDK allows a developer to quickly and easily add weather content and functionality to their android applications. It utilizes the AerisWeather API backend for data loading and is built on top of an object mapping system that efficiently loads requested weather content into third-party Android applications, greatly reducing the amount of code and development needed on the developer end.\n\n## Getting Started \n\nView the latest installation and implementation details at AerisWeather under the [AerisWeather Android SDK toolkit documentation](http://www.aerisweather.com/support/docs/toolkits/aeris-android-sdk/getting-started/).\n\n### AerisWeather API Configuration for the AerisWeather Demo Applications\nBefore you can begin using the AerisWeather Android SDK in your project, you will need to download the latest version of the SDK and ensure that you have the required AerisWeather API keys for your application.\n\nStep 1: Get the files.  Download the latest version of the AerisWeather Android SDK. \n\nStep 2: Get access to the AerisWeather API. \n\nTo use the AerisWeather API, you will need to have valid access keys. Access keys are obtained by registering your application/namespace. To register your application, log in to AerisWeather with your account and look for \"APPS\". \nDon't have an AerisWeather account? You can get one for free here.\n\nStep 3: Determine which components of the AerisWeather Android SDK you need for your project:\n\n### AerisWeather Core library\nThis is the base library for accessing the AerisWeather API. If you are planning to use the AerisWeather API for data without a map component, this is all you need.\n\n### AerisWeather Map Library\nThis library provides access to AerisWeather mapping features such as radar, satellite, warnings, etc. \nThe map library includes a dependency on the AerisWeather Core library, so you won't need to download the Core library separately. If you are planning to use AerisWeather to create weather maps for your Android project, this is the library for you.\nStep 4: Include the AerisWeather Android SDK files in your project's Gradle.build file(s).\n\n## AerisWeather Demo Applications\nThe 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.\n\n### Sign up for the AerisWeather API service. Developer accounts are Free\nLog in to your account to register your application for an API access key. Each application requires its own unique access key. Check out the API docs for more info.*\n\nAdd 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.\n* The DemoApp namespace/package name can be found around line 3 of the manifest.xml file and will look similar to: **com.example.demoaerisproject**\u003cbr/\u003e\u003cbr/\u003e\n\n### Google Maps Configuration for the AerisWeather Demo Applications\nThe AerisWeather Maps library project currently supports only Google maps. To use the Google Maps API, you'll need to register for 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. \n\nOnce you have your Google Maps API account set up:\n\nOn the Services page, verify that the “Google Maps Android API v2” is enabled.\nIn the left navigation bar, click API Access.\nOn the resulting page, click Create New Android Key.\nIn the resulting dialog, enter the SHA-1 fingerprint, then a semicolon, then The Demo project’s package name. For example: FE:6D:DC:73:D5:22:C1:43:67:71:9F:65:93:AE:A6:66:6D:44:5A:75;com.example.demoaerisproject\nThe Google API Console responds by displaying a Key for Android apps (with certificates) followed by a forty-character API key.\n\nIn your Android project, update the meta tag in the Demo Project’s Manifest:\n\u003cpre\u003e\u003ccode class=\"java\"\u003e\u0026lt;meta-data\n            android:name=\u0026quot;com.google.android.maps.v2.API_KEY\u0026quot;\n            android:value=\u0026quot;your_api_key\u0026quot; /\u0026gt;\n\u003c/code\u003e\u003c/pre\u003e\nNote: Your SHA1 can be obtained in Android Studio by running the **\"signingReport\"** task under the **\"Gradle projects\"** section.\n\n### Permissions\nThe following permissions are required in order to use the AerisWeather Android SDK in the application. Please add these to your AndroidManifest.xml:\n\u003cpre\u003e\u003ccode class=\"java\"\u003e\u0026lt;manifest\u0026gt;\n    \u0026lt;uses-permission android:name=\u0026quot;android.permission.INTERNET\u0026quot;/\u0026gt;\n    \u0026lt;uses-permission android:name=\u0026quot;android.permission.ACCESS_NETWORK_STATE\u0026quot;/\u0026gt;\n    \u0026lt;uses-permission android:name=\u0026quot;android.permission.ACCESS_WIFI_STATE\u0026quot;/\u0026gt;\n    \u0026lt;uses-permission android:name=\u0026quot;android.permission.ACCESS_COURSE_LOCATION\u0026quot;/\u0026gt;\n    \u0026lt;uses-permission android:name=\u0026quot;android.permission.ACCESS_FINE_LOCATION\u0026quot;/\u0026gt;\n\u0026lt;/manifest\u0026gt;\n\u003c/code\u003e\u003c/pre\u003e\n### Gradle Configuration\nThe AerisWeather Core and AerisWeather Maps libraries are available through Maven Central. To add these dependencies to your project add these lines to your build.gradle file. \n\n**AerisWeather Core:**\n```diff\nrepositories {\n    mavenCentral()\n}\ndependencies {\n+   implementation 'com.aerisweather:aeris-core-lib:#.#.#@aar'         // kotlin \n-   compile 'com.aerisweather:aeris-core-lib:#.#.#@aar'                // java\n}\n```    \n\n**AerisWeather Maps:**\n\n(Note: you do not need to add AerisWeather Core seperately if you are using AerisWeather Maps - the core lib is referenced in the maps lib)\n```diff\nrepositories {\n    mavenCentral()\n}\ndependencies {\n+   implementation ('com.aerisweather:aeris-maps-lib:#.#.#@aar') {     // kotlin\n-   compile ('com.aerisweather:aeris-maps-lib:#.#.#@aar') {            // java\n        transitive true\n    }\n+   implementation 'com.google.android.gms:play-services-maps:#.#.#'   // kotlin\n-   compile 'com.google.android.gms:play-services-maps:#.#.#'          // java\n-   compile 'androidx.appcompat:appcompat:1.4.1'\n}\n```\n### Usage\n\nSpecify other locations (under Search) for alternates from your Android system default. \\\n\u003cimg height=\"400\" src=\"https://user-images.githubusercontent.com/116283403/199757704-e326efd1-e49b-43c7-a2d9-27b85df1a3ed.png\"/\u003e  \u003cimg height=\"400\" src=\"https://user-images.githubusercontent.com/116283403/199757758-ab874c6d-d8b4-44e6-b91f-00566ad7912e.png\"/\u003e  \u003cimg height=\"400\" src=\"https://user-images.githubusercontent.com/116283403/199757793-78e78d8e-c54b-460d-b367-570f169ec83d.png\"/\u003e  \u003cimg height=\"400\" src=\"https://user-images.githubusercontent.com/116283403/199760288-e617f3a6-520e-41a6-8c6a-879956d11640.png\"/\u003e\n\nEnable notification or use metrics under the settings panel. \\\n\u003cimg height=\"400\" src=\"https://user-images.githubusercontent.com/116283403/199758858-dc810488-8f5c-48d4-9bd7-844dcaca0a98.png\"/\u003e\n\nSpecify layers (under the menu) to customize the interactive map. \\\n\u003cimg height=\"400\" src=\"https://user-images.githubusercontent.com/116283403/199759416-eefd2a3e-c46b-4e3c-88da-2f060c0d0c91.png\"/\u003e  \u003cimg height=\"400\" src=\"https://user-images.githubusercontent.com/116283403/199759442-9b45c7a5-1502-4dfd-85f1-270377a81e26.png\"/\u003e\n\n### Android Studio \nVersion: [Chipmunk|2021.2.1 Patch2 or later](https://androidstudio.googleblog.com/2022/08/android-studio-chipmunk-202121-patch-2.html) \\\nAndroid Gradle Plugin Version 7.2.2 \\\nGradle Version 7.5.1.\n\n## Reference Links\n\n[AerisWeather API Docs](http://www.aerisweather.com/support/docs/api/).\u003cbr/\u003e\n[AerisWeather API Signup](http://www.aerisweather.com/signup/).\u003cbr/\u003e\n[AerisWeather Android SDK](http://www.aerisweather.com/support/docs/toolkits/aeris-android-sdk/).\u003cbr/\u003e\n[AerisWeather Android Core Library Javadocs](http://www.aerisweather.com/docs/android/Aeris/index.html).\u003cbr/\u003e\n[AerisWeather Android Maps](http://www.aerisweather.com/support/docs/toolkits/aeris-android-sdk/getting-started/weather-maps/).\u003cbr/\u003e\n[AerisWeather Android Maps Library Javadocs](http://www.aerisweather.com/docs/android/AerisMap/index.html).\u003cbr/\u003e\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faerisweather%2Faerisandroidsdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faerisweather%2Faerisandroidsdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faerisweather%2Faerisandroidsdk/lists"}