Maapeli and Kapalo mobile

What?

This is helpfile describing the common tasks for capturing geological field data with Kapalo and Maapeli mobile.

Copyright 2015 Geological survey of Finland/Tero Rönkkö

This helpfile is being hosted at: http://gtkdata.gtk.fi/mobiili/index.html.
Tämä ohje löytyy suomenkielisenä osoitteessa: http://gtkdata.gtk.fi/mobiili/index_fin.html.

Where to get?

Kapalo

Get Kapalo on google play!

Maapeli

Get Maapeli on google play!

Geological content

Geological content documentation for Kapalo in english can be found here Mobiilikapalo-ohjeistus_ENG.pdf
MobiiliKapalon geologisen sisällön ohjeistus löytyy tästä Mobiilikapalo-ohjeistus.pdf

Symbology for rock types here
Domain values and their descriptions here

Language

Kapalo is available as Finnish and English versions. If the operating language in in Finnish, also the program will be in Finnish. With all other languages the program will be in English.
Maapeli is currently available only as Finnish version.
Note! Database of Kapalo and Maapeli from version 1.6.2 onwards is not compatible with the older versions. Thus you cant access the older observations with the updated application.

Database for the current versions of Kapalo and Maapeli is stored in the work folder of the application, you cannot directly access it.

To get a backup copy or copy to be worked with on your PC click open menu from the upper rigth hand corner in the map view and click "Export name_of_aplication.sqlite database file", then select name and location of the copy to be created. You are also asked if the observation photos should be copied to DCIM folder of the device

In older versions of Kapalo (=>1.6.2 / May 2021) and Maapeli the database is stored in the root folder of the used device with name "name_of_aplication.sqlite".

Note! If, in pre 1.6.2 versions of Kapalo or Maapeli, the database copied to the computer does not open properly you need to copy the database to another folder with devices own file manager first. And then move this copy to the computer.
The database structure stores the point data as features, which are recognized by for example QGIS. ArcMap however (at least version 10.4) does not recognize these points properly and the users of it should use Mobsu (see below) to transform their data into ArcMap format.

Application can directly use the camera of the device if the observation photos are taken by clicking the camera symbol on the observation photo point. Photos are stored in the working folder of the application and are not directly accessible with file manager. You can copy them "visible" at the same time when you make a backup copy of the database. I.e. by selecting "Export name_of_aplication.sqlite database file" from the menu in the upper rigth hand corner in the map view. The application asks if new photos associated with observations are to be copied into DCIM folder of the device.

Maapeli and Kapalo mobile are tools for collecting geological field data on the go. They are designed to run on Android 4.4.2 and above.

Components on the app are action bar, map and individual edit pages for dataitems.

200x200 Edit page

Action bar contains the buttons for interacting with map and observation database.

Note!Create and locate buttons are disabled until there is decent GPS fix.
Edit page

Opens up settings page. Different settings are explained in more detail under Settings -section.

Edit page

Edit last observation created in the database.

Edit page

Create new observation at the detected current gps coordinates. This item is disabled until there is GPS lock.

Note!This button is disabled until there is decent GPS fix.
Edit page

Center the map on currently detected GPS coordinates. This item is disabled until there is GPS lock.

Note!This button is disabled until there is decent GPS fix.
Edit page

If multiple map layers are available, choose which to show.

Edit page

Opens browse items - form. This form gives you quick overview of all items in the database. You can edit and focus on the items on the list.

Edit page

Opens up hidden items in the action bar. The items include:
-Help
-Export kapalo.sqlite/maapeli.sqlite database file (Creates a copy of the observation database in location selected by user, asks if the observation photos should be copied to DCIM folder of the device)
-Import offline-map file (Takes an offline map stored on the device into use)
-Remove offline map (Removes the offline map from the list)
-Clear database (Empties the database)
-About
-Exit

Pinch to zoom

Pinch on the map to zoom map.

