=========
GeoDjango
=========

.. module:: django.contrib.gis
    :synopsis: Geographic Information System (GIS) extensions for Django

GeoDjango is an included contrib module for Django that turns it into a
world-class geographic Web framework. GeoDjango strives to make it as simple
as possible to create geographic Web applications, like location-based services.
Its features include:

* Django model fields for `OGC`_ geometries
* Extensions to Django's ORM for querying and manipulating spatial data.
* Loosely-coupled, high-level Python interfaces for GIS geometry operations and
  data formats
* Editing geometry fields from the admin

.. _OGC: http://www.opengeospatial.org/

First steps
===========

* **From scratch:**
  :doc:`Installation <install/index>`

* **Tutorial:**
  :doc:`Part 1: Models and lookups <intro/tutorial01>` |
  :doc:`Part 2: The admin site <intro/tutorial02>` |
  :doc:`Part 3: Representing geographical data <intro/tutorial03>`

Models
======

.. toctree::
   :maxdepth: 1

   model-fields
   db-api
   functions
   geoquerysets
   measure

Forms
=====

.. toctree::
   :maxdepth: 1

   forms

Working with GeoDjango
======================

.. toctree::
   :maxdepth: 1

   admin
   feeds
   sitemaps
   commands
   testing

Dealing with geographical data
==============================

* :ref:`dealing-with-geometry-objects`
* :ref:`dealing-with-measurement-objects`
* :doc:`data-import`

Common usecases
===============

.. toctree::
   :maxdepth: 1

   serializers
   feeds
   sitemaps
   geoip
   geoip2
   layermapping

Reference
=========

.. toctree::
   :maxdepth: 1

   geos
   gdal
   ogrinspect