OpenMapKit Server is the lightweight server component of OpenMapKit that handles the collection and aggregation of OpenStreetMap and OpenDataKit data.
CSS JavaScript HTML Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
api Merge pull request #99 from AmericanRedCross/master_upload_first Jan 18, 2017
data major path refactor, submodules messed up Feb 19, 2016
docs
jekyll add button that fetches enkteo-express url & and adds link to open on… Jan 10, 2017
pages
scripts tar-osm.sh utility script Mar 16, 2016
test Closes #64 Apr 28, 2016
util #24 simple basic auth implementation May 11, 2016
.gitignore refactor: get submissions file to use JSONStream for memory conservation Aug 23, 2016
.gitmodules Removed submodule id May 27, 2016
.nvmrc improve instructions, commit the basic settings.js Feb 19, 2016
LICENSE
README.md #28 Cleanup docs. May 27, 2016
index.js #24 more specific routing May 12, 2016
package.json 0.8.1 Jan 18, 2017
requirements.txt first attempt at installing pyxform Dec 13, 2015
server.js major path refactor, submodules messed up Feb 19, 2016
settings.js Update data.json with changeset info in OSM submission. May 26, 2016

README.md

OpenMapKit Server

OpenMapKit Server is the lightweight NodeJS server component of OpenMapKit that handles the collection and aggregation of OpenStreetMap and OpenDataKit data.

This software is intended to run both on low-power embedded Linux systems, as well as on higher powered, cloud-based servers.

OpenMapKit Server is 100% database free! All data is persisted on the file system.

Development Installation

These instructions are for setting up and running OpenMapKit Server in your development environment.

Production Installation

If you want to run OpenMapKit Server for your field mapping survey, use the POSM Build Installation instructions.

Project Structure

deployments is the OpenMapKit deployment API. This services deployment data in the deployments data directory. Manifest files in this directory are read by OpenMapKit Android as metadata regarding the deployment data provided. Deployments are created by posm-admin. to provision deployment data that is fetched by OpenMapKit Android.

odk is the OpenMapKit ODK API. This is a REST API that handles all of the ODK business logic, including communicating with ODK Collect, as well as serving and ingesting ODK XForm data.

jekyll is where the front end pages live.

pages is where the Jekyll project is built. The pages are served from here.

data is where all of the data is stored on the server's file system.

util has utility functions useful to OpenMapKit Server as a whole.

The Basics

After your installation is done, you can see if the server is alive at:

http://{{your_host_url}}/info

To get forms and send submissions in ODK Collect set:

ODK Collect > General Settings > Configure platform settings > URL

http://{{your_host_url}}

See all of the pages on your server:

http://{{your_host_url}}/pages/

Upload an XLS Form:

http://{{your_host_url}}/pages/upload-form/

API

Check out the API Documentation for details about the REST API.

ZenHub