ANDROID MOBILE CLIENT USER MANUAL Contents
Contents
1. Back to top 2 6 2 Server UR Gateway URL This option specifies the URL for the gateway that facilitates the upload and download of data between the server and the mobile phone There are various options that are compatible with different versions of the application The default option is usually the one compatible with the version of the application installed The full URL is usually shown in a text area The default option is the one that currently works with the version of the application and should not be altered unless advised to do so Back to top 2 6 3 GPS time delay for routing This setting is used to specify the interval of time after which the application fetches GPS coordinates when doing a routing exercise The units are in seconds and the default value is 3 seconds A lower value indicates that the application fetches the GPS coordinates more frequently For high GPS accuracy set the value for this setting to zero 0 and select Done in the popup menu to save the changes Back to top 2 6 4 GPS horizontal accuracy This setting indicates the accuracy in terms of meters after which the application tries to fetch GPS coordinates afresh The default value is O meters which gives the highest possible accuracy A lower value indicates higher accuracy Please note that the GPS accuracy also depends on the quality of GPS receiver on the device visibility of the satellite affected by weather changes and an open are2. Q PoiMapper ANDROID MOBILE CLIENT USER MANUAL Contents o OVERVIEW reir 5 1 1 Basic Hardware Requirements a 5 1 2 Installation Proced UTE conato pitos dace iniciacion pdtani 5 2 OPENING AND USING THE APPLICATION ooccccccnncccnoconocnnnnonoconononnconnnnonononnnnnnnnnnnonnnnnnnronannnnnonncnnnnnoncnnnnnnnnnnnnnnnos 5 DoD e cin ene pease caso e e RN 8 ZA LOPS COON GIM GAUSS scada E tage deneresacenes 11 Pe Ca UU Mae PA ME o uo III AAA 13 ZN EW MALES airoso 14 ZN a e o A A E ee E Fo OO 15 A A e o O O E E E 16 D2 o o o e o e 17 A A o Pe 19 A A E ass 21 ZIAD Cancel OMA PO Losa 22 A uo II A PA 23 PNT VO AG o NVE e e o O O A 25 2 5 Download TOME SV ers lalas 27 LO SI do 29 A A e e II e ESO 30 205 2 Sever UR UG abe Way UN isa aaa 31 26 3 GPS time delay Tor COU CWS sa raaricico tect nica endo NN 31 ZG OPS NONZOntal CC WN CY ii aros 31 AN nn e nO eevee 31 2 0 0 GPS Taree accuracy Metals arco isc nino 31 2 6 7 Manual OF Automatic GPS NAVY di 31 Q PoiMapper 2 6 8 Automatic Manual data Upload snenia E 32 AA A o E o A 32 Fi WO SOU AVRO Ae A ee liUN E E e o 32 2 6 11 Enable Reset database rot rot aa EEEO EN Ranei 33 Done WSS taplo ULOT PW O orren a E E E E noes 34 IAS A E A sea noui eee in secea ea II 34 PG AA ROSS UCU CY COE oie 34 2 6 15 Next moves focus to radio buttons and CheckboxesS ccccccoooonnccnnccnnonoccnnnnncnnaccnnnnononanocncncnnnnnarcnononnnnos 35 2 Update O Mempo les aT E 35 Se DATA TRAN
3. as explained in section 2 6 8 30 H mi 09 15 Page le 11 2 fo GPS Accuracy 1233 Target 20 metres Current 1233 Time 1 minutes Stop l atitrida larmmitirna Figure 12 The application attempting to fetch GPS coordinates showing the GPS accuracy header Back to top 12 Q PoiMapper rt 2 1 2 Capturing image s To capture an image the camera icon is usually shown next to the image question or on the top right corner of the form Note For this icon to be shown here the form has to be enabled to attach images on the server form builder This is shown in the figure 13 below Image question Previous Figure 13 The camera icon for capturing an image in the top right corner of the page Back to top To take a picture tap the camera icon on the screen There is also the option of attaching images to a specific question on a form Such questions are called image questions Note For this to work the specific question has to be enabled on the server form builder to attach images If it has been enabled a camera icon appears next to the question This icon can be used to capture images and the images will only be for that specific question and not the whole form On capturing an image the captured image is added to the new POI or the question for the first case and image questions respectively and control goes back to the already captured images to view or capture more images There is a limit
4. NB 1 Downloading data from the server using the mobile application may be time consuming depending on the nature of the data downloaded and the quality of the Internet connection It 27 Q PoiMapper rt is advisable to download only the data required on the mobile phone In addition a lot of data downloaded on the phone may slow down the application Data rates for the mobile operator apply 2 Only Forms that are under the given user s locations are downloadable by the given user using the mobile application There is also the option of selecting the image size to download There are four options provided for this download Original Medium Small or no images The Original Image download is not recommended because if there are many images to be downloaded then the download process will be slower especially for weaker internet connections The Default is the medium size that is optimised for fast download Smaller images can as well be downloaded or no images download at all This is shown in figure 36 below E SETI 20 30 E Poimappar TTS Download only my POIs Yes No Download only selected POI types Complete Area Tracing Form Complete Route Tracking Form Complete testing formv2 Download Needs editing data Figure 35 The screen displayed for select download criteria of data from the server Back to top 28 Q PoiMapper Download Needs editing data Download image size Original not
5. POI type or form is selected the first page of the form is loaded on the screen Figure 7 below shows the first page of the Health Monitoring form Mandatory fields must be filled in by the user in order to save the POI Mandatory fields are marked with an asterisk If a mandatory field is not filled pressing the Done command will display a message Check mandatory fields Mandatory field X on Page Y where X is the name of the field and Y is the page number of the form see Figure 10 The Next command at the bottom of the page is used to navigate to the page that follows the current page of the form Also one can jump to a given page by selecting the Next page command at the bottom of the page Pressing Previous at the bottom of the page navigates to the previous page Pressing the Back option on the phone saves the entered data as a draft and can be found under Main Menu gt Edited data gt Drafts To go to a specific page in the form select the page name number from the popup menu that appears on pressing the form header The Goto commands on the popup menu are the links to the specific page numbers or names See Figure 9 One can also add a comment to a POI by selecting the Add Comments option in the menu if the comments field has been enabled for that form on the Form Builder on the server Q PoiMapper Se GPS Accuracy 1195 Target 20 metres Latitude Longitude 1 2723157 36 80337
6. command when a POI has some Captured images ooccccccnnccncncnnnaconacononcnonononcnnoncnonconono 15 Elieure 17 The CaCl COV aN ticas T TEE 16 Figure 18 An alert message displayed after clicking cancel oooccoocnncocnnonocnonarononcononcononacnnnacnnoncnnoncnnonnononannnos 16 Figure 19 The Done command in the popup menu for saving the data oocccoccnncncnnonncnnnnonnnacononcnncnacnnnannnos 17 Figure 20 Edited data menu as shown in the Main MENU occoccccncccnncnnncnnnncnnncnnnnnnnconnnnnnononnonnrrnnnnnonoronnnnnnnnnnnnons 18 Figure 21 A list of the created modified POIs grouped by POI types Or fOrMS ccccccnnnnccccnnnnnnocccnnnnnonnnrononononananoss 18 Figure 22 A list of POIs under the Market place info fOrM oocccoocnnnncnncncnnonacnnnncononcnnoncononnononcnnoncnnoncnncnncnononnns 19 Figure 23 update GPS Coordinates DuttON ccccccesccsscccseccsecccecccseceeucesseceseceeeeeseeeceuceeaeeseuceeuceseeeseeeeaaeeseeeeeseenees 20 Figure 24 The prompt shown to the user when the GPS button is clicked ooccoocccocnonocnnnannnnnnnncnnnncnnnnnnoss 20 Figure 25 The Delete command in the Options MENU occccoccncnncnnnncnnnncnnoncnnnnacnnnnrononcononcononnononononnrnnoncrnoncncnnonnns 21 Figure 26 The prompt shown when the delete command is selected oocccocccoocnnonnnncnnnaconncnnnacnonononcnnoncnononnons 22 Figure 2 5 The Cancel consista ico italiano rienda 22 Figure 28 Browse d
7. data menu be uploaded prior to doing a survey update since there might be incompatibilities brought by new changes to a form The application prompts the user to restart it once a survey update is completed successfully However whenever data is uploaded or downloaded from the server the form templates are as well updated automatically Back to top 35 Q PoiMapper 3 DATA TRANSFER 3 1 Configuring the Application The PoiMapper application must be configured with the relevant application files for the survey user login credentials and location hierarchy if any 3 1 1 Using the Over the Air option Recommended This is the cheapest option when it comes to configuring the application on the phone so that you can log in and start collecting data To have an over the air configuration start the application from the application menu In order to use any of the above options one has to specify a valid username password and database Every organization has its own unique database whose details are given to the contact person After specifying the log in credentials select Download button and wait for the application to download all the necessary configuration files from the server NB The user must be having a valid username and password and there should be a survey linked to the user for the application to be configured effectively TEIE Vi HAWLA tU IUI Password Figure 44 The configuration form shown wh
8. screen displayed after scrolling down the settings Menu occcocccnncnnnccnnnnnnncnnnaconacnnnononanonacnnnanananons 30 NAS SCT VES may lA oo y A 32 The option of resetting the database in settings occoocccnncnnncnnncnnnannnnnnnncnonananarnnoncnnannnnanonanonarnnnanonanons 33 Resettine the dataDdS Suicidio 33 The option of resetting the security code on the settings Menu ooccoccccnccnnnnonncnnnannnannnannnoncnnannnnanananons 34 Next moves focus to radio buttons and Checkboxes cccoocccccccoccnnnconaccnnnononcnnnnonanonononncnnnonononannnonanennss 35 The configuration form shown when the application is run for the first tiM oocccocccncnonccnncnonannnos 36 Warning message when closing the application oocooocccocnoncnncncnoncnnonononcncncnnonononrononononcnonrononononoss 39 Q PoiMapper 1 OVERVIEW PoiMapper mobile client application software is used to gather data from the field using mobile phones The application is developed and maintained by Pajat Management Oy http www pajat solutions com The application includes a pre defined form or set of forms that are exported from the database to the phone either via the Internet on the phone OTA or desktop client application The form s can be filled and the data saved for further analysis and visualization The solution caters for more advanced needs in data collection such as filling check box type questionnaires taking images of objects of interest a
9. 37 Figure 7 First page of the health monitoring form Back to top iiil 20 09 Multiple birth Urinary tract infection Depression Miscarriage High risk for preterm birth Specify other issues if any Previous Done Figure 8 The second page of the health monitoring form Back to top 10 Q PoiMapper Figure 9 The option of going directly to a specific page Back to top AR He ml 20 10 i Alert Check mandatory field Name on page Page 1 Figure 10 The alert displayed when the user attempts to save without a mandatory field saved Back to top 2 1 1 GPS coordinates When user selects Add data and the form has the GPS coordinates field the application tries to get the GPS coordinates in the background When the GPS coordinates are fetched the GPS Latitude and Longitude fields are updated 11 Q PoiMapper 100 amp 14 40 gt Pa Page PageO GPS Accuracy 133 Target 20 metres Continue Stop Latitude Longitude Cancel Figure 11 GPS coordinates being fetched displayed as the second header Back to top Before the user saves the POI the application checks whether the GPS coordinates are found or not If not found the POI information is saved with the default coordinates 0 0 0 0 The user can also opt to input the GPS coordinates manually when using a separate GPS device for example The manual GPS entry is set in the System Settings
10. SFER serron scaner ico EE 36 Es al alga Vey DCS UO PPPPPO U0 0 0 0 P P e o PU 36 3 1 1 Using the Over the Air option RecoMMended cccoccccnnccnonccncncnnonacnnoncnnnncnnoncononcnnnnonnonrononcnnoncnnononons 36 3 2 Downloading data from the Serve esineisiin enia en aE a 36 3 3 Uploading data to the Server misnasrnsnicn aia 37 3 4 RESCEEING the security sia E AA 37 3 5 Upgrading the mobile application cooccooccncocncocnnononencnnncnnoncnonconorononrnnnronornnnnrnonrrnrnnnnnrnnncononnnnanonoss 37 4 ANSWERING SOME SPECIAL TYPES OF QUESTIONS occccoocccnccnnccnnnnnnnccnnnonancnnnnonconononoronnnonnrnnnnnnannnnnonnnnnnnnonanos 37 4 1 Answering Conditional questions ccccscccssccsseeceeccesccceeceeucesseceeneeauceeeeeceueeaeeeseueesseeseeeneneeaseeseeeseeenees 37 4 2 Route Tracking and Area Tracing isis e 38 2 CUOSING THE APPLICATION ntsc oran ico cad 38 e E O oo ae cree este ast note ictser E A E seeuamacimede a 39 LIST OF FIGURES PIO he 1 Time 02 UN SC Wee E E E rc scene AEA cate os captstv asec eames aca eee 6 Figure 2 The application s MAIN MENU ccccseccssecssecesecceseccseceeecaseceeueeeeecseeeeaeeeaeeesseeeeeeesaeeeeeeesaeeneeeeeecesaeeeeeeagesees 6 Figure 3 Change user in popup menu before logging IN ceecssecceseccceeccceseccaeececsececeuceseneceeeceeeceseucesseeeeeneeengess 7 Figure 4 Change User login SOTO ici sar 8 Figure 5 Warning displayed if user entered is not in the same
11. a is recommended Back to top 2 6 5 GPS timeout minutes This setting allows the user to set the maximum time that the application should use when getting the GPS coordinates If the target accuracy will not have been achieved by then then the values that will have been obtained so far will be used Back to top 2 6 6 GPS target accuracy meters This setting allows the user to enter the desired GPS accuracy in meters when adding a POI that has GPS as a field The default is 20 meters This is shown in the figure 36 above Back to top 2 6 7 Manual or Automatic GPS entry This setting allows for the user to specify the manner in which the GPS coordinates are presented The default option is Set Automatically which means if a form has a GPS question the application will 31 Q PoiMapper automatically attempt to fetch the coordinates of the current location The manual entry option allows the GPS coordinates to be specified as the latitude X and the longitude Y Manual entry is desirable when the GPS coordinates of the point to be mapped are already known or another device is used to get the coordinates perhaps with higher accuracy Back to top 2 6 8 Automatic Manual data upload This setting defines how the data will be uploaded to the server The default option is Manual Upload For manual upload the data is uploaded only after selecting the Upload to server option as explained in
12. already logged in and now a different user wants to log in there is the option of changing user in the menu just before logging in as shown below E EAT 20 01 Poimapper User Name Account x2 Generate PIN code Reset database Change user Figure 3 Change user in popup menu before logging in Back to top When this option is selected another log in screen is presented This one allows for logging in to the same group as the previous user If they are not they will be asked to log in afresh by deleting the current user s data In case the user does not want to delete the current user s data they can go back and log in with the credentials used with the current user Q PoiMapper Se 20 01 Change user Figure 4 change user login screen Back to top Current user Simon New user Emma These users are in different group If you want to change to new user you need to delete current user s data do you want to do that ow ae Figure 5 Warning displayed if user entered is not in the same group as the initial user Back to top 2 1 Add data Add data shows a list of different forms POI types in a given survey Selection of the form by tapping it on the screen opens it for data entry Q PoiMapper s PoiMapper Health Monitoring Water Points Household data Schools Figure 6 List of forms or POI types after selecting Add Data menu Back to top When a
13. apper Enable Reset database Next in keyboard moves focus to RadioButtons and CheckBoxes Show name on top of all form pages Use table UI for PartOf experimental Use static map Figure 40 The option of resetting the database in settings Back to top Account x2 Generate PIN code 2 Reset database Change user Figure 41 Resetting the database Back to top 33 Q PoiMapper 2 6 12 Use table UI for Part Of This setting is used when a complex form part of form is used Part of is a way of associating forms in PoiMapper such that there is a parent child relationship between the forms Checking this option shows the fields questions of the child form as a table to be filled This should only be used if the child form is to be filled as a table Back to top 2 6 13 Use static map This option when ticked allows the user to see the data collected or downloaded from the server on a map The option is shown after selecting the POI type or form in My Edits or the Browse data menu and then selecting Map tab The default view is the list view where the POIs are listed alphabetically Back to top 2 6 14 Reset Security code This option allows the user to reset the defined security code A security code allows the user to define a secret code they can be using to access the PoiMapper application instead of entering the username and password always If the user forgets their security it can
14. ata menu showing a list Of POI types Or fOrMS ooccccoccnonncncnacononconencnnnnncnononnnncononnononcnnnonnos 23 Figure 29 Market place info PO s list under the Market place info POI type coooccccoccnonocnonacononcnnoncnncnnononannnos 24 Figure 30 A selected Market place info form for viewing Or editiNg cccooccccocnnnocononcnncnncncnacnnononnonannnnnononnnnos 24 Figure 31 Poimapper screen when upload Starts ccccssecssecccscccseceseceeseceeceeeceeeeccecesaeeseeeeeuceseeeeeeesaeeseeeeeseesees 25 Figure 32 Poimapper notification screen when upload is IN progress ccocccconcnonnccnnncononcnnonacncncnnnacononnnnonacnonnonos 26 Figure 33 Poimapper notification screen when upload is COMplete occcooccccocnnnncnnonconenacncnacnnnncnnonannonacnonanonos 26 3 Q Figure 34 Figure 35 Figure 36 Figure 37 Figure 38 Figure 39 Figure 40 Figure 41 Figure 42 Figure 43 Figure 44 Figure 45 PoiMapper Poimapper screen when upload is complete ococccoccconnnanonccnncconcncncnnaconanonononcnnanonononcnoncnnanonononinos 27 The screen displayed for select download criteria of data from the SerVeT oocccccccnncncncncnaninannnnanonanons 28 The screen displayed for selecting download image size from the SerVeT oocconcccncccnnccnncnonaninacnnnanonanons 29 The screen displayed after opening the Settings MENU cooccnnccnnccnnncnnncnnncnnnanonacnnnncnnncnnnononanonarnnnanananons 30 The
15. be removed on the log in screen The set security code can also be reset under the settings menu as shown on figure 40 below PIN coge Reset PIN code Current PIN code New PIN code Confirm PIN code Figure 42 The option of resetting the security code on the settings menu Back to top 34 Q PoiMapper a 4303 4 mi 20 32 Poimapper Enable Reset database Next in keyboard moves focus to RadioButtons and CheckBoxes Show name on top of all form pages Use table UI for Partof experimental Use static map Figure 43 Next moves focus to radio buttons and checkboxes Back to top 2 6 15 Next moves focus to radio buttons and checkboxes This setting in the settings menu allows the user to enable the next option on the keyboard after entering text in a text box to move to the subsequent radio or checkbox If this option is disabled then the user will have to manually take focus to the checkboxes and radio buttons in order to make input data using the textboxes and checkbox By default this option is disabled NB To save any changes to the settings select Done in the options popup menu To discard any changes press the back key on the mobile device Back to top 2 7 Update form templates This menu allows the changes that are done to a form or forms in a given survey to be downloaded on the phone over the air It is recommended that any POIs that are still in the edited
16. bile phone to have Internet access GPRS EDGE 3G Wi Fi The upload process goes on in the background Figure 31 below shows the menu screen immediately after the upload of data is started Figure 33 and Figure 34 below show the upload success message once the upload of data is complete The uploaded POIs are listed and can be viewed in the Browse data menu under the respective POI type Poimapper Poimapper Add data Edited data 1 Figure 31 Poimapper screen when upload starts Back to top 25 01 07 2013 eas aaa A RE l Silent Auto Ni Wi Fi GPS mode rotation Safaricom Ongoing Click here to stop Shake detectior Poimapper Uploading Figure 32 Poimapper notification screen when upload is in progress Back to top 02 07 2013 OF ts an 10 13 EEE ana em ra 4 O ko ia Wi Silent Auto Wi Fi BT GPS mode rotation Ongoing USB connected Select to copy files to from your computer Click here to stop Shake detectior Notifications Poimapper Template update ready Figure 33 Poimapper notification screen when upload is complete Back to top 26 Q PoiMapper i Poimapper 1 POI was uploaded Figure 34 Poimapper screen when upload is complete Back to top NB Data rates for the mobile operator apply If the data is bulky especially when there are multiple images or the Internet connection on the mobile device is unreliable i
17. cesses to the application instead of a username and password NB The application must be configured before the user attempts to log in and fill a questionnaire Please see section 3 1 of this document for instructions in how to carry out the application configuration Enter the relevant log in credentials and press Login After successful authentication the Main Menu screen appears see Figure 2 NB Please ensure that the application is always on the foreground when in use Using the application in the background may cause the application to have undesired behaviour Q PoiMapper T Er Poimapper User Name Password Account x2 Generate PIN code Login Figure 1 The log in screen Back to top E E n Poimapper Add data Download data from server Update form templates Figure 2 The application s main menu Back to top A list of menus Add data Edited data Browse data Upload data to server Download data from server and Update form templates are available on the Main Menu screen Edited data lists POI s created modified by the user and are sorted alphabetically and grouped by POI type form or questionnaire The POI s that are downloaded from the server are listed under Browse data A copy 6 Q PoiMapper of the POIs uploaded to the server is also saved under browse data in monitoring mode and in case the of survey mode a read only upload log is shown If there was a user
18. cking 4 School 9 Figure 21 A list of the created modified POls grouped by POI types or forms Back to top 18 S p Marketplace Info Show on map Donholm ATM Jogoo rd Market Kaharati Market Map test Figure 22 A list of POls under the Market place info form Back to top 2 2 1 Edit POI data To edit the data of an already saved POI open the Edited data menu and select the POI either under the All POI menu or the specific POI type form under which the POI lies Select the POI by tapping it and this opens the form with the last saved values in each field By default the POI is in read only mode To activate the edit mode select Edit from the options popup menu 2 2 1 1 Updating GPS Coordinates To update the GPS coordinates of an already saved POI click on the update button beside the GPS coordinates as shown below image 23 The application will attempt to get the GPS coordinates of the current location only after the GPS command is selected 19 Q PoiMapper Y O he nll 20 27 Latitude Longitude 1 2723157 36 8033737 KEII maternal tests Cancel Figure 23 update GPS Coordinates button Back to top 1D m 20 27 i Poimapper Update location Figure 24 The prompt shown to the user when the GPS button is clicked Back to top 2 2 1 2 Capture Images To capture images when editing a POI please refer to the instructions in sectio
19. e page of the form that was last opened is displayed e O he mi 20 24 Province wv District v Latitude Longitude 1 2723157 36 8033737 IC Name Done Add comments Figure 27 The Cancel command Back to top 22 Q PoiMapper rt 2 3 Browse data The POI s that are imported from the server ServerData dbs are listed under the Browse data By default all the listed POI are non editable read only To View POIl s saved in the server go to the Main Menu and select Browse data A list of available POI types is listed on the screen as shown in Figure 28 Choose the desired POI type and select a POI type view all the POI s under that POI type as shown in Figure 29 The figure in brackets indicates the number of POI s under that POI type form If the back button is selected while the forms are still read only then control is passed to the previous screen However when if the back button is selected after the user had started editing the form the form is saved to drafts The Edit Copy and Delete options are found in the popup menu If the POI has images the camera icon will also be at the top right corner of the screen in the form that has been opened If there are image questions that have images the camera icon will be shown next to the image question The delete command removes the selected POI from the list and lists the POI in My Edits deleted POI s list The POIs a
20. ear The procedure of area tracing is exactly the same as the route tracking procedure explained above Back to top 5 CLOSING THE APPLICATION To close the application select the Exit command in the popup menu or select the back key on the phone This prompts for a confirmation as shown in Figure 45 below On selecting the yes option the application closes and on selecting no the application returns to the previous screen that was displayed Back to top 38 Q PoiMapper tn A A P Exit Are you sure you want to exit the application Figure 45 Warning message when closing the application Back to top 6 GLOSSARY The glossary section lists and explains some unfamiliar abbreviations and terms that have been used in this document DTC Abbreviation for desktop client application that is used as an alternative to configure a mobile phone with the relevant files download and upload data GPS Global Positioning System OTA Over The Air This requires an Internet connection on the mobile device POI Point of Interest POI type form The term form or POI type in the context of the PoiMapper application refers to a questionnaire A questionnaire contains one or more questions Back to top 39
21. en the application is run for the first time Back to top 3 2 Downloading data from the server Data can be downloaded from the server instead of a PC as described in section 2 5 of this document The criteria to filter the data can be specified by ticking the appropriate checkboxes and then pressing the Download button Unmarking all the checkboxes downloads all the data from the server The following is an explanation of the filter options 36 Q PoiMapper e Download my data This option only downloads the data that the logged in user has previously uploaded to the server e Download only new data This option downloads only the new data that has been uploaded to the server e Download only selected POI types This downloads data for the selected forms POI types e Download Needs editing data This downloads data for the logged in user that has been marked as data that needs editing or to be reviewed Back to top 3 3 Uploading data to the server This is an alternative to the mobile application option to upload to the server as described in section 2 4 of this document The mobile phone has to be connected to the PC via a USB cable and the memory card detected as a drive as described in section 3 1 of this document This uploads the data found in the UserEdits dbs file in the Poimapper folder of the memory card of the phone The status of the upload process is displayed in the application window and confi
22. er the Edited data menu The menu is disabled by default unless there are some draft POIs or POIs not yet uploaded to the server To View Edited data go to Main Menu and tap the Edited data option The number in the brackets shows the total number of POIs under the Edited data menu Figure 20 below shows the Edited data menu which lists all the POI s added under the All POI menu PO s are also listed under each specific form POI type The deleted PO s are listed in the Deleted POIs menu where the number in the brackets indicates the number of deleted POIs Figure 15 below shows a list of user created modified POI s as displayed under the Edited data menu The 1 2 that appears after the POI instance means that page number one and two have both been filled The Health Monitoring form is listed here meaning that there are new or modified PO s for that form Pressing the Previous command displays the previous page in edited data The unsaved POls or drafts are saved in Drafts menu where the number in the brackets indicates the number of draft POls that are in the list 17 Q PoiMapper E Ss Poimapper Add data Edited data 1 Upload data to server 1 Download data from server Update form templates Figure 20 Edited data menu as shown in the main menu Back to top AD Poimapper 47 of 50 Area Tracing 4 Household data 29 Marketplace Info E Maternal Monitoring 31 Route Tra
23. group as the initial USer o cccocccccocnnononncnonnnnno 8 Q PoiMapper Figure 6 List of forms or POI types after selecting Add Data Menu ccccecccsseccesececseceeeneceeeceeeceeeneeseneeeegeeeneess 9 Figure 7 First page of the health monitoring FOMN ccccceccccsscccescceescccaecccescceeeceeeuceceucesseceeeceseucesseeeseeceeeeenes 10 Figure 8 The second page of the health monitoring forM ccceecccesccceseccesecceeeceeeuceceuceceeceaeceseuceseaeeseeceeseeeees 10 Figure 9 The option of going directly to a specific PAGE ccesecssscccesecceeecceeeeceeeceeeuceceuceseeeceeeceseuceteneeseeeeeeeeees 11 Figure 10 The alert displayed when the user attempts to save without a mandatory field saved 11 Figure 11 GPS coordinates being fetched displayed as the second hNeader occoocccncoccncnccnonacnconcnonacononcnncnncnonoonnos 12 Figure 12 The application attempting to fetch GPS coordinates showing the GPS accuracy header 008 12 Figure 13 The camera icon for capturing an image in the top right corner Of the Page coocccoccncnnccncnonncnnononannnos 13 Figure 14 Camera icon for capturing viewing IMAGES cccecccccccccseeseccccceueeecessseeeueeecceseuueeeccsscuueeneeeeseesueneeeees 14 Figure 15 viewing and capturing more IMABES ccccescccseccsecccecccseceeceeseceeecesuceseeccuceseceseeceeuceseeeseeeeseeeseeeegeeenees 14 Figure 16 Delete image
24. n 2 1 2 of this document 2 2 1 3 View Images 20 Q PoiMapper rt To view images captured for a given POI select View Images in the popup menu For more details please refer to section 2 1 3 2 2 2 Delete POI To delete a POI under the Edited data menu select the Delete command as shown in Figure 25 below A warning message Are you sure you want to delete this POI is displayed as shown in Figure 26 On selecting the Yes option the POI is deleted and on selecting the No option the previous page of the form that was open before selecting the delete option is displayed Y Oj ull 20 28 Page Common form details Province Coast District Latitude Longitude 1 2723157 36 8033737 Name Delete Figure 25 The Delete command in the Options menu Back to top 21 Q PoiMapper O ie nll 20 28 i Delete Are you sure you want to delete this POI Figure 26 The prompt shown when the delete command is selected Back to top 2 2 3 Cancel Editing a POI A user can opt to cancel the editing of a POI by selecting cancel on the bottom of the page or on the popup menu A message asking the user to confirm cancelling of POI editing is displayed as shown in Figure 18 above On selecting the Yes option the screen with the list of POI s is displayed and the information that had been entered for the immediate previous form discarded On selecting the No option th
25. ng the Main Menu page Figure 18 below shows a screen with the alert message for the user to confirm the cancel action 15 PoiMapper E Y O e ml ES Province wv District wv Latitude Longitude 1 2723157 J 36 8033737 IC Name Done Add comments Figure 17 The cancel command Back to top Y O e ml 20 24 i Cancel Are you sure you want to cancel editing Figure 18 An alert message displayed after clicking cancel Back to top 2 1 5 Save POI Once the fields are populated the user can select the Done command from the Options menu list as shown in Figure 19 below The new POI information is saved locally to the phone UserEdits dbs or automatically uploaded to the server if the automatic upload option is set please refer to section 2 6 8 The newly created POI s are listed under Edited data in the main menu page The Done 16 Q PoiMapper rt command is available in all pages and allows the user to save the POI data that has been entered Before saving the application verifies that all the mandatory fields are filled and prompts the user if they are not e430 un 20 24 District v Latitude Longitude 1 2723157 36 8033737 Name Figure 19 The Done command in the popup menu for saving the data Back to top 2 2 Edited data The POI s that are added modified or deleted by the current user and have not been uploaded to the server are listed und
26. of up to 5 images that can be associated with a POI instance and for each specific image question 13 Q PoiMapper rt 2 1 3 View images Images can be viewed only if the POI or the image question has got a picture question and there is at least one image captured To view the images tap the camera icon This icon will be shown in the top right corner of the page only the form has been enabled for attaching images The camera icon will be next to the question only if the question has been enabled for attaching images If there are images they can be viewed by tapping the camera icon next to the question If they are not available the camera is opened and images can be taken a Q e ull e Testing images 3 4 Image question Previous Figure 14 Camera icon for capturing viewing images Back to top T af p Poimapper Figure 15 viewing and capturing more images Back to top 14 Q PoiMapper rt To delete an image select the delete command on the popup menu when the image is displayed on the mobile phone s screen Figure 16 below shows the Delete Image command on the popup menu under images EE Poimapper Delete Figure 16 Delete image command when a POI has some captured images Back to top 2 1 4 Cancel adding POI The user can cancel the Add new POI operation by selecting the Cancel command at the bottom of the page of an open form A confirmation screen is shown before loadi
27. re deleted from the database once the data is uploaded to the server A warning message Are you sure you want to delete this POI is displayed as shown in Figure 26 above for the user to confirm the delete action im Y S 303 4 a 09 22 Poimapper 47 of 50 Area Tracing 4 Household data 29 Marketplace Info E Maternal Monitoring 31 Route Tracking 4 School 9 Figure 28 Browse data menu showing a list of POI types or forms Back to top 23 4 303 4 a 09 28 Marketplace Info Show on map Donholm ATM jogoo rd Market Kaharati Market Map test Figure 29 Market place info POI s list under the Market place info POI type Back to top In order to edit the POI s under the Browse POI s menu the user must choose a POI from the list and then select the Edit command in the popup menu as shown in Figure 25 Viewing the POI after selecting the Edit command is the same as opening a POI in the Edited data menu a Y CO He mi B 09 30 Poimapper fo Page Page 1 Country Kenya Province District Murang a South Latitude Longitude 0 8400919 37 1464331 Name Figure 30 A selected Market place info form for viewing or editing Back to top 24 Q PoiMapper rt 2 4 Upload to server The Upload data to server menu option allows the POI s that have been added or modified to be uploaded to the server via the Internet OTA This requires the mo
28. recommended Medium 640x480 Small 200x150 No images Download Figure 36 The screen displayed for selecting download image size from the server Back to top jill 20 31 Poimapper 35 POIs are downloaded Figure 37 The screen displayed after successful download of data from the server The number of POI s downloaded is also shown Back to top 2 6 Settings The settings menu of the PoiMapper application is found in the options popup menu when either in the main menu or in the list of form s after selecting Add data menu 29 Q PoiMapper ol 9 et he mi 20 32 Poimapper Log Enable true false Server URL Default Manual https gw poimapper com PoiMapper_Gateway_Android_V6 Figure 37 The screen displayed after opening the Settings menu Back to top Se e 20 32 UFO willie uE tay ES GPS horizontal accuracy meters GPS timeout minutes GPS target accuracy meters 20 Figure 38 The screen displayed after scrolling down the settings menu Back to top 2 6 1 Log enable When this setting is set to true it allows the application to log error and other information related to the application when it is being used It is necessary for users with technical skills to be able to troubleshoot It may also be necessary when a user would like to report a bug and provide the log file for analysis by the PoiMapper team 30 Q PoiMapper
29. rms the POI s that have successfully been uploaded on completion Back to top 3 4 Resetting the security code If the security code is set as explained in section 2 of this document it can be reset by going to the Popup menu on the log in screen and selecting the Remove PIN Code option This removes any security code that had previously been set in the phone To set a new security code the mobile application will require a valid username and password combination to log in to the application The Pin code can also be changed by using the Reset PIN code option on the settings menu This will require setting another new one and saving it by selecting Done in the pop up menu Back to top 3 5 Upgrading the mobile application The mobile application can be upgraded to the latest stable version by accessing the most recent version in the Android market Upgrading allows one to have access to the latest features and bug fixes if any Back to top 4 ANSWERING SOME SPECIAL TYPES OF QUESTIONS 4 1 Answering Conditional questions A conditional question is a question that shows another question that is relevant to the response of the user and hides the irrelevant question In PoiMapper conditional questions are supported for 37 Q PoiMapper Boolean single selection radio button and multiple selection check box questions On selecting a given response another question appears below the current que
30. section 2 4 of this document In the case of automatic upload the POI is uploaded to the server once a new POI is saved or changes are made to an existing POI and saved Back to top 2 6 9 Image Quality This setting allows the quality of images that the application will capture to be set The default option is medium quality High quality gives fine detail of images but however incurs more data traffic during upload as the images are bigger On the other hand low quality images have less fine detail and incur less data traffic when uploading data The settings are as shown below S O ull 20 32 rSn serie leone CA WIGS Full 1600x1200 Medium Y x 800x600 Small 14 x 400x300 JPEG quality for captured image 1 100 Warning limit for Upload and Download MB Figure 39 Image quality setting Back to top 2 6 10 Set language This setting allows the user to switch between different languages The default language is English Changing the language setting changes the language of the menu items all the status and alert messages 32 Q PoiMapper rt Back to top 2 6 11 Enable Reset database This setting allows the user to provide the option of resetting the database so that another user can log in with different credentials If this option is selected then next time the application is started the menu will include an option to reset the database as shown below E 3 303 4 mi 20 32 e Poim
31. ssociating both time and location stamps to the objects complex data types like part of where forms are associated and skips in a form conditional sub questions 1 1 Basic Hardware Requirements Below is a list of basic hardware requirements for the mobile phone and the application to work effectively 1 Android platform version 2 2 Froyo or higher The PoiMapper Android version works with Android 2 2 or higher Currently tested on Android 2 2 Froyo and 2 3 Gingerbread ii Micro SD Memory Card A Micro SD Memory Card allows storing of data to save transaction costs or to store the data in situations where network connection is not available This therefore eases data collection in remote areas where Internet connection is unavailable or unreliable Back to top 1 2 Installation Procedure The application is installed by searching for PoiMapper in the Android Market The installation procedure requires the user to follow the screen prompts until the installation is completed successfully To configure the application please check section 3 of this document 2 OPENING AND USING THE APPLICATION After successful installation the application can be found in the application menu The application is named PoiMapper with the logo shown below The application asks for log in with the user name and password or a security code see Figure 1 One can opt to define a security code to be entered during subsequent ac
32. stion for the user to type a response For example if the question is Do you have water in your home the response options are yes or no If yes one may want to ask What is the source of water If no the respondent may be asked Where do you get water from The conditional questions may go to many other levels depending on the questionnaire NB The sub questions can only be seen when a given response has been selected in the form Back to top 4 2 Route Tracking and Area Tracing Route tracking is used to map something linear like a road power line migration route etc On opening a route tracking form one may fill in the relevant data like the name location hierarchy information take pictures if any are required etc To start route tracking press the Start Tracking button at the bottom of the form The application fetches the coordinates after a period of time specified by the GPS time delay for routing defined in section 2 6 6 The default timeout delay is after every 3 seconds The application has to be left open while route tracking is being done Route tracking can be paused and stopped by pressing the Stop button Once routing is stopped it can be restarted resumed or the route POI saved by selecting the appropriate menu option Area tracing is used to map an enclosed area like a community administrative area perimeter of a premise etc and the output is a polygon as opposed to routing which is lin
33. t is advisable to use the desktop client application DTC to do the data upload as opposed to doing it from the mobile phone since it is faster and convenient for bulky data 2 5 Download from server The Download data from server menu option allows POI s saved in the server to be downloaded on the phone for viewing and or editing purposes This requires the mobile phone to have internet access GPRS EDGE 3G Wi Fi The menu has various filtering options as shown in Figure 35 below To download only the POIs that the logged in user has added select Yes for the Download only my Poi option otherwise all POIs in the server will be downloaded To download only PO s for a given form POI type mark the check box against the POI type form If no POI type is selected data for all the POI types is downloaded with the criteria defined for the current user only or all data To start downloading the data from the server press the Download button at the bottom of the screen The download process begins and runs in the background When the download of data is over as shown in Figure 37 below a confirmation message is displayed To download data that has been marked as needs editing this means the data may have errors and needs to be reviewed tick the Download Needs Editing Data Needs editing is a feature that the administrators use to mark data that needs to be reviewed and send data back to enumerator in case it has errors
Download Pdf Manuals
Related Search