Skip to main content

Open-source participatory mapping framework

Project description

# GeoKey

[![Build Status](]( [![Coverage Status](]( [![Requirements Status](]( [![Code Health](](

GeoKey is a platform for participatory mapping that is currently developed at [Extreme Citizen Science Research Group]( at University College London.

## Developing

### Install for development

#### Installing pre-requisites

1. Update your system

sudo apt-get update && sudo apt-get upgrade

2. Install Postgres and PostGIS (we follow the [official guides](

sudo sh -c 'echo "deb wheezy-pgdg main" >> /etc/apt/sources.list'
wget --quiet -O - | sudo apt-key add -
sudo apt-get update

sudo apt-get install postgresql-9.4-postgis-2.1 postgresql-contrib postgresql-server-dev-9.4

3. Setup all other dependencies

sudo apt-get install python-pip python-virtualenv python-dev libjpeg-dev binutils libproj-dev gdal-bin python-gdal

#### Setup the database

1. For simplicity, switch to user postgres:

sudo su - postgres

2. Install postgis in template1 (only required for running tests):

psql -d template1 -c 'create extension hstore;'

3. Log in to the database


4. Create the user

postgres=# CREATE USER django WITH PASSWORD 'django123';

5. Make _django_ super user on your data base (this is required for tests only and shouldn't be done in production):

postgres=# ALTER ROLE django WITH superuser;

6. Create the database

postgres=# CREATE DATABASE geokey OWNER django;

7. Log out and connect to database geokey:

postgres=# \q
$ psql -d geokey

8. Install the extensions on database geokey

geokey=# CREATE EXTENSION postgis;
geokey=# CREATE EXTENSION hstore;

9. Logout of database geokey and logout user postgres

geokey=# \q
$ logout

#### Setting up GeoKey

1. Clone the repository (you should use your own fork)

git clone

2. Install the package and development requirements

cd geokey
pip install -e .
pip install -r requirements.txt
pip install -r requirements-dev.txt

You may need to add `sudo ` before the `pip` commands, unless you are logged in as root or working within a virtual environment.

3. Copy the directory `local_settings.example` to `local_settings`

cp -r local_settings.example local_settings

4. Inside `local_settings` open `` in a text editor and add your database settings:

'default': {
'ENGINE': 'django.contrib.gis.db.backends.postgis',
'NAME': 'geokey',
'USER': 'django',
'PASSWORD': 'django123',
'HOST': 'localhost',
'PORT': '',

SECRET_KEY = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'

5. Migrate the database

python migrate

6. Add yourself as super user. You can use the same email and password to log into the system later.

python createsuperuser

### Run the test server

python runserver

### Run tests

python test

## We use open-source technologies

GeoKey was built using some amazing open-source technology. We would like to thank all contributors to these projects:

- [Django](
- [django-hstore](
- [django-rest-framework](
- [django-rest-framework-gis](
- [django-allauth](
- [django-oauth-toolkit](
- [django-model-utils](
- [django-simple-history](
- [django-aggregate-if](
- [django-youtube](
- [django-braces](
- [django-pgjson](
- [psycopg2](
- [iso8601](
- [pillow](
- [django_nose](
- [pytz](
- [gdata](
- [easy-thumbnails](
- [moment](
- [requests](
- [factory-boy](
- [Leaflet](
- [Leaflet Draw](
- [jQuery](
- [Bootstrap](

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for geokey, version 0.8
Filename, size File type Python version Upload date Hashes
Filename, size geokey-0.8.tar.gz (3.2 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page