Skip to content

Latest commit

 

History

History
240 lines (175 loc) · 9.83 KB

README.md

File metadata and controls

240 lines (175 loc) · 9.83 KB
Raw

Contributors Forks Stargazers Issues MIT License LinkedIn


Background Location Tracker

A dynamic geofence location tracking app for android
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Contributing
  5. License
  6. Contact
  7. Acknowledgments

About The Project

The Background Location Tracker is a powerful location tracking system that allows users to set custom geofences on a map, track their movements in the background, and receive notifications when they enter or exit the designated locations. This open-source project provides developers with a comprehensive solution for integrating background geofencing functionality into their mobile applications. For the demo of the above system, currently the app creates a notification to alert the user. Also, on going in the background, the app launches a foreground notification to display and update the realtime location.

The idea sprouted to me because I always forget to ping my mother on arrival of office, despite her remining me a million times. So, decided on making a system which would notify me when I have reached the office or any place, to just give her a ping. On discussion with a couple of friends, I realized this could have multitudes of scope. So, decided on uploading here for anyone to find and get motivation.

Do share with me any cool project that you create with reference. Please ignore the bad coding design. This app was created in a caffeine high state working a fulltime job. Much love ❤️

(back to top)

Technologies

AndroidStudio Android Kotlin

(back to top)

Map SDK

MapMyIndia

Getting Started

This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running follow these simple example steps.

Prerequisites

Installation

  1. Get the API key for MapMyIndia from https://www.mapmyindia.com/
  2. Clone the repo 
    git clone https://github.com/crypticguy/BackgroundLocationTracker.git
  3. Open the project using android studio (install from https://developer.android.com/studio)
  4. Create a secrets.xml file under app > src > main > res > values
  5. Enter the values for the following keys in secrets.xml 
    <string name="mapmyindia_rest_api_key">xxx</string>
<string name="mapmyindia_atlas_client_id">xxx</string>
<string name="mapmyindia_atlas_client_secret">xxx</string>
  6. Create an emulator or use a physical device
  7. Run the app

(back to top)

Roadmap

  • Integrate the callbacks into Android System
  • Send a notification to another device containing the app of arrival

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Vasu Goel - (@vgoel_) - vasu18322@iiitd.ac.in

Project Link: https://github.com/crypticguy/BackgroundLocationTracker

(back to top)