API address UK: различия между версиями
IronBot (обсуждение | вклад) (Add Ukrainian API docs and trilingual API links) |
IronBot (обсуждение | вклад) (Fix Ukrainian API localization) |
||
| (не показаны 3 промежуточные версии этого же участника) | |||
| Строка 1: | Строка 1: | ||
[[API_address_EN|en]] | '''uk''' | [[API address|ru]] | [[API_address_EN|en]] | '''uk''' | [[API address|ru]] | ||
Розділ '''[[API]]''' ERP "UserSide" | Розділ '''[[API_UK|API]]''' ERP "UserSide" | ||
Призначення: | Призначення: Робота з адресами | ||
Додаткові параметри: | Додаткові параметри: | ||
action - підкатегорія запиту ''(можливе значення: див. нижче)'' | action - підкатегорія запиту ''(можливе значення: див. нижче)'' | ||
Також див.: [[Адресная система_UK|Адресна система]] | |||
=== | === Типи адресних одиниць === | ||
==== add_locality_type ==== | ==== add_locality_type ==== | ||
''Додано у 3.13.64'' | ''Додано у 3.13.64'' | ||
Опис: Додавання | Опис: Додавання типу адресної одиниці | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
name - найменування | name - найменування | ||
| Строка 21: | Строка 21: | ||
==== edit_locality_type ==== | ==== edit_locality_type ==== | ||
''Додано у 3.13.64'' | ''Додано у 3.13.64'' | ||
Опис: Редагування | Опис: Редагування типу адресної одиниці | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id | id - id | ||
| Строка 30: | Строка 30: | ||
==== get_locality_type ==== | ==== get_locality_type ==== | ||
''Додано у 3.13.9'' | ''Додано у 3.13.9'' | ||
Опис: | Опис: Інформація про типи адресних одиниць | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
token - токен | token - токен | ||
| Строка 36: | Строка 36: | ||
==== get_alias ==== | ==== get_alias ==== | ||
''Додано у 3.15.7'' | ''Додано у 3.15.7'' | ||
Опис: | Опис: Інформація про аліаси | ||
=== | === Адресні одиниці === | ||
==== add_address ==== | ==== add_address ==== | ||
''Додано у 3.13.64'' | ''Додано у 3.13.64'' | ||
Опис: Додавання | Опис: Додавання адресної одиниці | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
locality_type_id - id | locality_type_id - id типу адресної одиниці | ||
name - назва | name - назва | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
parent_id - id | parent_id - id батьківської адресної одиниці | ||
==== get ==== | ==== get ==== | ||
''Змінено у 3.14.69 ( | ''Змінено у 3.14.69 (додано вхідний параметр is_disable_hidden)'' | ||
''Додано у 3.13.9'' | ''Додано у 3.13.9'' | ||
Опис: | Опис: Інформація про адресні одиниці | ||
Обов'язкові параметри ''( | Обов'язкові параметри ''(має бути хоча б одне)'': | ||
id - id об'єктів ''(можна через кому)'' | id - id об'єктів ''(можна через кому)'' | ||
locality_type_id - тип об'єктів ''(можна через кому)'' | locality_type_id - тип об'єктів ''(можна через кому)'' | ||
parent_id - id батьківського об'єкта ''(можна через кому)'' | parent_id - id батьківського об'єкта ''(можна через кому)'' | ||
is_disable_hidden - прапорець - не | is_disable_hidden - прапорець - не відображати приховані адресні одиниці | ||
==== edit_address ==== | ==== edit_address ==== | ||
| Строка 66: | Строка 66: | ||
''Додано у 3.13.60'' | ''Додано у 3.13.60'' | ||
Опис: Редагування | Опис: Редагування адресної одиниці | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id об'єкта | id - id об'єкта | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
map_color - HTML-колір | map_color - HTML-колір полігона на карті | ||
parent_id - id | parent_id - id батьківської адресної одиниці | ||
=== Область === | === Область === | ||
==== add_province ==== | ==== add_province ==== | ||
Опис: Додавання | Опис: Додавання області | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
name - Найменування | name - Найменування | ||
Додатково повертаються дані: | |||
array( | array( | ||
[Id] => ID | [Id] => ID доданої області в разі успіху | ||
) | ) | ||
==== edit_province ==== | ==== edit_province ==== | ||
Опис: Редагування | Опис: Редагування області | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - ID | id - ID області | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
Перелік параметрів використовується аналогічно до методу add_province | |||
==== del_province ==== | ==== del_province ==== | ||
Опис: Видалення | Опис: Видалення області | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - ID | id - ID області | ||
==== get_province ==== | ==== get_province ==== | ||
''Змінено у 3.12.17 ( | ''Змінено у 3.12.17 (додано вхідний параметр id)'' | ||
Опис: Список областей | Опис: Список областей | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
id - ID областей (можна через кому) | id - ID областей (можна через кому) | ||
Додатково повертаються дані: | |||
array( | array( | ||
[data] => | [data] => Дані про об'єкти | ||
) | ) | ||
| Строка 110: | Строка 110: | ||
==== add_district ==== | ==== add_district ==== | ||
''Додано у 3.13.46'' | ''Додано у 3.13.46'' | ||
Опис: Додавання | Опис: Додавання району | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
name - найменування | name - найменування | ||
| Строка 116: | Строка 116: | ||
==== edit_district ==== | ==== edit_district ==== | ||
''Додано у 3.13.46'' | ''Додано у 3.13.46'' | ||
Опис: Редагування | Опис: Редагування району | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id | id - id району | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
Перелік параметрів використовується аналогічно до методу add_province | |||
==== del_district ==== | ==== del_district ==== | ||
''Додано у 3.13.46'' | ''Додано у 3.13.46'' | ||
Опис: Видалення | Опис: Видалення району | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id | id - id району | ||
==== get_district ==== | ==== get_district ==== | ||
''Додано у 3.13.46'' | ''Додано у 3.13.46'' | ||
Опис: Список | Опис: Список районів | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
id - id | id - id районів ''(можна через кому)'' | ||
=== | === Населений пункт === | ||
==== add_city ==== | ==== add_city ==== | ||
Опис: Додавання | Опис: Додавання населеного пункту | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
name - Найменування | name - Найменування населеного пункту | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
province_id - ID | province_id - ID області | ||
district_id - ID | district_id - ID району в області | ||
Додатково повертаються дані: | |||
array( | array( | ||
[Id] => ID | [Id] => ID доданого населеного пункту в разі успіху | ||
) | ) | ||
==== get_city ==== | ==== get_city ==== | ||
''Змінено у 3.14.69 ( | ''Змінено у 3.14.69 (додано вхідний параметр is_disable_hidden)'' | ||
''Змінено у 3.13.46 ( | ''Змінено у 3.13.46 (додано вхідний параметр district_id)'' | ||
''Змінено у 3.12.17 ( | ''Змінено у 3.12.17 (додано вхідний параметр id)'' | ||
Опис: Список | Опис: Список населених пунктів | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
id - id | id - id населеного пункту ''(можна через кому)'' | ||
district_id - id | district_id - id району ''(можна через кому)'' | ||
province_id - id | province_id - id області ''(можна через кому)'' | ||
is_disable_hidden - прапорець - не | is_disable_hidden - прапорець - не відображати приховані населені пункти | ||
==== edit_city ==== | ==== edit_city ==== | ||
Опис: Редагування | Опис: Редагування населеного пункту | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - ID | id - ID населеного пункту | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
Перелік параметрів використовується аналогічно до методу add_city | |||
==== del_city ==== | ==== del_city ==== | ||
Опис: Видалення | Опис: Видалення населеного пункту | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - ID | id - ID населеного пункту | ||
=== Район | === Район у населеному пункті === | ||
==== add_area ==== | ==== add_area ==== | ||
Опис: Додавання | Опис: Додавання району в населеному пункті | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
city_id - ID | city_id - ID населеного пункту | ||
name - Найменування | name - Найменування | ||
Додатково повертаються дані: | |||
array( | array( | ||
[Id] => ID | [Id] => ID доданого району в разі успіху | ||
) | ) | ||
==== get_area ==== | ==== get_area ==== | ||
''Змінено у 3.14.69 ( | ''Змінено у 3.14.69 (додано вхідний параметр is_disable_hidden)'' | ||
''Змінено у 3.12.17 ( | ''Змінено у 3.12.17 (додано вхідний параметр id)'' | ||
Опис: Список | Опис: Список районів населених пунктів | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
id - ID | id - ID районів (можна через кому) | ||
city_id - ID | city_id - ID міст (можна через кому) | ||
is_disable_hidden - прапорець - не | is_disable_hidden - прапорець - не відображати приховані райони | ||
==== edit_area ==== | ==== edit_area ==== | ||
Опис: Редагування | Опис: Редагування району населеного пункту | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - ID | id - ID району населеного пункту | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
Перелік параметрів використовується аналогічно до методу add_area | |||
==== del_area ==== | ==== del_area ==== | ||
Опис: Видалення | Опис: Видалення району населеного пункту | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - ID | id - ID району населеного пункту | ||
=== Вулиця === | === Вулиця === | ||
==== add_street ==== | ==== add_street ==== | ||
Опис: Додавання | Опис: Додавання вулиці | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
city_id - ID | city_id - ID населеного пункту | ||
name - Найменування | name - Найменування | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
area_id - ID | area_id - ID району населеного пункту | ||
Додатково повертаються дані: | |||
array( | array( | ||
[Id] => ID | [Id] => ID доданої вулиці в разі успіху | ||
) | ) | ||
==== get_street ==== | ==== get_street ==== | ||
''Змінено у 3.14.69 ( | ''Змінено у 3.14.69 (додано вхідний параметр is_disable_hidden)'' | ||
''Змінено у 3.12.17 ( | ''Змінено у 3.12.17 (додано вхідний параметр id)'' | ||
Опис: Список | Опис: Список вулиць | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
id - ID | id - ID вулиць ''(можна через кому)'' | ||
city_id - ID | city_id - ID населених пунктів ''(можна через кому)'' | ||
area_id - ID | area_id - ID районів населених пунктів ''(можна через кому)'' | ||
is_disable_hidden - прапорець - не | is_disable_hidden - прапорець - не відображати приховані вулиці | ||
==== edit_street ==== | ==== edit_street ==== | ||
Опис: Редагування | Опис: Редагування вулиці | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - ID | id - ID вулиці | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
Перелік параметрів використовується аналогічно до методу add_street | |||
==== del_street ==== | ==== del_street ==== | ||
Опис: Видалення | Опис: Видалення вулиці | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - ID | id - ID вулиці | ||
=== Будівля === | === Будівля === | ||
| Строка 255: | Строка 255: | ||
''Змінено у 3.13.15 (додано параметр apart_count, level_count, entrance_count)'' | ''Змінено у 3.13.15 (додано параметр apart_count, level_count, entrance_count)'' | ||
Опис: Додавання | Опис: Додавання будівлі | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
city_id - id населеного пункту | city_id - id населеного пункту | ||
street_id - id | street_id - id вулиці | ||
number - номер | number - номер будівлі | ||
block - блок/корпус | block - блок/корпус будівлі ''(для версії 3.12 і нижче)'' | ||
custom_name - | custom_name - Довільне ''(повне)'' найменування будівлі ''(для версії 3.12 і нижче)'' | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
area_id - id | area_id - id району в населеному пункті | ||
apart_count - | apart_count - кількість квартир/приміщень у будівлі | ||
comment - нотатки | comment - нотатки | ||
entrance_count - | entrance_count - кількість входів/під'їздів у будівлі | ||
level_count - | level_count - кількість поверхів у будівлі | ||
task_comment - | task_comment - робоча нотатка за будівлею | ||
type_id - id | type_id - id типу будівлі | ||
==== add_house_mark ==== | ==== add_house_mark ==== | ||
Опис: Додавання | Опис: Додавання мітки на будинку | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
house_id - ID | house_id - ID будинку | ||
mark_id - ID | mark_id - ID мітки | ||
==== del_house ==== | ==== del_house ==== | ||
Опис: Видалення | Опис: Видалення будинку | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - ID | id - ID будинку | ||
==== delete_house_mark ==== | ==== delete_house_mark ==== | ||
Опис: | Опис: Зняття мітки з будинку | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
house_id - ID | house_id - ID будинку | ||
mark_id - ID | mark_id - ID мітки | ||
==== edit_building_coord ==== | ==== edit_building_coord ==== | ||
''Додано у 3.13.14'' | ''Додано у 3.13.14'' | ||
Опис: Зміна | Опис: Зміна географічних координат у будівлі/об'єкта інфраструктури | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id будівлі | id - id будівлі | ||
coord - координати вершин | coord - координати вершин полігона будівлі | ||
==== get_building_structure ==== | ==== get_building_structure ==== | ||
''Додано у 3.16dev3'' | ''Додано у 3.16dev3'' | ||
Опис: | Опис: Перегляд структури будівлі | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id будівлі | id - id будівлі | ||
| Строка 305: | Строка 305: | ||
''Додано у 3.15.20'' | ''Додано у 3.15.20'' | ||
Опис: Редагування | Опис: Редагування структури будівлі | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id будівлі | id - id будівлі | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
level_list - список | level_list - список типів рівнів ''(поверхів)'' через кому | ||
==== edit_house ==== | ==== edit_house ==== | ||
| Строка 321: | Строка 321: | ||
''Змінено у 3.13.15 (додано параметр apart_count, level_count, entrance_count)'' | ''Змінено у 3.13.15 (додано параметр apart_count, level_count, entrance_count)'' | ||
Опис: Редагування | Опис: Редагування будівлі | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id будівлі ''(для версії 3.12 і | id - id будівлі ''(для версії 3.12 і нижче)''/id адресної одиниці ''(для версії 3.13 і вище)'' | ||
або | |||
building_id - id будівлі ''(для версії 3.13 і | building_id - id будівлі ''(для версії 3.13 і вище)'' | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
area_id - id | area_id - id району в населеному пункті | ||
apart_count - | apart_count - кількість квартир/приміщень у будівлі | ||
block - блок/корпус | block - блок/корпус будівлі ''(для версії 3.12 і нижче)'' | ||
city_id - id населеного пункту | city_id - id населеного пункту | ||
comment - нотатки | comment - нотатки | ||
custom_name - | custom_name - Довільне ''(повне)'' найменування будівлі ''(для версії 3.12 і нижче)'' | ||
entrance_count - | entrance_count - кількість входів/під'їздів у будівлі | ||
is_not_connected - прапорець - будівля не | is_not_connected - прапорець - будівля не підключена | ||
level_count - | level_count - кількість поверхів у будівлі | ||
number - номер | number - номер будівлі | ||
street_id - id | street_id - id вулиці | ||
task_comment - | task_comment - робоча нотатка за будівлею | ||
task_interval - | task_interval - можливі інтервали часу для виконання робіт ''(наприклад: {"day":[[0,23],[0,23],[0,23],[0,23],[0,23],[0,23],[0,23]]})'' | ||
type_id - id | type_id - id типу будівлі | ||
==== get_house ==== | ==== get_house ==== | ||
''Доопрацьовано у: 3.16dev3 (додано параметри name, limit, is_like)'' | ''Доопрацьовано у: 3.16dev3 (додано параметри name, limit, is_like)'' | ||
''Доопрацьовано у: 3.13.35 (додано | ''Доопрацьовано у: 3.13.35 (додано параметри mark_id)'' | ||
''Доопрацьовано у 3.13.19 (додано параметр building_id)'' | ''Доопрацьовано у 3.13.19 (додано параметр building_id)'' | ||
Опис: Список | Опис: Список будинків | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
немає | |||
Необов'язкові параметри: | Необов'язкові параметри: | ||
id - id будівлі ''(для версії 3.12. | id - id будівлі ''(для версії 3.12. Можна через кому)'', id адресної одиниці ''(для версії 3.13+. Можна через кому)'' | ||
building_id - id будівлі ''(для версії 3.13+. | building_id - id будівлі ''(для версії 3.13+. Можна через кому)'' | ||
city_id - ID | city_id - ID населених пунктів ''(можна через кому)'' | ||
area_id - ID | area_id - ID районів населених пунктів ''(можна через кому)'' | ||
street_id - ID | street_id - ID вулиць ''(можна через кому)'' | ||
is_disable_hidden - прапорець - не | is_disable_hidden - прапорець - не відображати приховані будинки | ||
mark_id - id | mark_id - id мітки | ||
name - | name - повна адреса будівлі ''(відповідно до шаблону)'' | ||
limit - | limit - максимальна кількість записів, які потрібно повернути у відповіді | ||
is_like - прапорець - | is_like - прапорець - використовувати порівняння підрядка там, де це можливо ''(а не повний збіг)'' | ||
==== get_building_type ==== | ==== get_building_type ==== | ||
''Додано у 3.20.5'' | ''Додано у 3.20.5'' | ||
Опис: Довідник | Опис: Довідник типів будівель | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
немає | |||
==== get_level ==== | ==== get_level ==== | ||
''Додано у 3.15.20'' | ''Додано у 3.15.20'' | ||
Опис: Довідник | Опис: Довідник типів рівнів (поверхів) | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
немає | |||
==== move_child_object ==== | ==== move_child_object ==== | ||
''Додано у 3.16dev8'' | ''Додано у 3.16dev8'' | ||
Опис: | Опис: Перенесення дочірніх об'єктів з будівлі на іншу будівлю | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
src_building_id - id | src_building_id - id вихідної будівлі | ||
dst_building_id - id будівлі- | dst_building_id - id будівлі-отримувача | ||
==== owner_remove ==== | ==== owner_remove ==== | ||
Опис: | Опис: Вилучення власника з будівлі | ||
Див. API->owner->[[API_owner_UK#unbind_building|unbind_building]] | |||
==== (*) add_house_to_map ==== | ==== (*) add_house_to_map ==== | ||
| Строка 395: | Строка 395: | ||
''Виключено у 3.13'' | ''Виключено у 3.13'' | ||
Опис: Додавання | Опис: Додавання будинку на карту | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
house_id - ID | house_id - ID будинку | ||
map_id - ID | map_id - ID карти | ||
coord - координати вершин | coord - координати вершин полігона будинку | ||
==== (*) remove_house_from_map ==== | ==== (*) remove_house_from_map ==== | ||
| Строка 406: | Строка 406: | ||
''Виключено у 3.13'' | ''Виключено у 3.13'' | ||
Опис: Видалення | Опис: Видалення будинку з карти | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
house_id - ID | house_id - ID будинку | ||
map_id - ID | map_id - ID карти | ||
Текущая версия от 11:18, 10 мая 2026
Розділ API ERP "UserSide"
Призначення: Робота з адресами
Додаткові параметри: action - підкатегорія запиту (можливе значення: див. нижче)
Також див.: Адресна система
Типи адресних одиниць
add_locality_type
Додано у 3.13.64
Опис: Додавання типу адресної одиниці Обов'язкові параметри: name - найменування token - токен
edit_locality_type
Додано у 3.13.64
Опис: Редагування типу адресної одиниці Обов'язкові параметри: id - id Необов'язкові параметри: name - найменування token - токен
get_locality_type
Додано у 3.13.9
Опис: Інформація про типи адресних одиниць Необов'язкові параметри: token - токен
get_alias
Додано у 3.15.7
Опис: Інформація про аліаси
Адресні одиниці
add_address
Додано у 3.13.64
Опис: Додавання адресної одиниці Обов'язкові параметри: locality_type_id - id типу адресної одиниці name - назва Необов'язкові параметри: parent_id - id батьківської адресної одиниці
get
Змінено у 3.14.69 (додано вхідний параметр is_disable_hidden)
Додано у 3.13.9
Опис: Інформація про адресні одиниці Обов'язкові параметри (має бути хоча б одне): id - id об'єктів (можна через кому) locality_type_id - тип об'єктів (можна через кому) parent_id - id батьківського об'єкта (можна через кому) is_disable_hidden - прапорець - не відображати приховані адресні одиниці
edit_address
Змінено у 3.20.4 (додано параметр parent_id)
Додано у 3.13.60
Опис: Редагування адресної одиниці Обов'язкові параметри: id - id об'єкта Необов'язкові параметри: map_color - HTML-колір полігона на карті parent_id - id батьківської адресної одиниці
Область
add_province
Опис: Додавання області Обов'язкові параметри: name - Найменування Додатково повертаються дані: array( [Id] => ID доданої області в разі успіху )
edit_province
Опис: Редагування області Обов'язкові параметри: id - ID області Необов'язкові параметри: Перелік параметрів використовується аналогічно до методу add_province
del_province
Опис: Видалення області Обов'язкові параметри: id - ID області
get_province
Змінено у 3.12.17 (додано вхідний параметр id)
Опис: Список областей Необов'язкові параметри: id - ID областей (можна через кому) Додатково повертаються дані: array( [data] => Дані про об'єкти )
Район
add_district
Додано у 3.13.46
Опис: Додавання району Обов'язкові параметри: name - найменування
edit_district
Додано у 3.13.46
Опис: Редагування району Обов'язкові параметри: id - id району Необов'язкові параметри: Перелік параметрів використовується аналогічно до методу add_province
del_district
Додано у 3.13.46
Опис: Видалення району Обов'язкові параметри: id - id району
get_district
Додано у 3.13.46
Опис: Список районів Необов'язкові параметри: id - id районів (можна через кому)
Населений пункт
add_city
Опис: Додавання населеного пункту Обов'язкові параметри: name - Найменування населеного пункту Необов'язкові параметри: province_id - ID області district_id - ID району в області Додатково повертаються дані: array( [Id] => ID доданого населеного пункту в разі успіху )
get_city
Змінено у 3.14.69 (додано вхідний параметр is_disable_hidden)
Змінено у 3.13.46 (додано вхідний параметр district_id)
Змінено у 3.12.17 (додано вхідний параметр id)
Опис: Список населених пунктів Необов'язкові параметри: id - id населеного пункту (можна через кому) district_id - id району (можна через кому) province_id - id області (можна через кому) is_disable_hidden - прапорець - не відображати приховані населені пункти
edit_city
Опис: Редагування населеного пункту Обов'язкові параметри: id - ID населеного пункту Необов'язкові параметри: Перелік параметрів використовується аналогічно до методу add_city
del_city
Опис: Видалення населеного пункту Обов'язкові параметри: id - ID населеного пункту
Район у населеному пункті
add_area
Опис: Додавання району в населеному пункті Обов'язкові параметри: city_id - ID населеного пункту name - Найменування Додатково повертаються дані: array( [Id] => ID доданого району в разі успіху )
get_area
Змінено у 3.14.69 (додано вхідний параметр is_disable_hidden)
Змінено у 3.12.17 (додано вхідний параметр id)
Опис: Список районів населених пунктів Необов'язкові параметри: id - ID районів (можна через кому) city_id - ID міст (можна через кому) is_disable_hidden - прапорець - не відображати приховані райони
edit_area
Опис: Редагування району населеного пункту Обов'язкові параметри: id - ID району населеного пункту Необов'язкові параметри: Перелік параметрів використовується аналогічно до методу add_area
del_area
Опис: Видалення району населеного пункту Обов'язкові параметри: id - ID району населеного пункту
Вулиця
add_street
Опис: Додавання вулиці Обов'язкові параметри: city_id - ID населеного пункту name - Найменування Необов'язкові параметри: area_id - ID району населеного пункту Додатково повертаються дані: array( [Id] => ID доданої вулиці в разі успіху )
get_street
Змінено у 3.14.69 (додано вхідний параметр is_disable_hidden)
Змінено у 3.12.17 (додано вхідний параметр id)
Опис: Список вулиць Необов'язкові параметри: id - ID вулиць (можна через кому) city_id - ID населених пунктів (можна через кому) area_id - ID районів населених пунктів (можна через кому) is_disable_hidden - прапорець - не відображати приховані вулиці
edit_street
Опис: Редагування вулиці Обов'язкові параметри: id - ID вулиці Необов'язкові параметри: Перелік параметрів використовується аналогічно до методу add_street
del_street
Опис: Видалення вулиці Обов'язкові параметри: id - ID вулиці
Будівля
add_house
Змінено у 3.16.19 (додано параметр type_id)
Змінено у 3.13.57 (додано параметр comment, task_comment)
Змінено у 3.13.15 (додано параметр apart_count, level_count, entrance_count)
Опис: Додавання будівлі Обов'язкові параметри: city_id - id населеного пункту street_id - id вулиці number - номер будівлі block - блок/корпус будівлі (для версії 3.12 і нижче) custom_name - Довільне (повне) найменування будівлі (для версії 3.12 і нижче) Необов'язкові параметри: area_id - id району в населеному пункті apart_count - кількість квартир/приміщень у будівлі comment - нотатки entrance_count - кількість входів/під'їздів у будівлі level_count - кількість поверхів у будівлі task_comment - робоча нотатка за будівлею type_id - id типу будівлі
add_house_mark
Опис: Додавання мітки на будинку Обов'язкові параметри: house_id - ID будинку mark_id - ID мітки
del_house
Опис: Видалення будинку Обов'язкові параметри: id - ID будинку
delete_house_mark
Опис: Зняття мітки з будинку Обов'язкові параметри: house_id - ID будинку mark_id - ID мітки
edit_building_coord
Додано у 3.13.14
Опис: Зміна географічних координат у будівлі/об'єкта інфраструктури Обов'язкові параметри: id - id будівлі coord - координати вершин полігона будівлі
get_building_structure
Додано у 3.16dev3
Опис: Перегляд структури будівлі Обов'язкові параметри: id - id будівлі
edit_building_structure
Додано у 3.15.20
Опис: Редагування структури будівлі Обов'язкові параметри: id - id будівлі Необов'язкові параметри: level_list - список типів рівнів (поверхів) через кому
edit_house
Змінено у 3.18beta1 (додано параметр task_interval)
Змінено у 3.16.20 (додано параметр type_id, is_not_connected)
Змінено у 3.13.57 (додано параметр comment, task_comment)
Змінено у 3.13.15 (додано параметр apart_count, level_count, entrance_count)
Опис: Редагування будівлі
Обов'язкові параметри:
id - id будівлі (для версії 3.12 і нижче)/id адресної одиниці (для версії 3.13 і вище)
або
building_id - id будівлі (для версії 3.13 і вище)
Необов'язкові параметри:
area_id - id району в населеному пункті
apart_count - кількість квартир/приміщень у будівлі
block - блок/корпус будівлі (для версії 3.12 і нижче)
city_id - id населеного пункту
comment - нотатки
custom_name - Довільне (повне) найменування будівлі (для версії 3.12 і нижче)
entrance_count - кількість входів/під'їздів у будівлі
is_not_connected - прапорець - будівля не підключена
level_count - кількість поверхів у будівлі
number - номер будівлі
street_id - id вулиці
task_comment - робоча нотатка за будівлею
task_interval - можливі інтервали часу для виконання робіт (наприклад: {"day":[[0,23],[0,23],[0,23],[0,23],[0,23],[0,23],[0,23]]})
type_id - id типу будівлі
get_house
Доопрацьовано у: 3.16dev3 (додано параметри name, limit, is_like)
Доопрацьовано у: 3.13.35 (додано параметри mark_id)
Доопрацьовано у 3.13.19 (додано параметр building_id)
Опис: Список будинків Обов'язкові параметри: немає Необов'язкові параметри: id - id будівлі (для версії 3.12. Можна через кому), id адресної одиниці (для версії 3.13+. Можна через кому) building_id - id будівлі (для версії 3.13+. Можна через кому) city_id - ID населених пунктів (можна через кому) area_id - ID районів населених пунктів (можна через кому) street_id - ID вулиць (можна через кому) is_disable_hidden - прапорець - не відображати приховані будинки mark_id - id мітки name - повна адреса будівлі (відповідно до шаблону) limit - максимальна кількість записів, які потрібно повернути у відповіді is_like - прапорець - використовувати порівняння підрядка там, де це можливо (а не повний збіг)
get_building_type
Додано у 3.20.5
Опис: Довідник типів будівель Обов'язкові параметри: немає
get_level
Додано у 3.15.20
Опис: Довідник типів рівнів (поверхів) Обов'язкові параметри: немає
move_child_object
Додано у 3.16dev8
Опис: Перенесення дочірніх об'єктів з будівлі на іншу будівлю Обов'язкові параметри: src_building_id - id вихідної будівлі dst_building_id - id будівлі-отримувача
owner_remove
Опис: Вилучення власника з будівлі Див. API->owner->unbind_building
(*) add_house_to_map
Додано у 3.12.40
Виключено у 3.13
Опис: Додавання будинку на карту Обов'язкові параметри: house_id - ID будинку map_id - ID карти coord - координати вершин полігона будинку
(*) remove_house_from_map
Додано у 3.12.40
Виключено у 3.13
Опис: Видалення будинку з карти Обов'язкові параметри: house_id - ID будинку map_id - ID карти