Platform for participatory mapping
Project description
GeoKey
GeoKey is a platform for participatory mapping, that is developed by Extreme Citizen Science research group at University College London.
Install for development
GeoKey can be run on Python 2.7 only.
Update your system:
sudo apt-get update && sudo apt-get upgradeInstall PostgreSQL and PostGIS (we follow the official guides):
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt wheezy-pgdg main" >> /etc/apt/sources.list'
wget --quiet -O - http://apt.postgresql.org/pub/repos/apt/ACCC4CF8.asc | sudo apt-key add -
sudo apt-get update
sudo apt-get install postgresql-9.4-postgis-2.1 postgresql-contrib postgresql-server-dev-9.4Setup all other dependencies:
sudo apt-get install python-pip python-virtualenv python-dev libjpeg-dev binutils libproj-dev libav-tools gdal-bin python-gdalFor Ubuntu you might also need to install libavcodec-extra-52 or libavcodec-extra-53.
Setup database
For simplicity, switch to user postgres:
sudo su - postgresInstall PostGIS in template1 (required for running tests):
psql -d template1 -c 'create extension hstore;'Log in to the database:
psqlCreate the user (replace django with your user):
postgres=# CREATE USER django WITH PASSWORD 'django123';Make created user a superuser on your database (this is required for tests only and shouldn’t be done in production):
postgres=# ALTER ROLE django WITH superuser;Create the database (replace django with your user and geokey with a desired name for the database):
postgres=# CREATE DATABASE geokey OWNER django;Log out and connect to the database:
postgres=# \q
psql -d geokeyInstall the required extensions:
geokey=# CREATE EXTENSION postgis;
geokey=# CREATE EXTENSION hstore;Log out of the database and a user:
geokey=# \q
logoutSetup GeoKey
Clone the repository:
git clone https://github.com/ExCiteS/geokey.gitInstall the package and development requirements:
cd geokey
pip install -e .
pip install -r requirements.txt
pip install -r requirements-dev.txtYou may need to add sudo before the pip commands, unless you are logged in as root or working within a virtual environment.
Copy the directory local_settings.example to local_settings
cp -r local_settings.example local_settingsInside the local_settings open settings.py in a text editor and…
Add your database settings:
DATABASES = {
'default': {
'ENGINE': 'django.contrib.gis.db.backends.postgis',
'NAME': 'geokey',
'USER': 'django',
'PASSWORD': 'xxxxxxxxx',
'HOST': 'host', # usually 'localhost'
'PORT': ''
}
}Set the secret key:
SECRET_KEY = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'Set the STATIC_ROOT directory:
STATIC_ROOT = '/some/path/'Migrate the database:
python manage.py migrateAdd yourself as a superuser (you can use the same email and password to log into the system later):
python manage.py createsuperuserRun the collectstatic management command:
python manage.py collectstaticRun the test server
python manage.py runserver 0.0.0.0:8000Run tests
python manage.py testRunning tests will remove all uploaded images of contributions from the assets directory. If you require to keep them, please use custom test settings with a –settings flag.
We use open-source technologies
GeoKey was built using some amazing open-source technology. We would like to thank all contributors to these projects:
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
