Location 542

From mn/ifi/inf5750
Jump to: navigation, search

Project description

Android Coordinate picker

This project's goal is to improve upon the existing DHIS2-android applications by expanding their common SDK to include support for use of Google Maps. In the existing DHIS2-android apps location selection is limited to only capture the coordinates where the user is located, which features no map interaction at all. This project will implement functionality such as having a map based point-and-click coordinate selector for TrackCapture- and EventCapture apps, among others, so the user can specify coordinates without being in that location.

Where the DHIS2 android application previously have only utilized the on-device GPS by clicking a button for obtaining the user location and storing it, we want this button to open a Google Maps fragment with the ability to place markers that indicate the desired location. The map should be launched with a marker that point to the user's location by default, but which can be moved by clicking the map and be saved when the user clicks save. 

See http://www.uio.no/studier/emner/matnat/ifi/INF5750/h15/group-projects/coordinate-picker/index.html for more information

Group members

  • Andreas Oven Aalsaunet
  • Erik Vesteraas
  • Yaron Okun
  • Øyvind Johansen Amundrud

Git repo


Summary of Requirements

Functional requirements

The user should be able to:

  • Choose his own location without loading map
  • See a map of his surroundings
  • See his own position on the map
  • Navigate by interacting directly with the map
  • Zoom in and out of the map
  • Cancel location the location choice
  • Easily get back to his own position on the map
  • See the coordinates for a chosen location

Non-functional requirements

  • Provided the device is connected to the internet, the map should load within 2 seconds

Decision Points

This section summarizes decisions that were taking into consideration, their status and the reason.

Decision to be made Status Further comments
The scope of this project is to improve the dhis2-sdk to enable dhis2 android-apps

to utilize Google Maps for selecting coordinates. TrackerCapture and EventCapture both

use the sdk for this, but only EventCapture can utilize the new functionality in the SDK without

major modifications. This projects want to exclude TrackerCapture from the scope and instead

focus on the SDK and EventCapture.

Approved 19.11.15:

Approved by Erling Fjellstad

Location 542-team have looked into the possibilities of caching Google Maps data, also

on the request of the product owner. This would better enable users to use the map without having

a stable internet connection. Unfortunately, this violates the Google Map APIs Terms of Service where

its said: "[..] No caching or storage. You will not pre-fetch, cache, index, or store any Content to be

used outside the Service [..]"

  • Section 10.5.d - Intellectual property restrictions [1]
  • Mobile Section [2]

Time schedule

Milestone 1: November 8th 

Task Status Comment
Document features and architecture on Wiki
Obtain understanding of DHIS2 android app
Look into Google Maps API
Set up development environment

Milestone 2: November 22th 

Task Status Comment
First bare-bone version of coordinate picker

Milestone 3: December 4th 

Task Status Comment
Finished, if applicable also with mobile app.

Final delivery: December 11th

Presentation: mid December

Screenshots and screen flows

Screenshot menu.png
First lo-fi prototypes 1
First lo-fi prototypes 2
Screenshot map.png

Documented learning during project

General Android development

Knowledge about the DHIS2 system

Collaborating as a diverse team

Suggested improvements to API

The GPS coordinates should be stored in a different format in the database. The format should also be consistent for all applications that use such coordinates. As per now, the coordinates in the Tracker Capture app are stored as strings, and the coordinates in the Event Capture app are stored as doubles, or floats. A more apropriate postgresql format would be for example GeoData.

Login android:

Android 4

Android 5


  • Username: android
  • Password: Android123

Link to sample android app



  • Set up the Wiki
  • Fork of the dhis2-android-sdk
  • Installed Android Studio
  • Tried to get Android Studio to work
  • Tried to understand SDK


  • Got Android Studio to work
  • Explored existing code base
  • Updated the Wiki
  • Consulted with a DHIS2 Android developer
  • Made the first UI design sketches


  • New fragment for picking coordinates
  • Integrate google maps API
  • More UI design


  • Uploaded first low-fidelity prototypes
  • Making Google Map appear in eventcapture
  • Fixed Google Play Service dependancies


  • Enable back button on activity bar


  • Adding ok and cancel buttons and interaction to coordinatePickerFragment.
  • Changing button design to follow conventions
  • Bug fixing
  • App working with map and buttons
  • Successfully get coordinates by usin buttons


  • Ran in to issues with android technical limitations when using Google Play services
  • Working on solving issue
  • Misc bugfixing


  • Investigated architectural structure of TrackerCapture
  • Removed ActionBar when showing CoordinatePicker
  • Focus map on location of user, or existing coordinate data


  • Added the functionality of placing a Google Maps marker at the user's current location
  • Added some comments and removed unused imports