Зміни

Опис реєстру

Єдиний державний реєстр адрес (далі - ЄДРА) - реєстр де зберігається інформація про всі наявні адреси в Україні.

Основною метою створення ЄДРА є зберігання, управління та підтримання  найбільш повної, достовірної та актуальної інформації про адреси.

ЄДРА підтримує державні послуги, які вимагають верифікації адреси, що спрощує процеси реєстрації місця проживання, укладання договорів та інші послуги. Однією з основних задач ЄДРА є вдосконалення електронних послуг та сервісів, що пов’язані з нерухомістю, об’єктами будівництва та їх адресацією.

ЄДРА є частиною Системи реєстрів, яка додатково включає:

1. Єдиний державний реєстр адміністративно-територіальних одиниць (ЄДРАТО):
   • Містить дані про населені пункти, громади, райони та їх межі.
   • Використовує кодифікатор адміністративно-територіальних одиниць (КАТОТТГ).
2. Реєстр будівель та споруд (РБС):
   • Зберігає інформацію про фізичні об’єкти (будівлі, споруди, приміщення), включно з їх геометрією та характеристиками.

АРІ є єдиним для всієї Системи реєстрів, тобто методи АРІ можуть бути однаково застосовані до всіх трьох складових.

Варіанти використання даних реєстру (можливі):

