Geolocation dengan GeoIP

Ditinggalkan sejak versi 1.9: This module is deprecated in favor of django.contrib.gis.geoip2, which supports IPv6 and the GeoLite2 database format.

The GeoIP object is a ctypes wrapper for the MaxMind GeoIP C API. [1]

In order to perform IP-based geolocation, the GeoIP object requires the GeoIP C library and either the GeoIP Country or City datasets in binary format (the CSV files will not work!). These datasets may be downloaded from MaxMind. Grab the GeoLiteCountry/GeoIP.dat.gz and GeoLiteCity.dat.gz files and unzip them in a directory corresponding to what you set GEOIP_PATH with in your settings. See the example and reference below for more details.

Contoh

Assuming you have the GeoIP C library installed, here is an example of its usage:

>>> 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)'

Pengaturan GeoIP

GEOIP_PATH

A string specifying the directory where the GeoIP data files are located. This setting is required unless manually specified with path keyword when initializing the GeoIP object.

GEOIP_LIBRARY_PATH

A string specifying the location of the GeoIP C library. Typically, this setting is only used if the GeoIP C library is in a non-standard location (e.g., /home/sue/lib/libGeoIP.so).

GEOIP_COUNTRY

The basename to use for the GeoIP country data file. Defaults to 'GeoIP.dat'.

GEOIP_CITY

The basename to use for the GeoIP city data file. Defaults to 'GeoLiteCity.dat'.

API GeoIP

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

The GeoIP object does not require any parameters to use the default settings. However, at the very least the GEOIP_PATH setting should be set with the path of the location of your GeoIP data sets. The following initialization keywords may be used to customize any of the defaults.

Argumen Katakunci	Deskripsi
path	Base directory to where GeoIP data is located or the full path to where the city or country data files (.dat) are located. Assumes that both the city and country data sets are located in this directory; overrides the GEOIP_PATH settings attribute.
cache	The cache settings when opening up the GeoIP datasets, and may be an integer in (0, 1, 2, 4) corresponding to the GEOIP_STANDARD, GEOIP_MEMORY_CACHE, GEOIP_CHECK_CACHE, and GEOIP_INDEX_CACHE GeoIPOptions C API settings, respectively. Defaults to 0 (GEOIP_STANDARD).
country	The name of the GeoIP country data file. Defaults to GeoIP.dat. Setting this keyword overrides the GEOIP_COUNTRY settings attribute.
city	The name of the GeoIP city data file. Defaults to GeoLiteCity.dat. Setting this keyword overrides the GEOIP_CITY settings attribute.

Cara GeoIP

Meminta

All the following querying routines may take either a string IP address or a fully qualified domain name (FQDN). For example, both '205.186.163.125' and 'djangoproject.com' would be valid query parameters.

GeoIP.city(query)[sumber]

Returns a dictionary of city information for the given query. Some of the values in the dictionary may be undefined (None).

GeoIP.country(query)[sumber]

Returns a dictionary with the country code and country for the given query.

GeoIP.country_code(query)[sumber]

Mengembalikan hanya kode negara sesuai dengan permintaan

GeoIP.country_name(query)[sumber]

Mengembalikan hanya nama negara sesuai dengan permintaan

Pengambilan Kordinat

GeoIP.coords(query)[sumber]

Mengembalikan sebuah tuple kordinat dari (longitude, latitude).

GeoIP.lon_lat(query)[sumber]

Mengembalikan sebuah tuple kordinat dari (longitude, latitude).

GeoIP.lat_lon(query)[sumber]

Mengembalikan sebuah tuple kordinat dari (latitude, longitude),

GeoIP.geos(query)[sumber]

Mengembalikan obyek django.contrib.gis.geos.Point sesuai dengan permintaan.

Informasi Basisdata

GeoIP.country_info

Sifat ini mengembalikan informasi tentang basisdata negara GeoIP.

GeoIP.city_info

Sifat ini mengembalikan informasi tentang basisdata kota GeoIP.

GeoIP.info

Sifat ini mengembalikan informasi tentang semua basisdata GwoIP (kedua kota dan negara), dan versi dari pustaka C GeoIP (jika didukung).

Metode penyesuaian API GeoIP-Python

These methods exist to ease compatibility with any code using MaxMind's existing Python API.

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

This classmethod instantiates the GeoIP object from the given database path and given cache setting.

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)

Catatan kaki

[1]	GeoIP(R) adalah merek dagang terdaftar dari MaxMind, LLC dari Boston, Massachusetts.