Piura, Peru Guide
OpenMapKit is a mobile application on Android that is used to collect features and attributes in the field and add them to OpenStreetMap. It is designed to be used along with OpenDataKit.
###This guide will cover:
- The applications needed to run OpenMapKit
- How to set up for your project by loading the necessary base maps and forms
- How to configure OpenDataKit Collect
- The field collection workflow and examples
- How to submit your completed forms to Ona and import your data onto OpenStreetMap
-Install the latest release of ODK Collect and OpenMapKit on your mobile device.
-If you have a USB cord to connect your Android mobile device to a computer please bring it. It can be used to transfer satellite imagery files to your device to use a a basemap. Something like Android File Transfer can help you copy files onto your mobile device.
-An OSM file is a type of XML file that stores OpenStreetMap data. You want an OSM file in your mobile device that is up to date so you can see the newest information as you collect additional information from the field and modify existing data. Copy the OpenStreetMap Piura .osm file onto your phone inside of the openmapkit > osm folder. The openmapkit folder exists because you installed the OpenMapKit application. If you would like to learn how the osm file was created, click here. The osm file was created using Overpass, Overpass is a way to query the OpenStreetMap database for specific data. To see the Overpass query used, click here.
-Copy Satellite Imagery and OSM tiles to your phone as basemaps, inside of the openmapkit > mbtiles folder. These tiles serve as the map background you see on your mobile device, having an up to date map background on your mobile device makes it easier to identify existing mapping features when you are out in the field. If you would like to learn how to create your own tiles click here. We created tiles over the whole city of Piura to cover all the mapping in the field that is possible, this extent is called the bounding box. To see the bounding box coordinates used for Piura, click here.
-Your Ona credentials will be distributed to you. The forms have already been created and uploaded to the Ona accounts. If you would like to learn how to create your own forms, click here. You can view the XLSforms that were created for buildings, highways, and points of interest.
-On your Android Mobile device open OpenDataKit Collector, put in your Ona credentials and download the forms from Ona:
Go to General Settings, then click on Configure platform settings and adjust the URL. For the URL, enter the name of your Ona account after http://ona.io/
E.g. http://ona.io/tgertin Now enter your username and password
On the main ODK Collect menu go to Get Blank Form to download your completed forms from the OMK Form Server.
-
On the main ODK Collect menu go to Fill Blank Form and select the form you want to use depending on the type of feature you want to collect or modify (building, road, or point of interest).
-
Fill out the form (see examples). You continue filling out the form by swiping to the right (swiping forward). Part of this process is launching OpenMapKit from the form. In OpenMapKit you will either click on an existing feature or drop a new pin. You will then be able to edit any of the tags for the feature type.
-
When you are done with the tagging in OpenMapKit you will confirm and save the tag edits to ODK Collect and it will take you back to finalizing and saving the form in ODK Collect.
Repeat this process for each object you collect or modify in the field.
-
You need to first select the appropriate form for the type of feature you want to edit, or else the wrong tags will show up.
-
You will not see the OSM data unless you are zoomed in far enough.
After field collection you need to submit your forms back into Ona once you have an active internet connection.
After your forms are in Ona you can download them onto your computer. Log into ona.io, and for each type of form download a Zip folder of media attachments.
Open the JOSM OpenStreetMap Editor. Open the multiple OSM files (File > Open). Merge the OSM files (In the Layers window, select all of the OSM files, right-click and select merge). Now you can evaluate the features you collected from the field with the existing OpenStreetMap data and upload the new data into OpenStreetMap!