• реєстрація місця проживання та зміна адреси
• підтримка точності даних в інших державних реєстрах. ДРРП, ЄДДР та інші реєстри інтегруються з ЄДРА, щоб мати актуальні адресні дані. Це полегшує перевірку інформації про нерухомість та місце проживання при оформленні права власності або реєстрації громадян
• організація виборів та підготовка виборчих списків
• планування та розвиток інфраструктури: органи місцевого самоврядування можуть використовувати ЄДРА для просторового планування та розвитку інфраструктури (доріг, мереж, закладів охорони здоров'я та освіти), оскільки наявність актуальних даних про адреси полегшує розуміння демографічної ситуації та потреб регіону.
• інформаційна підтримка у банківських та фінансових операціях, банки та фінансові установи можуть використовувати ЄДРА для перевірки адреси клієнтів під час відкриття рахунків або оформлення кредитів, щоб уникнути шахрайства і забезпечити точність даних
• оптимізація логістики та комунальних послуг: логістичні компанії та служби доставки (поштові, кур'єрські служби) використовують інформацію з ЄДРА для точного визначення адрес клієнтів, що полегшує доставку товарів та знижує ризики помилок, комунальні підприємства використовують дані реєстру для надання послуг за коректною адресою та спрощення роботи з клієнтами.
• забезпечення безпеки та правопорядку, використання реєстру правоохоронними органами та рятувальними службами
• забезпечення точності статистичних даних: державна служба статистики та інші аналітичні органи використовують ЄДРА для збору та аналізу даних про населення та житловий фонд, що допомагає формувати ефективну державну політику та програм

Для забезпечення варіантів використання ЄДРА має наступні сервіси:

• отримання детальної інформації про адміністративно-територіальну одиницю (АТО) з межами об’єктів;
• отримання переліку об’єктів АТО за глобальним ідентифікатором об'єкта вищого рівня, наприклад список населених пунктів в громаді
• отримання списку вулиць за ідентифікатором вищого рівня, наприклад списку вулиць населеного пункту
• отримання інформації по об'єктах за їх ідентифікатором
• отримання зі списку об’єктів за полігоном, координатами точки або за ідентифікатором об'єкта вищого рівня
• отримання інформації за повнотекстовим пошуком в межах населеного пункту з вказанням типу об’єкта
• отримання інформації про АТО за текстовим запитом із зазначенням типів об’єктів
• отримання історії у вигляді архіву з відповідним типом файлів за містом по вулицях та адресам за певний період, який буде вказано
• зміна, додавання адрес, наприклад при неправильній або відсутній адресі громадянин може звернутися до ЦНАП (чи через інший орган, чи систему, що підключена до АРІ ЄДРА) та виправити неправильну або додати нову адресу в реєстр.

Нормативна база

1. Постанова КМУ №254 від 05.03.2024
2. Постанова КМУ №690 від 07.07.2021
3. Нормативна документація в стадії розробки

Профільні держоргани

Профільне міністерство: Міністерство розвитку громад та територій України (Мінінфраструктури)

Адміністратор: ДП «А­ДМІ­НІ­СТРА­ТОР МБКД»

Технічний адміністратор: ДП «Дія»

Контактна особа з боку реєстру:
(особа, яка може зорієнтувати по актуальності АРІ, або запланованих змінах, попередньо від мінʼюсту чи НАІСу, необхідно уточнити після формалізації проєкту)

Немає інформації

Технологія та обмін даних

Технологія: 

Обмін даними доступний через:

• REST (Representational State Transfer);
• SOAP (Simple Object Access Protocol)

Перелік методів (сервісів) для обміну даними для кожної з цих технології однаковий.

Історичність даних

Історичність даних в реєстрі фіксується. Для отримання історії змін по об’єкту реалізований окремий метод “EdraHistory”. Детальніше тут.

Підписка на зміну даних в реєстрі

(використовується, у випадку, якщо необхідно відстежувати зміну статусів обʼєктів чи заяв)

Функціоналу push-сповіщень про зміни в реєстрі не передбачено. Зміну назв адміністративно-територіальних одиниць, вулиць можна прослідкувати за допомогою запиту від користувача, зокрема з використанням методу “EdraHistory”. За цим методом можна отримати перелік об'єктів за певний період з їх статусами. Він надає можливість експортувати історію у вигляді архіву з відповідним типом файлів за територіальною одиницею за певний період (або увесь час). 

Файл генерується у форматі eventStream. Якщо файл уже створювався з такими самими параметрами, він зберігається в кеші системи до одного тижня. Після цього або у випадку повторної генерації файл створюється заново.

Проблеми та обмеження

(Опис проблем з якими стикнулися під час роботи з реєстром, наприклад: вендорлок, обмеження на отримання даних (кількість запитів і т.д., складність нормативного врегулювання інтеграції)

Обмежень за кількістю запитів станом на дату створення опису реєстра немає (див. зміни), проте вони плануються в майбутньому, див. заплановані зміни.

Обмеження доступу до даних

(Заповнюється, у випадку наявності обмежень на пошук даних в реєстрі, наприклад, для медичних даних, персональних даних, даних досудового розслідування)

Немає.

Плата за користування:

Наразі безкоштовно.

Визначення

Опис АРІ

АРІ ЄДРА передає інформацію про:

• адміністративно-територіальні одиниці з ЄДРАТО (області, райони, громади, населені пункти, райони населених пунктів);
• поіменовані об’єкти;
• вулиці;
• номери об’єктів адресації;
• будівлі і споруди.

Реквізити адреси (поіменовані об’єкти, назви вулиць, номери адрес) в ЄДРА можуть перебувати в різних статусах (поле status):

• Імпортований (proposed) - об’єкт імпортовано до реєстру з довідників центрального рівня, проте ще не верифіковано ОМС або інформація про об’єкт уточнюється в ОМС;
• Верифікований (reserved) - існування об’єкту підтверджено відповідальним співробітником ОМС та підписано КЕП.
• Діючий (current) - в ЄДРА завантажено документ підтверджуючий існування/створення адреси. Може використовуватись для юридично значимих операцій;
• Архівний (retired) - об’єкт не актуальний.

Разом зі статусом реквізиту адреси передається інформація про дату присвоєння цього статусу.

Отримання детальної інформації про АТО з межами об’єктів

Назва сервісу: GET/ Edrato

Протокол роботи: REST, SOAP

Відомості, що передаються у запиті:

Пошук даних в реєстрі можливий за глобальним ідентифікатором адміністративно-територіальної одиниці, наприклад:

• UA.ATU.U.00000 - Україна (по Україні)
• UA.ATU.B.80793 - Солом'янський район (райони в містах)
• UA.ATU.O.99709 - обл. Хмельницька (області, Автономна Республіка Крим)
• UA.ATU.P.86061 - Хмельницький район (райони в областях та Автономній Республіці Крим)
• UA.ATU.H.53519 - Хмельницька громада (території територіальних громад (назви територіальних громад) в областях, територіальні громади Автономної Республіки Крим)
• UA.ATU.M.96613 - м. Хмельницький (міста та міста, що мають спеціальний статус)

Загальний опис відповіді:  Метод повертає детальну інформацію про адміністративно-територіальну одиницю (ЄДРАТО) з межами об’єктів.

Детальний опис сервісу: REST, SOAP

Отримання переліку об’єктів АТО за глобальним ідентифікатором об’єкту вищого рівня

Назва сервісу: EdratoList

Протокол роботи: REST, SOAP

Відомості, що передаються у запиті:

• Parent - отримання переліку об'єктів за ідентифікатором об'єкта
• Point - отримання переліку об'єктів за координатами в точці
• Bbox - отримання переліку об'єктів за координатами полігону

Загальний опис відповіді: Метод повертає перелік об’єктів АТО за глобальним ідентіфікатором об’єкту вищого рівня

Детальний опис сервісу: REST, SOAP

Отримання списку вулиць за ідентифікатором вищого рівня
Назва сервісу: GET/ StreetList

Відомості, що передаються у запиті (параметри пошуку):

• Bbox - Отримання списку вулиць, що потрапляють у полігон
• Point - Отримання списку вулиць, що потрапляють у точку
• Parent - Отримання списку вулиць за ідентифікатором об'єкта вищого рівня (наприклад м. Київ)

Загальний опис відповіді: Метод повертає список вулиць за ідентифікатором вищого рівня

Детальний опис сервісу: REST, SOAP

Отримання інформації про об'єкти по їх ідентифікатору

Назва сервісу: GET/ Edra

Протокол роботи: REST, SOAP

Відомості, що передаються у запиті:

• id - Ідентифікатор об'єкта
  • UA.ATU.U.00000 - Україна
  • UA.ATU.K - Місто із спеціальним статусом
  • UA.ATU.O - Область
  • UA.ATU.P - Район в області
  • UA.ATU.H - Тер громада
  • UA.ATU.M - Населений пункт
  • UA.ADR.N - Назви поіменованих об’єктів
  • UA.ADR.S - Назви вулиць
  • UA.ADR.B - Адреса

Можна отримувати дані про конкретну версію об'єкта, для цього потрібно вказати її в кінці, наприклад: UA.ATU.M.XXXXX:001 , де 001 - це версія об'єкта

Загальний опис відповіді: Метод повертає всю інформацію про об'єкт за його ідентифікатором

Детальний опис сервісу: REST, SOAP

Отримання списку об’єктів за полігоном, координатами точки або за ідентифікатором об'єкта вищого рівня

Назва сервісу: GET/ Address

Протокол роботи: REST, SOAP

Відомості, що передаються у запиті:

• id - ідентифікатор адреси (UA.ADR.B)
• Parent - пошук адрес за ідентифікатором вулиці (UA.ADR.S)
• Point - пошук адрес за координатами в точці
• Bbox - пошук адрес за координатами полігону

Можна отримувати дані про конкретну версію адреси, для цього потрібно вказати її в кінці, наприклад: UA.ADR.B.XXXXXXXXXXXX:001 , де 001 - це версія об'єкта

Загальний опис відповіді: Метод повертає список об’єктів за полігоном, координатами точки або за ідентифікатором об'єкта вищого рівня

Детальний опис сервісу: REST, SOAP

Отримання інформації за повнотекстовим пошуком в межах населеного пункту з вказанням типу об’єкта

Назва сервісу: GET/ SearchAddress

Протокол роботи: REST, SOAP

Відомості, що передаються у запиті:

API приймає наступні додаткові параметри:

• similarity - коефіцієнт подібності назви у реєстрі щодо пошукового тексту (searchtext), за замовчуванням - 0.5.
• register - джерело даних. За замовчуванням виконується пошук даних з всіх джерел. На даний момент реалізовано наступні значення:
• cvk - центральна виборча комісія
• dms - державна міграційна служба
• dpa - укрпошта
• ds - держстат
• edesb - єдина державна електронна системи у сфері будівництва
• mvs - міністерство внутрішніх справ
• nais - національна інформаційна система
• oe -обл. енерго
• ozpa - орган з присвоєння адрес
• pd - податкова
• uoma - уповноважений орган містобудування та архітектури
•  limit - обмеження кількості результатів пошуку. За замовчуванням - 5.
• nocache - відключити кешування відповіді.

Загальний опис відповіді: Метод повертає всю інформацію про об'єкт за повнотекстовим пошуком в межах населеного пункту з вказанням типу об’єкта

Детальний опис сервісу: REST, SOAP

Отримання інформації про адміністративно-територіальну одиницю за текстовим запитом із зазначенням типів об’єктів

Назва сервісу: GET/ SearchEdrato

Протокол роботи: REST, SOAP

Відомості, що передаються у запиті:

API приймає наступні додаткові параметри - див. SearchAddress

Загальний опис відповіді: Метод повертає всю інформацію про АТО із межами об’єкта.

Детальний опис сервісу: REST, SOAP

Отримання історії по вулицям та адресам за певний період

Назва сервісу: GET/ EdraHistory

Протокол роботи: REST

Відомості, що передаються у запиті:

API надає можливість вивантажувати дані (адрес, вулиць і об'єктів АТУ) у вигляді архіву з відповідним типом файлів (json або xml) за територіальною одиницею за вказаний період (або увесь час). Якщо файлу з історією змін за вказаними параметрами користувача не існує, або якщо параметри співпадають, але файл згенерований більше тижня тому - то система формує новий файл. Якщо ж файл згенерований в системі і за вказаними параметрами користувача створений менше тижня тому - то він буде вивантажений користувачу. Файл формується у evenStream.

Загальний опис відповіді: метод повертає архів з відповідним типом файлів (json або xml) за територіальною одиницею за вказаний період (або увесь час)

Детальний опис сервісу: REST

Надсилання запитів на додавання/зміну адреси

Назва сервісу: POST/ Appeal

Протокол роботи: SOAP

Відомості, що передаються у запиті:

Апі отримує нову заявку на зміну/додавання адрес, завантажує дані заявки базу і повертає номер заявки та її статуса.

Статус 1 - заявка отримана

Тип заявки:

1 - Додавання відсутньої вулиці

2 - Зміна існуючої вулиці

3 - Додавання відсутньої адреси

4 - Зміна існуючої адреси

id адрес і вулиць беруться лише з API EDRA (Adress, streetList, EdraTo).

Загальний опис відповіді: метод повертає json з номером заявки і уточненням її статусу (наприклад: 1 - заявка отримана)

Детальний опис сервісу: тут

Отримання статусу заявки на на додавання/зміну адреси

Назва сервісу: GET/ Appeal-status

Протокол роботи: SOAP

Відомості, що передаються у запиті:

Апі повертає за номером заявки інформацію по історії зміни статусів і номер заявки, у випадку відхилення заявки повертає також причину відхилення

Статуси:

1 - отримана

2 - взята до розгляду

3 - погоджена

4 - відхилена

Загальний опис відповіді: метод повертає json з історією зміни статусом заявки, у випадку відхилення заявки повертає також причину відхилення

Детальний опис сервісу: тут

Неочевидні дані, які можна отримати з реєстру 

(перелік даних, які не є профільними для реєстру, але можуть бути корисними для інших запитів, наприклад, номер земельної ділянки, дозвіл на будівництво і т.д.)

Під час формування ЄДРА був проведений автоматичний метчинг адрес з 11 різних довідників, наприклад НАІС (АТУ - вулиці), НАІС (ДРРП - номери об’єктів адресації), Держстат, ЦВК, МВС та інші, але ідентифікатори цих довідників збереглися, також передбачені поля за старим класифікаторами КОАТУУ та чинним КАТОТТГ. Ці особливості формуванн ЄДРА дозволяють отримувати дані з реєстру по різним ідентифікатором, в тому числі застарілим.

 

Документація доступна для ознайомлення

(Діаграми основних процесів, ТВ, ТЗ та інші документи, що можуть бути корисними для аналітиків чи розробників)

• Загальна презентація проекту знаходиться за посиланням.
• Документація по АПІ ЄДРА\ЄДРАТО

Зміни структури даних реєстру

Див. заплановані зміни.

Вимоги до обміну даними

Див. опис АРІ.

Публічний інтерфейс

Публічний інтерфейс буде коли верифікують 90%+ вулиць. Будь-хто матиме змогу подивитися свою адресу, якщо вона відсутня або неправильно вказана - подати заявку на додавання або виправлення даних (крауд верифікація). Це перспектива другого кварталу 2025 року.

Відкриті дані 

Наразі немає, але плануються. Коли і в якому обсязі вирішується питання. Попередньо це буде весь реєстр, в який користувач зможе увійти і завантажити собі всі вулиці.

Заплановані зміни в реєстрі

Зміни в реєстрі на які є запит