<meta http-equiv=content-type content="text/html; charset=UTF-8">

<pre>
CNGEOIP 5


Модуль CNGeoip 5 предназначен для быстрого получения географических данных, таких
как страна, область или штат, город, а также географических координат, по которым
зарегистрирован IP-адрес. Информация предоставляется на трех языках: русском,
английском, а также языке страны, в которой зарегистрирован IP-адрес.

В некоторых случаях точное определение географической привязки IP-адреса
невозможно. Например, пользователь выходит в интернет через GPRS Московского
оператора сотовой связи, находясь при этом в Петербурге.

Модуль CNGeoIP5 состоит из файлов базы данных: "cngeoip.dat", "cngeoip.txt",
и файла с функциями на языке php - "cngeoip.php". Подробные примеры использования
функций можно посмотреть в файле "example.php".

Файл "cngeoip.dat" является бинарным файлом и используется в классе CNGeoIP.

Файл "cngeoip.txt" в текстовом виде предоставляет информацию, хранящуюся в
бинарном файле "cngeoip.dat". В классе CNGeoIP не используется, но может быть
полезен пользователям.



КЛАСС CNGeoIP


Метод is_valid() - возвращает true, если экземпляр класса CNGeoIP успешно
загрузил требуемые базы данных и false в противном случае. Если экземпляр не смог
загрузить базы данных, то нижеуказанные методы будут возвращать false.


Метод get_error() - возвращает текстовое значение ошибки, если экземпляр был
создан с ошибкой.


Метод get_place_by_ip($ip4) - возвращает текстовый идентификатор географического
места. Например, "/RU/SZFO/53/NOV". В качестве аргумента указывается IPv4 адрес в форме 
"aaa.bbb.ccc.ddd". В случае, если адрес относится к одной из специальных сетей,
возвращается название этой сети, например "Loopback".


Метод get_description_by_place($place) - возвращает массив, содержащий подробную
информацию о географическом месте.

Элемент №0 содержит информацию о непосредственно месте, следующие элементы - о
вышестоящих объектах, к которым относится место. Последним элементом идет страна.

Каждый элемент является ассоциативным массивом, содержащим (не обязательно)
следующие поля:
*	type: (city, town, village, country, region, federal region, cdp)
*	pop: численность населения
* 	name_ru: название на русском языке
*	name_en: название на английском языке
*	name_??: название на других языках
*	lang: государственный язык (ru/en/ua)
*	lat: географическая широта
*	lon: географическая долгота

Все данные, возвращаемые методом, представлены в кодировке UTF-8.


Метод get_description_by_ip($ip) - является комбинацией вышеуказанных методов.
Фактически вызывается как get_description_by_place(get_place_by_ip($ip)).

Все данные, возвращаемые методом, представлены в кодировке UTF-8.