In addition to showing the already-captured cases in a scrolling list on the case listing screen, it is possible to show the cases on a map, based on latitude and longitude variables for each case. For example, if the data entry application captures GPS coordinates for each household, the application could automatically display all of the interviewed households on a map, based on their captured locations.
To enable the map-based case listing screen, select Map Case Listing from the Options menu:
In the Map Case Listing dialog, check the Show the case listing on a map option and choose the variables in your data dictionary where the coordinates (latitude and longitude) of each case is stored. The variables must be numeric variables from the main data dictionary with at least one decimal place.
For each case in the data file, CSEntry displays a marker on the map at the location specified by the values of the selected latitude and longitude variables. Completed cases are represented by blue markers and partially-completed cases are represented by red markers. Tapping on a marker displays a popup window on the map containing the case label or case ID for the case, along with any case notes. Tapping on the popup window launches data entry for the selected case. You can use the
setcaselabel and
putnote functions to customize the case label and case note displayed in the marker popup window. Both the case label and case note support a limited subset of HTML tags for formatting including <b> (bold), <i> (italic) and <font> (font, size and color).
Any cases that have blank values for the latitude or longitude variable will not be displayed on the map. This means, for example, that a partially-saved case where the GPS coordinates have not yet been captured will not be displayed on the map.
Using the map case listing is currently only supported on Android. No maps are displayed in the case listing when running your application on Windows.
By default, the cases will be displayed with a Google Maps base map, which requires that the Android device be connected to the Internet. You can modify the
default base map used, or in cases where no Internet connection is available, you can
specify an offline map file to use in the
PFF file.