Geolocation models, data and tools using GeoDjango
Project description
django-atlas
===============
Geolocation models, data and tools using GeoDjango
Requirements
------------
The following were used for development/testing:
1. Django 1.3
2. PostgreSQL 9.1
3. PostGIS 1.5.2
4. SQLite 3.7.9
5. libspatialite3
6. django-photologue 2.7 (fork maintained by Praekelt at https://github.com/praekelt/django-photologue)
7. django-category 0.1 (at https://github.com/praekelt/django-category)
8. django-tastypie 0.9.11
9. libgeoip1 1.4.8
You might need to apply a PostGIS patch to Django that can be found here: https://code.djangoproject.com/ticket/16778. If you get a database encoding error when loading
initial data, your version of Django has not been patched. You can also use SQLite and MySQL with django-atlas, although MySQL is very lacking in terms of GIS.
Add the following to your INSTALLED_APPS:
1. django.contrib.gis
2. django.contrib.admin
3. atlas
4. photologue
5. category
6. tastypie
GeoDjango has some additional installation requirements. They can be found here: https://docs.djangoproject.com/en/dev/ref/contrib/gis/install/.
Follow those instructions and create a spatial database. Then add it to the DATABASES dictionary in your settings as the default database.
::
DATABASES = {
'default': {
'ENGINE': 'django.contrib.gis.db.backends.postgis',
'NAME': 'demo_geo',
'USER': 'demo',
'PASSWORD': 'demo',
'HOST': 'localhost',
'PORT': '',
}
}
Atlas uses MaxMind's IP geolocation library and datasets. The following settings need to be included for this to work:
::
GEOIP_PATH = '.../django-atlas/atlas/datasets/MaxMind/'
GEOIP_CITY = 'GeoLiteCity.dat'
GEOIP_COUNTRY = 'GeoIPv6.dat'
You can also add a Google Maps API key setting (see below). This will enable the LonLatWidget to use Google Maps for selecting coordinates.
::
DJANGO_ATLAS = {
'google_maps_api_key': 'XXX...',
}
Datasets
--------
The geo data required by django-atlas can be downloaded at https://github.com/downloads/praekelt/django-atlas/data_postgresql.tbz2 for PostgreSQL or
https://github.com/downloads/praekelt/django-atlas/data_mysql.tbz2 for MySQL. Extract data.sql and load the data using ``psql -U user -W -d demo_geo < data.sql`` for PostgreSQL, or ``mysql -u user -p -D demo_geo < data.sql``
for MySQL.
MaxMind's IP geolocation datasets are available at http://www.maxmind.com/download/geoip/database/. MaxMind updates these datasets on a regular basis.Authors
=======
Praekelt Foundation
-------------------
* Rizmari Versfeld
===============
Geolocation models, data and tools using GeoDjango
Requirements
------------
The following were used for development/testing:
1. Django 1.3
2. PostgreSQL 9.1
3. PostGIS 1.5.2
4. SQLite 3.7.9
5. libspatialite3
6. django-photologue 2.7 (fork maintained by Praekelt at https://github.com/praekelt/django-photologue)
7. django-category 0.1 (at https://github.com/praekelt/django-category)
8. django-tastypie 0.9.11
9. libgeoip1 1.4.8
You might need to apply a PostGIS patch to Django that can be found here: https://code.djangoproject.com/ticket/16778. If you get a database encoding error when loading
initial data, your version of Django has not been patched. You can also use SQLite and MySQL with django-atlas, although MySQL is very lacking in terms of GIS.
Add the following to your INSTALLED_APPS:
1. django.contrib.gis
2. django.contrib.admin
3. atlas
4. photologue
5. category
6. tastypie
GeoDjango has some additional installation requirements. They can be found here: https://docs.djangoproject.com/en/dev/ref/contrib/gis/install/.
Follow those instructions and create a spatial database. Then add it to the DATABASES dictionary in your settings as the default database.
::
DATABASES = {
'default': {
'ENGINE': 'django.contrib.gis.db.backends.postgis',
'NAME': 'demo_geo',
'USER': 'demo',
'PASSWORD': 'demo',
'HOST': 'localhost',
'PORT': '',
}
}
Atlas uses MaxMind's IP geolocation library and datasets. The following settings need to be included for this to work:
::
GEOIP_PATH = '.../django-atlas/atlas/datasets/MaxMind/'
GEOIP_CITY = 'GeoLiteCity.dat'
GEOIP_COUNTRY = 'GeoIPv6.dat'
You can also add a Google Maps API key setting (see below). This will enable the LonLatWidget to use Google Maps for selecting coordinates.
::
DJANGO_ATLAS = {
'google_maps_api_key': 'XXX...',
}
Datasets
--------
The geo data required by django-atlas can be downloaded at https://github.com/downloads/praekelt/django-atlas/data_postgresql.tbz2 for PostgreSQL or
https://github.com/downloads/praekelt/django-atlas/data_mysql.tbz2 for MySQL. Extract data.sql and load the data using ``psql -U user -W -d demo_geo < data.sql`` for PostgreSQL, or ``mysql -u user -p -D demo_geo < data.sql``
for MySQL.
MaxMind's IP geolocation datasets are available at http://www.maxmind.com/download/geoip/database/. MaxMind updates these datasets on a regular basis.Authors
=======
Praekelt Foundation
-------------------
* Rizmari Versfeld
Project details
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.
Source Distribution
django-atlas-0.1.tar.gz
(12.4 MB
view hashes)
Built Distribution
django_atlas-0.1-py2.7.egg
(12.4 MB
view hashes)