Оглавление
Сокращения и обозначения
АР - адресный регистр;
КАТО - классификатор административно-территориальных объектов;
RCO, РКО - регистрационный код объекта;
RCA, РКА - регистрационный код адреса;
Геоним - обобщающее понятие для планировочных единиц (территория, микрорайон, владение, площадь и т.д.) и элементов улично-дорожной сети (улица, переулок, проезд и т.д.);
Кадастровый номер - уникальные, не повторяющийся на территории Республики Казахстан, номера, присваиваемые информационной системой Адресный регистр (код АР) Министерства информации и коммуникаций Республики Казахстан;
HTTP – протокол передачи информации в интернете, который расшифровывается как «протокол передачи гипертекста» (HyperText Transfer Protocol);
SSL - протокол, который шифрует и защищает данные во время их передачи по интернету.
Назначение
Адресный регистр (АР) представляет собой базу данных, в которой собрана информация о всех земельных участках, зданиях, сооружениях и иных объектах недвижимости, а также присвоенных им адресах. АР служит для систематизации и организации адресной информации на уровне государства или региона.
Вот несколько основных целей использования адресного реестра:
- Идентификация и локализация объектов недвижимости: АР предоставляет уникальные адреса для каждого объекта недвижимости, что позволяет точно определить его местонахождение. Это важно для таких задач, как доставка почты и грузов, организация экстренных служб, планирование городской инфраструктуры и т.д.
- Правовые и административные процессы: АР используется в юридических и административных процедурах, связанных с недвижимостью, таких как оформление прав собственности, землеустройство, выдача разрешений на строительство и т.д. АР обеспечивает точность и единообразие адресной информации, что способствует упрощению и эффективности этих процессов.
- Статистика и анализ: АР может использоваться для сбора статистических данных о населении, объектах недвижимости, демографии и других параметрах, связанных с адресной информацией. Эти данные могут быть полезными для анализа, планирования и принятия решений на уровне государства или региона.
Назначение
Адресный регистр (АР) представляет собой базу данных, в которой собрана информация о всех земельных участках, зданиях, сооружениях и иных объектах недвижимости, а также присвоенных им адресах. АР служит для систематизации и организации адресной информации на уровне государства или региона.
Вот несколько основных целей использования адресного реестра:
- Идентификация и локализация объектов недвижимости: АР предоставляет уникальные адреса для каждого объекта недвижимости, что позволяет точно определить его местонахождение. Это важно для таких задач, как доставка почты и грузов, организация экстренных служб, планирование городской инфраструктуры и т.д.
- Правовые и административные процессы: АР используется в юридических и административных процедурах, связанных с недвижимостью, таких как оформление прав собственности, землеустройство, выдача разрешений на строительство и т.д. АР обеспечивает точность и единообразие адресной информации, что способствует упрощению и эффективности этих процессов.
- Статистика и анализ: АР может использоваться для сбора статистических данных о населении, объектах недвижимости, демографии и других параметрах, связанных с адресной информацией. Эти данные могут быть полезными для анализа, планирования и принятия решений на уровне государства или региона.
Использование
Взаимодействие осуществляется путем обмена HTTP-сообщениями между клиентскими системами и Адресным регистром через безопасный SSL канал.
Доменное имя узла: https://address-registry.itanalytics.kz
Все описанные ниже методы в виде GET запросов имеют следующию структуру URL запроса:
https://{{ХОСТ}}/api/v1/{{НАЗВАНИЕ_СПРАВОЧНИКА}}?{{ПАРАМЕТРЫ ЗАПРОСА}}
Пример:
https://address-registry.itanalytics.kz/api/v1/localities?name=Астана
Населенные пункты
Населенные пункты - это сборник информации о различных населенных пунктах, таких как города, поселки, села и другие
административные единицы, в пределах определенной РК.
Запрос: GET /api/v1/localities
Параметры запроса:
- limit - количество выдаваемых элементов
- offset - выдавать список начиная с определенного номера элемента
- parent_id - фильтр по ID родительского элемента
- cato - поиск элемента по cato
- name - поиск элемента по соответствию с названием
- rco - поиск по RCO
Response:
{
"actual": true,
"ats_type": {
"short_value_kz": "ауд.",
"short_value_ru": "р-н",
"value_kz": "қала ішіндегі аудан",
"value_ru": "Район в городе"
},
"ats_type_id": 8,
"cato": "351011100",
"children": [],
"full_path_kaz": "Қазақстан Республикасы, Қарағанды облысы, Қарағанды қаласы, Әлихан Бөкейхан ауданы",
"full_path_rus": "Республика Казахстан, область Карагандинская, город Караганда, район Әлихан Бөкейхан",
"id": 213461,
"modified": "2022.02.25T05:45:52",
"name_kaz": "Әлихан Бөкейхан",
"name_rus": "Әлихан Бөкейхан",
"parent_id": 212922,
"rco": "0003000000008710"
}
Геонимы
Общее название градостроительного объекта, обеспечивающего транспортные
и пешеходные связи между жилыми районами, а также между жилыми районами
и промышленными зонами, общественными центрами, кварталами.
Запрос: GET /api/v1/geonims
Параметры запроса:
- limit - количество выдаваемых элементов
- offset - выдавать список начиная с определенного номера элемента
- parent_id - фильтр по ID родительского элемента
- locality_id - фильтр по ID населенного пункта
- cato - поиск элемента по cato
- name - поиск элемента по соответствию с названием
- rco - поиск по RCO
Response:
{
"actual": true,
"ats_id": 9,
"cato": "",
"children": [],
"full_path_kaz": "Қазақстан Республикасы, Павлодар обл., Ақсу қ., 8 Март көш.",
"full_path_rus": "Республика Казахстан, обл. Павлодарская, г. Аксу, ул. 8 Марта",
"geonims_type": {
"code": "11",
"short_value_kz": "көш.",
"short_value_ru": "ул.",
"value_kz": "көшесі",
"value_ru": "улица"
},
"geonims_type_id": 11,
"id": 29,
"modified": "2023.07.10T04:05:04",
"name_kaz": "8 Март",
"name_rus": "8 Марта",
"parent_id": null,
"rco": "0004000000000004"}
Земельные участки
Площадь, местоположение, правовой статус и другие характеристики участка
отражаются в Едином государственном реестре недвижимости. Правовой статус
участка определяет форму законного владения, его целевое назначение и
разрешенное использование.
Запрос: GET /api/v1/grounds
Параметры запроса:
- limit - количество выдаваемых элементов
- offset - выдавать список начиная с определенного номера элемента
- locality_id - фильтр по ID населенного пункта
- geonim_id - фильтр по ID геонима
- cadastre_number - поиск элемента по кадастровому номеру
- name - поиск элемента по соответствию с названием
- rca - поиск по RCA
Строения
Строения - результат строительства, представляющий собой объемное надземное
строительное сооружение, включающую в себя помещения, предназначенные для
проживания и (или) деятельности людей, размещения производства, хранения
продукции или содержания животных, а также сети и системы инженерно-технического
обеспечения.
Запрос: GET /api/v1/buildings
Параметры запроса:
- limit - количество выдаваемых элементов
- offset - выдавать список начиная с определенного номера элемента
- parent_id - фильтр по ID родительского элемента
- locality_id - фильтр по ID населенного пункта
- geonim_id - фильтр по ID геонима
- ground_id - фильтр по ID земельного участка
- name - поиск элемента по соответствию с названием
- rca - поиск по RCA
Response:
{
"actual": true,
"ats_id": 9,
"cato": "",
"children": [],
"full_path_kaz": "Қазақстан Республикасы, Павлодар обл., Ақсу қ., 8 Март көш.",
"full_path_rus": "Республика Казахстан, обл. Павлодарская, г. Аксу, ул. 8 Марта",
"geonims_type": {
"code": "11",
"short_value_kz": "көш.",
"short_value_ru": "ул.",
"value_kz": "көшесі",
"value_ru": "улица"
},
"geonims_type_id": 11,
"id": 29,
"modified": "2023.07.10T04:05:04",
"name_kaz": "8 Март",
"name_rus": "8 Марта",
"parent_id": null,
"rco": "0004000000000004"}
Объекты недвижимости
К Объектам недвижимости относится имуществу относятся в том числе земельные
участки, здания, сооружения, помещения, машино-места, объекты незавершенного
строительства.
Запрос: GET /api/v1/pb
Параметры запроса:
- limit - количество выдаваемых элементов
- offset - выдавать список начиная с определенного номера элемента
- building_id - фильтр по ID строения
- name - поиск элемента по соответствию с названием
- rca - поиск по RCA
Response:
{
"actual": true,
"building_id": 8895831,
"full_path_kaz": "Қазақстан Республикасы, Түркістан обл., Мақтаарал ауд., Мырзакент к., Ізгілік көш., 6 ү., 2 пәт.",
"full_path_rus": "Республика Казахстан, обл. Туркестанская, р-н Мактааральский, п. Мырзакент, ул. Изгилик, д. 6, кв. 2",
"id": 4889349,
"modified": "2023.07.10T05:05:50",
"number": "2",
"rca": "1201300219920828",
"room_type_id": "1"
}