Installation
pip install django-geoip-utils
In your settings write:
import geoip_utils GEOIP_PATH = geoip_utils.where()
This product includes GeoLite data created by MaxMind, available from http://maxmind.com/
Settings
GEOIP_REQUEST_IP_RESOLVER
- Default:
'geoip_utils.core.remote_addr_ip'
The function used for getting the IP of the client from the request.
- Options:
'geoip_utils.utils.remote_addr_ip'
Uses the REMOTE_ADDR of the request. Good for development and standard setup
'geoip_utils.utils.x_forwarded_ip'
Picks the first IP of the HTTP_X_FORWARDED_FOR request header. This is useful for Load balancers, but could be spoofed in some cases. Amazon ELB sets this reliably though.
'geoip_utils.utils.real_ip'
Uses the HTTP_X_REAL_IP attribute
GEOIP_CACHE_METHOD
- Default:
django.contrib.gis.geoip.GeoIP.GEOIP_STANDARD
The caching function used for retrieving the location.
- Options:
django.contrib.gis.geoip.GeoIP.GEOIP_STANDARD
Read database from filesystem, uses least memory
django.contrib.gis.geoip.GeoIP.GEOIP_MEMORY_CACHE
Load database into memory, faster performance but uses more memory
django.contrib.gis.geoip.GeoIP.GEOIP_CHECK_CACHE
check for updated database. If database has been updated, reload filehandle and/or memory cache. This option is not thread safe but is good for development.
django.contrib.gis.geoip.GeoIP.GEOIP_INDEX_CACHE
Just cache the most frequently accessed index portion of the database, resulting in faster lookups than GEOIP_STANDARD, but less memory usage than GEOIP_MEMORY_CACHE - useful for larger databases such as GeoIP Organization and GeoIP City. Note, for GeoIP Country, Region and Netspeed databases, GEOIP_INDEX_CACHE is equivalent to GEOIP_MEMORY_CACHE.
django.contrib.gis.geoip.GeoIP.GEOIP_MMAP_CACHE
Loads database into mmap shared memory (not available on Windows).
Utilities
There are a few server utility functions to make the handling easier:
from geoip_utils import core as geoip geoip.get_country(request) geoip.get_city(request) geoip.get_lat_lon(request) geoip.get_country_code(request) geoip.get_country_name(request)
Template filters
There are filters for extracting the information you need in the templates. You need to have django.core.context_processors.request enabled in your TEMPLATE_CONTEXT_PROCESSORS:
{% load geoip_tags %}
{{ request|country_code_of_request }}
{{ request|city_name_of_request }}
{{ request|postal_code_of_request }}
{{ request|region_of_request }}
{{ request|dma_code_of_request }}
{{ request|area_code_of_request }}
{{ request|lat_of_request }}
{{ request|lon_of_request }}
Management command
You can run the update_geoip_data management command to download updated GeoIP data in place.
Release files for django-geoip-utils 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| django-geoip-utils-0.1.1.tar.gz | 12.4 MB | Details |
Release files / django-geoip-utils-0.1.1.tar.gz
| Download URL | django-geoip-utils-0.1.1.tar.gz |
|---|---|
| Size | 12.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
29e47a4a4be283c8b80db5c72820325686b7130a9cd4294bc0b1ab8269c99002
|
|
BLAKE2b-256 checksum How to use checksums |
3a33a7c5c7d80dadad2d50bdf82ceed4273b0ad31d52a8dcb5205de26e4c92b3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