Touch to pan

Touch map to pan around the map content.

Touch and hold

Longpress on previously empty area to create new point. Long press on existing point to edit or delete existing point.
Edit menu

You can choose between global ESRI online topographical basemap and Finnish national landsurvey basemap as online basemaplayer in the settings.

You can use custom offline .TPK tilepackage maps or geotiff images.
In Kapalo and Maapeli versions 1.6.2 and newer, you have to load them to device and install them by opening the menu from the upper right hand corner and selecting "Import offline-map file", this will move the file to the software's own work folder.
In Kapalo and Maapeli versions older than 1.6.2, copy the maps to the root folder of the device you're using

By selecting Browse items action in actionbar you can open up form to overview and manage all available items in the database.

Edit page
Edit page

You can start editing on any of the items on the list by simply clicking on it. To focus the map on or delete the item, long press chosen item for a moment.

Edit page

Working with the details of the data is done through edit pages.

Edit page

There

Edit page

Readonly field has uneditable edit part which shows as grayed out in this picture.

Edit page

Text fields can be either numeric or text fields.

Edit page

Some fields accept values only from certain array of coded values (domains). Pushing the button opens up list of valid values.

User can modify the default domain lists. Instructions how it is done and e.g. alternative rock name list can be downloaded from here.

Related data can be managed through subtables section on the edit page.

Note! You can scroll the subtable list if there are more than four items related to the master row.

You can delete subtable rows from the master row by touch and holding on the subtable item list

Settings

You can find the settings button on the action bar on top of the application

Settings

User pseudonym

The default user pseudonym is used as base for creating observation id and is stored in the database among other things as observed by -field.

Project

Default project name or number to be stored with the observation data.

Location

Enable this to allow application to use GPS location when proper GPS fix exists.

Offline data

Offers three options to choose from:
  1. Only online data - Use solely online maps
  2. Both online and offline data (if available) - Use local data to supplement online data
  3. Exclusively use offline data - Do not try to load online data at all. Use only local TPK and geotiff files.

Online map

You have two map sources to choose from:
  1. ESRI online basemap (global) - ESRI's default, global topological map
  2. Kapsi/NLS tilemapservice (Finland) - National land survey tilemap dataset hosted by Kapsi

Database tables for Kapalo are described and explained in this document: kapalodesc.html.

Geological content documentation for Kapalo in english can be found here Mobiilikapalo-ohjeistus_eng.pdf
Kapalo sovelluksen geologisen sisällön ohjeistus löytyy tästä Mobiilikapalo-ohjeistus.pdf

Mobsu program for Windows can be used to transfer the data from sqlite-format into ArcMap databases used by the full scale Kapalo- and Maapeli-programs. Empty databases can be found from the installation kit.
Users outside GTK can upload the installation kit from here: Mobsu installation.
Internal users of GTK can install the program from the Software Center.
As Mobsu uses ArcMap tools in the transfer, its use requires an ArcMap-license.
Installation kit also includes instructions for use of the ArcMap database and symbology files (.lyr)
The kit includes four versions of the ArcMap database for Kapalo
-Finnish domains and EUREF coordinate system
-Finnish domains and WGS84 coordinate system
-English domains and EUREF coordinate system
-English domains and WGS84 coordinate system
Maapeli database is only available in Finnish and EUREF coordinate system Note these two things
In the ArcMap database the structure is "unabridged". This means that it includes fields and layers that are not included in the mobile version of Kapalo.
In databases with English domains only those used by Mobiilikapalo are translated. Content of these translated domains is 1:1 with mobile version.

Kapalo and Maapeli mobile by Tero Rönkkö, maintenance and support by Sakari Hautala / Geological survey of Finland 2015

Mapping API provided by ESRI ArcGIS runtime SDK for Android

Online map data provided by ESRI, i-cubed, GeoEye, Kapsi / National land surveyof Finland (contains data released 05/2015)