Download the PHP package abpam/ekatte without Composer

EKATТE

Какво е EKATТE?

Списък на населените места в Р. България, сортирани по области и общини, по ЕКАТТЕ (Единен Класификатор на Административно-Териториалните и Териториалните Единици), във вид, удобен за използване в PHP среда.

Кой би имал нужда от подобно нещо?

Разработчици, работещи върху системи за:

• Електронна търговия
• Застрахователни услуги
• Всичко останало, при разработката на което се налага работа с населени места (от потребители и/или администратори).

Какво е необходимо, за да използвам EKATTE?

• php >= 5.3.0 - поради наличието на namespaces, closures и др.
• ext-zip - PHP Plug-in за работа със .zip архиви. Функцията update на EKATTE изтегля .zip архив от сайта на НСИ (Национален Статистически Институт), който трябва да бъде обработен.
• nuovo/spreadsheet-reader - PHP пакет, спомагащ за прочитане на файлове от Excel. В архива от НСИ се съдържат електронни таблици (spreadsheets) в .xls формат, които трябва да бъдат прочетени, след което, информацията от тях да бъде приведена в удобен за използване вид.

Как да инсталирам EKATTE?

Ако разполагате с инсталиран composer глобално (сиреч, composer е инсталиран в системата Ви), просто изпълнете следната команда (в команден ред - Terminal, Konsole, Command Prompt) в папката на проекта ( или в Windows ), в който искате да използвате EKATTE:

Ако работите с composer локално (composer архив във всеки отделен проект) -

в папката на проекта.

Как да използвам EKATTE?

На първо време, трябва да обновите базата до последните данни на НСИ. Това става с помощта на файла vendor/abpam/ekatte/updater.php. През команден ред стигнете до папката и изпълнете:

Ако всичко е наред, резултатът трябва да е:

Забележка:

_Ако по време на обновяването скриптът върне грешка, свързана с кодировка на файловете (encoding), това е проблем при прочитането на .xls файловете от пакета SpreadsheetReader на nuovo. Този проблем се разрешава като ред № 917 на файл /vendor/nuovo/spreadsheet-reader/php-excel-reader/excelreader2.php бъде заменен от:

на:

Укажете на проекта си да използва composer файловете, ако вече не сте го направили:

след което може да получим списък на всички области в Р. България:

Функцията getOblastiList() служи за извличане на списък с всички области. Връща двумерен масив. Първият индекс представлява отделните области, а вторият - параметрите на всяка област:

• 0 - трибуквен код на областта;
• 1 - номер по Екатте, на населеното място, което е център на дадената област;
• 2 - име на областта;
• 3 - код на района към който принадлежи областта;
• 4 - номер на документа, регистриращ последната административно-териториална промяна в областта;
• 5 - пореден номер на областта по азбучен ред).

Функцията getOblast() служи за извличане на информация за определена област. Изисква трибуквения код на областта, подаден като аргумент на функцията, във вид на текстов низ (string) и връща едномерен масив, индексите на когото съответсват на горе посочените. Така, например, ако искаме да получим информация за област „Велико Търново“ е нужно да повикаме функцията по следния начин:

В долу-горе същия формат работят и функциите, касаещи общините. Ако имаме нужда от списък на всички общини в дадена област, ще трябва да си послужим с getObshtiniList(), като подадем като аргумент името на областта, списък на общините в която искаме да получим. Например, ако ни трябва списък на общините в област „Враца“:

Функцията връща двумерен масив, първият индекс на когото показва определена община, а вторият - параметрите ѝ:

• 0 - 5-символен код на общината, състоящ се от трибуквеното означение на областта, в която се намира, заедно с двуцифрен номер, указващ поредността на общината в областта;
• 1 - код по ЕКАТТЕ на населеното място, център на общината;
• 2 - име на общината;
• 3 - категория на общината (критериите за определяне на категорията са описани в Закона за Административно-Териториалното Устройство на Р. България);
• 4 - номер на документа, регистриращ последната административно-териториална промяна в общината;
• 5 - пореден номер по азбучен ред;

По аналогия на функциите, касаещи областите, при общините също имаме функция, връщата информация за конкретна община - getObshtina(). Функцията приема един аргумент (5-символния код на общината) като текстов низ (string) и връща едномерен масив, индексът на когото съответства на втория индекс, върнат от getObshtiniList():

И не на последно място, да разясним функциите, касаещи селищата (градове и села). За да получим списък на селищата в дадена община, можем да си послужим с функцията getSelishtaList(), която приема два аргумента - трибуквен код на област, като текстов низ (string), и 5-символен код на община, също като текстов низ (string). Например, за да получим списък на всички населени места в общ. Свищов, обл. Велико Търново:

Трябва да се отбележи, че вторият аргумент на функцията не е задължителен. Сиреч, ако искаме да получим списък на всички населени места в дадена област (например Бургас), не е нужно да указваме община:

Двете функции връщат масив, чиито индекси отговарят на номера на населеното място по ЕКАТТЕ, а двата елемента са, съответно името на селището и номер на кметството.

Ако искаме по-подробна информация за дадено селище, може да се послужим с функцията getSelishte(), която приема един аргумент (текстов низ - string) - идентификационния номер на селището по ЕКАТТЕ.

Искане за информация относно село Плешивец (Видинско) би изглеждало по следния начин:

тъй като идентификационния номер по ЕКАТТЕ на село Плешивец, обл. Видин е 56753.

Това е базовата информация, нужна за работа с пакета. За допълнителни въпроси, пишете на e-mail [email protected] или в Twitter на @ABPAM.