GoeDjango Application Example

In this post we will learn about the basic steps required to setup geodjango

Code repository : https://github.com/tayyabsayyad/treemapping

Tools required

  1. Python 3
  2. pip package manager
  3. virtualen for manageing virtual envirnments
  4. Django
  5. Geodjango
  6. Postgresql
  7. postgis GIs extension for the Postgresql
  8. pgadmin for manageing the databases
  9. pycharm or Atom code editor
  10. Geoserver for serving maps
  11. psycopg2 for Python postgre adaptor
  12. Android Studio

Setup the project

  1. Create a virtual Envirnment ( Install Virtualenv tool in you system if not installed)

     python3 -m venv env
    
  2. Activate the envirnment

      source env/bin/activate
    
  3. Install Django ( Install pip if not installed in system)

     pip install django
    
  4. Create Project

     django-admin.py startproject tree
    
  5. Configure the posgreSQL database

       DATABASES = {
       'default': {
       'ENGINE': 'django.contrib.gis.db.backends.postgis',
       'NAME': 'database_name',
       'USER': 'user_name_database',
       'PASSWORD': 'password',
       'HOST': 'localhost',
       'PORT': '5432'
       }
       }
    
  6. Install Required libraries

     pip install psycopg2-binary
     pip install geos
     pip install pyproj
     pip install geoip
     pip install django-leaflet
    

    To install the postgis and geoserver refer Post : Installation of PostGIS

  7. Add geodjango framework in the setting.py file

     INSTALLED_APPS = [
     # [...]
     'django.contrib.gis'
     ]
    

Create Application

Now we will make Create the treemapping app, we will add its model, migrate the database, add view function and finally a template for frount end

  1. Create Application as treemapping

    python manage.py startapp shops
    
  2. Add treemapping app into INSTALLED_APPS in setting.py

       INSTALLED_APPS = [
       # [.....]
       'django.contrib.gis'
       'treemapping',
       ]
    
  3. Creating a model for tree mapping application add following to the treemapping/models

       class TreeData(models.Model):
       treeID = models.IntegerField(default=0)
       location = models.PointField()
       commonName = models.CharField(max_length=100)
       scientificName = models.CharField(max_length=100)
       trunkDiameter = models.IntegerField(default=0)
       treeHeight = models.IntegerField(default=0)
       datePlanted = models.DateTimeField(auto_now=True)
       condition = models.CharField(max_length=100)
       treeStewardship = models.CharField(max_length=100)
       address = models.CharField(max_length=100)
       city = models.CharField(max_length=100)
       pincode = models.IntegerField(default=413405)
    
  4. Creating Tables in the database

     python manage.py makemigrations
     python manage.py migrate
    
  5. Add super user to your application

     python manage.py createsuperuser
    
  6. Register Admin Module on treemapping/admin.py

     from django.contrib import admin
     from .models import TreeData
    
     admin.site.register(TreeData)
    

By default it will use openlayer for displaying map, if you want to use the openstreetmap then use folllwoing way to register admin Module

  from django.contrib.gis.admin import OSMGeoAdmin
  from django.contrib.gis import admin

  from .models import TreeData


  @admin.register(TreeData)
  class TreeAdmin(OSMGeoAdmin):
      list_display = ('location', 'city')
  1. Finally run django server

     python manage.py runserver
    

    Example image