INF5750 - Autumn 2015

Android coordinate picker

DHIS 2 features a module called Tracker, which can be used to track patients who participate in health related programs. Such programs may be Malaria treatment and follow up, or Pregnancy follow ups (ANC) to name a few. In some cases coordinates need to be captured, and in this task you will implement a map based coordinate picker on Android.

The Tracker module is divided into two categories. Anonymous events, or tracked entities.

Anonymous events may for example be death registration forms, or clinical surveys. This submodule in DHIS 2 is called "Event Capture".

Examples of Tracked entity programs are Malaria follow up programs, school vaccination programs, or pregnancy followups. This submodule in DHIS 2 is called "Tracker Capture".

There already exist a web version and an Android version of these modules. You can test the web version by logging in to https://apps.dhis2.org/demo with username and password admin:district . You can test the Android version of the module by downloading either DHIS 2 Tracker Capture or DHIS 2 Event Capture from the Google Play store.

For logging in with Android use the same server, but use the username and password: android:Android123

Task definition

Your task is to implement a map based point-and-click coordinate selector for the existing applications. It is currently possible to capture coordinates using the on-device GPS, and by clicking on a button. This does however only allow for capturing the coordinates the user is currently located at. In some cases the coordinates the user wants to capture are not accessible in person perhaps. One example we have been given is inaccessibility due to crocodiles or thugs near Malaria infested mosquito breeding sites.

You are to integrate this into the existing code base of the applications. The two applications share a core SDK, so it needs only be implemented once to work for both apps.

Other parts of DHIS 2 already use Google Maps, and you may use it in your implementation.

The source code can be found on the DHIS 2 GitHub directory (links follow).

https://github.com/dhis2/dhis2-android-sdk
https://github.com/dhis2/dhis2-android-trackercapture
https://github.com/dhis2/dhis2-android-eventcapture