Status: Draft
== Project description ==
The Upload to Commons Android app allows users to easily upload pictures from their mobile device to the Wikimedia Commons database. This project improves the image categorization functionality of the app by offering relevant category suggestions based on geolocation, and making category search more flexible.
=== Category suggestions based on geolocation ===
If a picture with geolocation is uploaded, nearby category suggestions are offered based on the categories of other nearby Commons images. We query the Commons MediaWiki API for the Commons categories of pictures with geolocation within a radius of 10km of the uploaded pic's geolocation. The categories found are also cached using the quadtree library, so that if another picture with similar geolocation is uploaded, the cached categories are displayed and the API is not queried. This is done to reduce the load on the API, as people often upload several pics with similar locations.
**Example 1: Uploading an image of the Hamilton Gardens with geotagging enabled in phone camera:**
Entering the title and description:
{F3410234}
Category suggestions obtained:
{F3410243}
If a picture with no geolocation is uploaded, nearby category suggestions are offered based on the user's current location. This is optional and only works if enabled in Settings.
=== More flexible category search ===
Category search (when typing in the search field) has been made more flexible
== Missing features/known bugs ==
The list of missing features and known bugs can be found on [[ https://github.com/nicolas-raoul/apps-android-commons/issues | GitHub issues ]].
== Links ==
- Google Play download: https://play.google.com/store/apps/details?id=fr.free.nrw.commons
- GitHub [[ https://github.com/nicolas-raoul/apps-android-commons | project page ]]
- #commons-app-android-upload board on Phabricator
- Documentation:
- GitHub [[ https://github.com/nicolas-raoul/apps-android-commons/wiki/Category-suggestions-(readme) | wiki ]] summary
- MediaWiki [[ https://www.mediawiki.org/wiki/Wikimedia_Apps/Commons | manual ]]
- Commons [[ https://commons.wikimedia.org/wiki/Commons:Mobile_app | manual ]]