Perform location-bound measurements in the field
On Android: https://play.google.com/store/apps/details?id=nl.artesia.field_form
On iOS: https://apps.apple.com/bg/app/fieldform/id1571910702
Use FieldForm to conduct location-bound measurements in the field, store the values on your phone, and share the measurements with other people. To use FieldForm for a set of locations with multiple people simultaneously, the use of an FTP-server is recommended.
FieldForm is the successor to FieldLogger. It is build platform-independent in Flutter, so there are no differences anymore in functionality between the Android- and iOS-app. The new structure makes it easier to add functionality or fix bugs. FieldForm is now completely open source.
There are some important changes between the files used or generated by FieldLogger and FieldForm. The file with location-data is a json file (instead of a csv in FieldLogger), to better incorporate the nested structure of the location-data. The measurement-data still consists of csv-files. The date-format however is changed to yyyy-mm-dd (instead of dd-mm-yyyy in FieldLogger), to minimise potential errors.
This repository holds the source code of FieldForm, with which the app can be built using Android Studio (and Xcode for iOS). Because of security concerns the signing keys are not added to this repository, so only specific developers are able to update the app in the Play Store and App Store. The source code can be used by any developer to test the app, or to release an app with another name.
Also, the Google Maps api-key is not contained in the repository. When building the app, the Google Maps api-key is taken from an environmental variable named 'maps_api_key', defined in the operating system that builds the app. To get a working Google Maps, a developer should therefore request an api-key at Google, and add this environmental variable.
Currenly FieldForm uses two types of files: location- and measurement-files. Measurements are stored using a location-id. This id is the location-id (when no sublocations are used) or the sublocation-id. It is important that these id's are unique strings, which is not checked by FieldForm (yet).
A location file contains the data of the locations, locations-groups, inputfields and settings. The location file is a json-file, of which the structure is described below, in simplified Dart-Code. Each field is preceded by the variable-type. When a variable is optional, which is the case for most variables, this type is followed by a question-mark. A short description follows the colon after the variable-name.
where:
InputField:
InputFieldGroup:
Group:
Location:
An example of the contents of a location file without inputfield-groups, but with inputfields, groups, locations and sublocations is:
{
"settings": {
"use_standard_time": "YES"
},
"inputfields": {
"value": {
"type": "number"
},
"comment": {
"type": "text",
"hint": "place a comment"
},
"reliable": {
"type": "choice",
"hint": "is this measurement reliable?",
"options": [
"yes",
"no"
]
},
"photo": {
"type": "photo",
"hint": "take a picture"
}
},
"groups": {
"group_1": {
"name": "Group 1",
"color": "orange"
},
"group_2": {
"name": "Group 2",
"color": "blue"
}
},
"locations": {
"location_1": {
"lat": 51.9,
"lon": 6.5,
"group": "group_1",
"sublocations": {
"loc_1_1": {
"inputfields": [
"value",
"reliable",
"comment"
],
"photo": "loc_1.png",
"properties": {
"surface level": "20.74",
"filter level": 18.64
}
},
"loc_1_2": {
"inputfields": [
"value",
"reliable",
"comment"
],
"photo": "loc_1.png",
"properties": {
"surface level": "20.74",
"filter level": 10.0
}
}
}
},
"location_2": {
"lat": 52.1,
"lon": 6.3,
"group": "group_2",
"sublocations": {
"loc_2_1": {
"inputfields": [
"value",
"photo"
],
"photo": "loc_2.pdf",
"properties": {
"surface level": "10.41",
"filter level": 8.26
}
}
}
}
}
}Possible keys for the settings are:
Boolean settings will be either true or false. To set a setting to true, use a string like 'yes', 'Yes', 'true' or 'True'. Otherwise the setting will be set to false.
A measurement-file contains measurements performed by the user or other users. The measurement-file is a ';'-delimited csv-file with the header LOCATION;DATE;TIME;TYPE;VALUE.