Геолокация с GeoIP

Объект GeoIP является оболочкой ctypes для MaxMind GeoIP C API. [1]

Для выполнения геолокации на основе IP-адреса объект GeoIP требует библиотеку GeoIP C и наборы данных GeoIP Страна или Город в двоичном формате (файлы CSV не подойдут!). Эти наборы данных можно скачать с MaxMind. Скачайте файлы GeoLiteCountry/GeoIP.dat.gz и GeoLiteCity.dat.gz и распакуйте их в директорию, соответствующую тому, что вы задали в настройках GEOIP_PATH. Более подробные сведения см. в примере и справке ниже.

Пример

Предполагая, что у вас установлена библиотека GeoIP C, вот пример её использования:

>>> from django.contrib.gis.geoip import GeoIP
>>> g = GeoIP()
>>> g.country('google.com')
{'country_code': 'US', 'country_name': 'United States'}
>>> g.city('72.14.207.99')
{'area_code': 650,
'city': 'Mountain View',
'country_code': 'US',
'country_code3': 'USA',
'country_name': 'United States',
'dma_code': 807,
'latitude': 37.419200897216797,
'longitude': -122.05740356445312,
'postal_code': '94043',
'region': 'CA'}
>>> g.lat_lon('salon.com')
(37.789798736572266, -122.39420318603516)
>>> g.lon_lat('uh.edu')
(-95.415199279785156, 29.77549934387207)
>>> g.geos('24.124.1.80').wkt
'POINT (-95.2087020874023438 39.0392990112304688)'

GeoIP Настройки

GEOIP_PATH

Строка, указывающая директорию, в которой расположены файлы данных GeoIP. Эта настройка обязательна, если не указана вручную с помощью ключевого слова path при инициализации объекта GeoIP.

GEOIP_LIBRARY_PATH

Строка, указывающая расположение библиотеки GeoIP C. Как правило, эта настройка используется только в том случае, если библиотека GeoIP C находится в нестандартном месте (например, /home/sue/lib/libGeoIP.so).

GEOIP_COUNTRY

Используемое имя файла данных GeoIP для страны. По умолчанию 'GeoIP.dat'.

GEOIP_CITY

Используемое имя файла данных GeoIP для города. По умолчанию 'GeoLiteCity.dat'.

GeoIP API

class GeoIP(path=None, cache=0, country=None, city=None) [source]

Для использования объекта GeoIP не требуется никаких параметров, так как используются значения по умолчанию. Однако, по крайней мере, следует установить настройку GEOIP_PATH с путём к наборам данных GeoIP.

Следующие ключевые слова инициализации могут использоваться для настройки значений по умолчанию.

GeoIP Методы

Запросы

Все следующие запросы могут принимать строковый IP-адрес или полное доменное имя (FQDN). Например, как '205.186.163.125' и 'djangoproject.com' являются допустимыми параметрами запроса.

GeoIP.city(query) [source]

Возвращает словарь с информацией о городе для заданного запроса. Некоторые значения в словаре могут быть неопределёнными (None).

GeoIP.country(query) [source]

Возвращает словарь с кодом страны и названием страны для заданного запроса.

GeoIP.country_code(query) [source]

Возвращает только код страны, соответствующий запросу.

GeoIP.country_name(query) [source]

Возвращает только название страны, соответствующее запросу.

Получение координат

GeoIP.coords(query) [source]

Возвращает кортеж координат (долгота, широта).

GeoIP.lon_lat(query) [source]

Возвращает кортеж координат (долгота, широта).

GeoIP.lat_lon(query) [source]

Возвращает кортеж координат (широта, долгота).

GeoIP.geos(query) [source]

Возвращает объект django.contrib.gis.geos.Point, соответствующий запросу.

Информация о базе данных

GeoIP.country_info

Этот свойство возвращает информацию о базе данных GeoIP для страны.

GeoIP.city_info

Этот свойство возвращает информацию о базе данных GeoIP для города.

GeoIP.info

Этот свойство возвращает информацию обо всех базах данных GeoIP (города и страны), а также версию библиотеки GeoIP C (если поддерживается).

Методы совместимости с GeoIP-Python API

Эти методы существуют для упрощения совместимости с любым кодом, использующим существующий Python API MaxMind.

classmethod GeoIP.open(path, cache) [source]

Этот метод класса создаёт объект GeoIP из заданного пути к базе данных и заданной настройкой кэша.

GeoIP.region_by_addr(query)

GeoIP.region_by_name(query)

GeoIP.record_by_addr(query)

GeoIP.record_by_name(query)

GeoIP.country_code_by_addr(query)

GeoIP.country_code_by_name(query)

GeoIP.country_name_by_addr(query)

GeoIP.country_name_by_name(query)

Примечания