Viewing filled forms on a map

New in version 1.25: ODK Collect v1.25.0

If you are collecting data related to physical locations, you can see a map of all filled forms from the Fill Blank Form menu. Use the map view to see your progress, to identify filled forms with bad locations and to plan your travel to the next location to survey.

Note

Blank forms must be downloaded with Collect v1.25 or later. Previously-downloaded forms will not have corresponding maps. If you update a form downloaded before Collect v1.25 and open its map, only filled forms created with the new form version will be displayed. Any previously-filled forms will not be included.

In the Fill Blank Form list, form definitions with a geopoint question outside of any repeat have a map button. Tap on the map button to open a map showing the filled forms for that form definition. The first geopoint question in the form definition that is outside of any repeat is used to map filled forms. The first geopoint question can be one that either requires user intervention or gets the location in the background. On the map, you will also see your current position and be able to fill a new instance of the current form definition.

Form instance map markers

Filled forms are represented by colored map markers. The color of each map marker indicates the status of the filled form:

  • Blue: saved and unfinalized
  • Purple: finalized
  • Green: sent
  • Red: send attempt failed

Tapping on a map marker will open the filled form for viewing or editing depending on the form status. By default, forms with Saved, Finalized, and Submission Failure status are opened for edit and Sent forms are opened for viewing. However, if the Edit Saved Form button is made unavailable from the admin settings, forms with Saved, Finalized, and Submission Failure status are opened as view-only.

Map controls

There are three control buttons clustered at the top right of the map. The top button is used to zoom to the current location. The middle button adjusts the zoom level to ensure that all mapped filled forms are displayed on the screen. The last button is used to change layers if offline layers are available. The basemap and reference layer settings are used across all of Collect so the same ones will be used for this form map as for location widgets with maps.

The button at the bottom right of the screen can be used to fill a new instance of the current form definition. After you save a new filled form, you will be returned to the map and the filled form will be displayed if it has a geopoint associated with it.

Status bar

The bar at the bottom of the screen displays the total number of saved forms and how many of these are shown on the map. All filled forms with a value for the first geopoint question will be displayed. To ensure that all filled forms are displayed, make the identifying geopoint question required.

Note

Deleted or encrypted filled forms are not shown on the map. However, forms that were successfully sent and then deleted and forms that are encrypted both contribute to the total number of saved forms. See Deleting Forms for more on how filled form deletion works.