This article in English: Loading the Registry of Regions from a File
Формат файла
Формат содержимого файла — CSV.
Для текста используется кодировка UTF-8.
Разделитель текста (обрамление значений кавычками) не используется.
Поля (столбцы) разделяются точкой с запятой — ;
Разделитель полей в значениях не допускается. Если в значениях необходима точка с запятой, можно использовать другой печатный символ в качестве разделителя полей.Заголовочная строка с названиями полей рекомендуется для упрощения проверки файла внешними средствами, но не обязательна.
Описание полей
Заголовочная строка с названиями полей при загрузке не используется (может быть пропущена) — важен порядок полей.
В общем случае все поля являются необязательными, то есть могут иметь пустые значения. Однако:
- Для загрузки зданий (поле №10) должен быть указан хотя бы один из вышестоящих регионов: населённый пункт, внутренний населённый пункт или улица.
- Включение федерального региона в состав муниципального (поля №13–16) и загрузка параметров объекта недвижимости (поля №17–20) могут быть выполнены только для зданий (поле №10).
В простейшем случае достаточно заполнить: населённый пункт, улицу и здание — эти поля в описании ниже отмечены знаком 
При загрузке регионов в Гидру указывается Вышестоящий регион, внутрь которого выполняется загрузка: это может быть как страна, так и отдельный город. Если ваша фирма ведёт деятельность в нескольких городах и регионах, может оказаться проще создать крупные города вручную и поэтапно для каждого выполнить загрузку из отдельного файла.
| Номер | Наименование | Описание |
|---|---|---|
| 1 | Район федерального уровня | Регион типа Район (код типа —
|
| 2 | Населённый пункт |
В справочнике регионов Гидры — код региона. |
| 3 | Тип населённого пункта | Полное или краткое наименование типа региона. Например: г. или Город, пос. или Посёлок.
|
| 4 | Внутренний населённый пункт | Название внутреннего населённого пункта. Например: Зеленоград. В справочнике регионов Гидры — код региона. |
| 5 | Тип внутреннего населённого пункта | Полное или краткое наименование типа региона. Например: г. или Город, пос. или Посёлок.
|
| 6 | Код населённого пункта из внешнего классификатора | Код или идентификатор из стороннего справочника (ГАР, ФИАС, КЛАДР). В справочнике регионов Гидры — внешний код региона.
|
| 7 | Улица | Название улицы. В справочнике регионов Гидры — код региона. Например: Ленина. |
| 8 | Тип улицы | Полное или краткое наименование типа региона. Например: г. или Город, пос. или Посёлок.
|
| 9 | Код улицы из внешнего классификатора | Код или идентификатор из стороннего справочника (ГАР, ФИАС, КЛАДР). В справочнике регионов Гидры — внешний код региона.
|
| 10 | Здание |
|
| 11 | Код здания из внешнего классификатора | Код или идентификатор из стороннего справочника (ГАР, ФИАС, КЛАДР). В справочнике регионов Гидры — внешний код региона.
|
| 12 | Почтовый индекс | Индекс, будет записан в первый из указанных регионов: здание, улица, внутренний населённый пункт, населённый пункт.
|
| 13 | Связанное муниципальное формирование | Код муниципального региона в Гидре, в состав которого должно быть включено здание: микрорайон, квартал, жилой массив.
|
| 14 | Тип муниципального формирования | Полное или краткое наименование типа муниципального региона. Например: кв-л или Квартал, мкр. или Микрорайон. В Гидре: Справочники → Базовые → Тип региона. |
| 15 | Родительский регион в муниципальной иерархии | Код вышестоящего муниципального региона в Гидре.
|
| 16 | Тип родительского региона в муниципальной иерархии | Полное или краткое наименование типа вышестоящего муниципального региона. Например: г.о. или Городской округ, м.р-н или Муниципальный район. В Гидре: Справочники → Базовые → Тип региона. |
| 17 | Одноимённые параметры объектов недвижимости для зданий. В текущей версии поддерживаются только стандартные системные параметры этих объектов.
| |
| 18 | Количество нежилых помещений | |
| 19 | Количество этажей | |
| 20 | Количество секций (подъездов) |
Рекомендуется указывать, если в справочнике ожидаются одноимённые населённые пункты в разных районах.
Все значения должны быть указаны в Гидре: Справочники → Базовые → Тип региона.
Если не указано, используется тип Город.
Если указан внутренний населённый пункт (поле №4), это считается его внешним кодом.Пример
FederalDistrict;City;CityType;InternalLocality;InternalLocalityType;LocalityExternalCode;Street;StreetType;StreetExternalCode;Building;BuildingExternalCode;PostalCode;MunicipalRegionCode;MunicipalRegionType;ParentMunicipalRegionCode;ParentMunicipalRegionType;NumberOfApartments;NumberOfNon-ResidentialPremises;NumberOfFloors;NumberOfSections Центральный;Москва;Город;Зеленоградский;Административный округ;a38bcacf-7cc6-4c38-943f-67b322230ff6;Яблоневая;Аллея;b0521d2c-86c2-4986-ad40-5f794c77e7ab;д. 11 корп. 7;67fd01ab-f5d3-49a8-836e-89d09efbd259;124365;5;мкр.;Матушкино;Муниципальный район;192;15;9;6 ;Ульяновск;г.;;;;Карла Маркса;ул.;;38;;;;;;;;;;