EarthQuake Watcher

Project Overview

EarthQuake Watcher is an Android application built using the Google Maps API while fetching data from the USGS API. This USGS API which is in the GeoJSON format allows for encoding variety of geographic data structures. EarthQuake Watcher leverages on this API to allow users keep track and monitor earthquake events occuring around the world. EarthQuake Watcher presents data gotten from the USGS API on the Google Map for the user to interact with.

Project Demo

Getting Started

You will need to have a Google Map API from the Google Developer Console to work with Google Maps. If you don’t already have an account, you will need to create one and also create a new project that uses the Map SDK for Android. After creating the project, create a new API key for that project. Use your API key as the value for google_maps_key in the google_maps_api.xml file under the values directory. Add the Package Name and the SHA-1 certificate fingerprint to the project.

Alternatively, follow the directions in this link to get started.

Prerequisites

• Android Studio IDE 3.0+
• Android SDK v28
• Gradle 5.1.1

Libraries

• Volley

Installing

• Fork the repository.
• Clone the repo using the terminal command. Make sure you replace username with your GitHub username.

git clone https://github.com/username/EarthQuake-Watcher.git 

Setting up EarthQuake Watcher

1. Download the EarthQuake Watcher project source. You can do this either by forking and cloning the repository (recommended if you plan on pushing changes) or by downloading it as a ZIP file and extracting it.

2. Open Android Studio, you will see a Welcome to Android window. Under Quick Start, select Import Project (Eclipse ADT, Gradle, etc.)

3. Navigate to the directory where you saved the android project, select the root folder of the project (the folder named "EarthQuake-Watcher"), and hit OK. Android Studio should now begin building the project with Gradle.

4. Once this process is complete and Android Studio opens, check the Console for any build errors.

• Note: If you receive a Gradle sync error titled, "failed to find ...", you should click on the link below the error message (if available) that says Install missing platform(s) and sync project and allow Android studio to fetch you what is missing.

5. Once all build errors have been resolved, you should be all set to build the app and test it.

6. Follow the instructions in the Getting Started section of this project

7. To Build the app, go to Build>Make Project (or alternatively press the Make Project icon in the toolbar).

8. If the app was built successfully, you can test it by running it on either a real device or an emulated one by going to Run>Run 'app' or pressing the Run icon in the toolbar.

Contributing

Contributions are always welcome. Simply fork the project and make a Pull Request.

Author

• Mayokun Adeniyi

License

Licensed under the MIT license.