Metadata-Version: 1.0
Name: django-os-geocoder
Version: 0.1.1
Summary: A Django app that lets you load Ordnance Survey data and use it to find places.
Home-page: https://github.com/mysociety/django-os-geocoder
Author: mySociety
Author-email: programmers@mysociety.org
License: UNKNOWN
Description: ========
        Geocoder
        ========
        
        This is a Django app that lets you load Ordnance Survey data and use it to find places.
        
        A list of ``Places`` from the Ordnance Survey is stored in a spatial database, and a url is provided to query them by name and return a JSON response containing matching places. Useful for autocompleting inputs that take town, city or road names.
        
        In addition, the places are filtered by a series of bounding boxes, so that only places within the supplied boxes are returned.
        
        
        Prerequisites
        -------------
        * A GeoDjango (https://docs.djangoproject.com/en/dev/ref/contrib/gis/tutorial/#introduction) project (Note, this has only been tested with Django 1.4.5 and a PostGIS database)
        
        
        Installation
        ------------
        1. Add ``geocoder`` to your ``INSTALLED_APPS`` list in settings.py
        2. Import the geocoder ajax url into your project's urls.py
        3. Set ``GEOCODER_BOUNDING_BOXES`` to include one or more bounding boxes
        4. Run ``python manage.py syncdb``
        5. Restart your web server, if necessary.
        
        
        Data
        ----
        http://www.ordnancesurvey.co.uk/oswebsite/products/os-opendata.html
        
        The Ordnance Survey make large data sets available under an open license. See the url above for more details. This app uses the OS Locator and 1:50k Gazetteer.
        
        
        Importing data
        --------------
        - Download the data from the Ordnance Survey website.
        - Set the ``GEOCODER_BOUNDING_BOXES`` entry in your ``settings.py``.
        - Import the data using one of the import management commands, the path to the data file is the only argument.
        
        
        Licensing
        ---------
        Anywhere you make use of the data from the OS you should display the following text:
        
        > Contains Ordnance Survey data © Crown copyright and database right 2013
        
        See the OS OpenData Licensing: http://www.ordnancesurvey.co.uk/oswebsite/opendata/licensing.html for more details.
        
Platform: UNKNOWN
Classifier: Framework :: Django
