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

Объект GeoIP2 является оболочкой для библиотеки MaxMind geoip2 Python. [1]

Для выполнения геолокации на основе IP-адреса объекту GeoIP2 необходим пакет geoip2 Python и наборы данных GeoIP Country и/или City в двоичном формате (файлы CSV не подойдут!), загруженные, например, с сайтов MaxMind или DB-IP. Скачайте файлы GeoLite2-Country.mmdb.gz и GeoLite2-City.mmdb.gz и распакуйте их в директорию, соответствующую настройке GEOIP_PATH.

Кроме того, рекомендуется установить библиотеку libmaxminddb C, чтобы geoip2 могла использовать более высокую скорость библиотеки C.

Пример

Вот пример ее использования:

>>> from django.contrib.gis.geoip2 import GeoIP2
>>> g = GeoIP2()
>>> g.country("google.com")
{'continent_code': 'NA',
 'continent_name': 'North America',
 'country_code': 'US',
 'country_name': 'United States',
 'is_in_european_union': False}
>>> g.city("72.14.207.99")
{'accuracy_radius': 1000,
 'city': 'Mountain View',
 'continent_code': 'NA',
 'continent_name': 'North America',
 'country_code': 'US',
 'country_name': 'United States',
 'is_in_european_union': False,
 'latitude': 37.419200897216797,
 'longitude': -122.05740356445312,
 'metro_code': 807,
 'postal_code': '94043',
 'region_code': 'CA',
 'region_name': 'California',
 'time_zone': 'America/Los_Angeles',
 'dma_code': 807,
 'region': 'CA'}
>>> g.lat_lon("salon.com")
(39.0437, -77.4875)
>>> g.lon_lat("uh.edu")
(-95.4342, 29.834)
>>> g.geos("24.124.1.80").wkt
'POINT (-97 38)'

Справочник API

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

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

Методы

Инициализация

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

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

Запросы

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

GeoIP2.city(query) [source]

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

GeoIP2.country(query) [source]

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

GeoIP2.country_code(query) [source]

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

GeoIP2.country_name(query) [source]

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

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

GeoIP2.coords(query) [source]

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

GeoIP2.lon_lat(query) [source]

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

GeoIP2.lat_lon(query) [source]

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

GeoIP2.geos(query) [source]

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

Настройки

GEOIP_PATH

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

GEOIP_COUNTRY

Базовое имя для использования в файле данных GeoIP для страны. По умолчанию 'GeoLite2-Country.mmdb'.

GEOIP_CITY

Базовое имя для использования в файле данных GeoIP для города. По умолчанию 'GeoLite2-City.mmdb'.

Исключения

exception GeoIP2Exception [source]

Исключение, выбрасываемое при возникновении ошибки в вызове подлежащей библиотеки geoip2.

Примечания