Log.i(TAG," 😎Location Tracker 😎 ");

Where is my bus is tool that helps students to track where their school buses are in real time. This project is composed by three clients apps (Android, iOS and Web mobile) and one tracker app. Each school bus has a low-end android device with the tracker app installed in it, every time the buses move 20 meters the app pushes the new location to a real-time firebase database and notify all the clients that the position has changed.

This is the home for the source code of the android app, is written using java and firebase BaaS. We are open improvements, if you like 😍 the app and think that there is something missing, or perhaps you want improve something, just do it!. We are looking forward to hear from you.

Where can I start?

You can give a look to open issues tab, there you can find new features and bugs reported.

Setting up

The app works using the Realtime database, for any doubt check the docs. you must create your own project on firebase console, the structure is below.

{
  "busses" : {
    "27_FEBRERO" : {
      "active" : false,
      "created" : 1465147579216,
      "latitude" : 18.48824786,
      "longitude" : -69.9176844,
      "name" : "27 de Febrero"
    },
    "CHARLES" : {
      "active" : false,
      "created" : 14651472579816,
      "latitude" : 18.4884583,
      "longitude" : -69.9176733,
      "name" : "Charles"
    }
  }
}

In order to authenticate you must create an user account in the firebase console, Auth section -> tab USER. and activated Email/password in Sign In Method tab

Pull Request

If you want to contribute make a pull request with your suggestions or new functionality, the project moderators will review and test your code, if everything is ok, they will add your changes. The name of the contributors would be published on the app info 👏.

Code Standards

• Write code and comments in english
• Try to follow android patterns and best practice [source 1] best_practice [source 2] performace_android

💪 Become Repository Moderator

If we notice that someone is very actives and has remarkable participation in the repo, would receive offer to become a repository moderator.

🔥 Related Repository 🔥

• [iOS App] iOS_repo.
• Android app.
• [Web App] web_app_repo.

Contributing

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Commit your changes: git commit -am 'Add some feature'
4. Push to the branch: git push origin my-new-feature
5. Submit a pull request and enjoy! :D

Contributors

Check out all the super awesome contributors at the contributors page. 💖

Extra Help

If you need help with the repo or you have any question, you can ask to Arturo mejia arturomejiamarmol@gmail.com or Angel Garcia angelrenegarcia13@gmail.com, repository moderators.

LICENSE

This work is licensed under a Creative Commons Attribution 4.0 International License.

✨ happy coding and have fun ✨.