A repo containing a Clean City App for Android, free to use :)
The idea of the project is a one-button application with a camera for reporting an unauthorized dump. Quick and convenient for everyone to use. help to clean our beautiful world. In addition, all sorts of statuses and achievements for those who report a lot, sharing status, etc.
- open the application and take a photo of an unauthorized dump
- click send
- wait for the verification results
With the app, you can:
- use the site from a mobile device in one click
- sending a report with a photo and the current coordinates of the device to the server
- be notified of the result
- see the history of your requests and their statuses
- use status system for users (depending on the number of successful cleanups on user reports)
- share status in social networks.
- AR extension, to display already fixed points in the camera with luminous markers (so that when looking at the camera, the user immediately understands whether the dump is already damaged or not)
- Android API 21+
- Our test backend: https://ks-test-khack2019.herokuapp.com/
- Here you can read much more details (RUS) https://docs.google.com/document/d/1HgvS-FZP8SDTnoZsgeLydVq8MZwqYGhkIrDBZdUSJ8c/edit
Below you can see the scenario of using the camera, in case the user photographs not some landfill, but some other object. This is an extreme case UX, where the app will show a notification about a unsuitable object for reporting.
And here is a more realistic scenario with a photo of a real trash. The app processes the snapshot and sends the report to the server. A little later, you can see the result of the check.
Clone this repository and import into Android Studio
git clone https://github.com/daniily000/clean-city.git
Use the Android Studio Build Variants button to choose between production and staging flavors combined with debug and release build types
From Android Studio:
- Build menu
- Generate Signed APK...
- Fill in the keystore information (you only need to do this once manually and then let Android Studio remember it)
- Fork it
- Create your feature branch (git checkout -b my-new-feature)
- Commit your changes (git commit -m 'Add some feature')
- Run the linter (ruby lint.rb').
- Push your branch (git push origin my-new-feature)
- Create a new Pull Request
- Nikita - AR CORE - tg: @NikitaDroid
- Nikita - Android and positive mood - tg: @Nikita Lyutikov
- Daniily - Teamlead - tg: @daniily000
- Alex - Backend - tg: @slimlight
- Orina - Android and UI/UX - tg: @doldrums3