An open API service indexing awesome lists of open source software.

https://github.com/amejia481/whereismybusandroidclient


https://github.com/amejia481/whereismybusandroidclient

android android-client firebase-database maps

Last synced: about 1 month ago
JSON representation

Awesome Lists containing this project

README

        

# Log.i(TAG," :sunglasses: Where is My Bus Android App :sunglasses: ");

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][android_client], [iOS][iOS_repo] and [Web mobile][web_app_repo]) and one [tracker app][android_tracker_repo]. Each school bus has a low-end android device with the [tracker app][android_tracker_repo] installed in it, every time the buses move 20 meters the app pushes the new location to a [real-time firebase database][firebase_docs_database] and notify all the clients that the position has changed.

This is the home for the android client source code It is written using java. **We are open improvements**, if you like :heart_eyes: 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 [Google Maps][google_maps_docs], and [firebase][firebase_docs_database] please check the docs for any pre-configuration.

### 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 :clap:**.

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

### :muscle: 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.

### :fire: Related Repository :fire:
- [iOS App] [iOS_repo].
- [Android Tracker][android_tracker_repo].
- [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](https://github.com/Amejia481/whereIsMyBusiOSClient/graphs/contributors). :sparkling_heart:

### Extra Help

If you need help with the repo or you have any question, you can ask to Arturo mejia [email protected] or Angel Garcia [email protected], repository moderators.

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

:sparkles: **happy coding and have fun** :sparkles:.

[google_maps_docs]:
[firebase_docs_database]:
[iOS_repo]:
[android_tracker_repo]:
[android_client]:
[web_app_repo]:
[performace_android]:
[best_practice]:
[License]: