История страницы

Extract addresses Version 4 (python)

Group "Robin AI", subgroup "NER (ROBIN)"

...

Description

The action extracts the address from the text. Each address is stored as a dictionary, where the key is a separate element of the address

Action icon

Image Added

Parameters and their settings

Property	Description	Type	Filling example	Mandatoryfield
Parameters
Text	The text from which the addresses will be extracted	String	Школа Евгении расположена по адресу: Нижегородская область, г.Нижний Новгород, ул.Ленина, д.100	Yes
Without the address element type	If the value is «true», only the name of the address element will be specified. If «false», the name and type of the address element will be recorded in the dictionary	Boolean	true	No
The original view of the address element	If the value is «true», then the type of the address element will be specified as in the source text. If «false», the dictionary will record the official full view of the address element	Boolean	true	No
Results
Result	A collection of dictionaries with extracted data. If the same address occurs several times in the text, then it will be recorded once in the resulting collection	Collection

Special conditions of use

If the given text does not have any address field in the "Text" field, the value in the dictionary will return empty. If there are no all addressable elements in the text, the action will return an empty result.
A dictionary is always created with a complete set of keys so that no error occurs when accessing any key in the dictionary.
If "Without the address element type" and "The original view of the address element" are checked at the same time, the "The original view of the address element" checkbox will be ignored.
If one sentence contains country, and city, and another sentence lists street, house, and index, that is, parts of the same entity in different sentences, they will be extracted as different addresses into separate dictionaries, not complementing each other.
The "Full address" key contains the entire address string found, and the rest of the fields will be filled in according to the dictionary keys.
The robot will return an empty dictionary collection if:

- No address elements will be found in the source text.
- Source text in an unsupported language. Russian language is supported in the current version.

Address dictionary keys:

Full address
Country
Subject of the Russian Federation
Municipal entity
Administrative-territorial unit
Settlement
Planning structure element
Element of street and road network
Addressing object element
Building type
Room type
Postal code

Reference table

Commonly accepted abbreviations of words that are included in the address and address elements are listed in the table.

Раскрыть

title	Таблица сокращений

Муниципальные образования		Административно-территориальные единицы
Страна		Субъекты Российской Федерации
АССР		Республика	респ., республики
УССР		Край	край
УЗССР		Область	обл.
ССР		Город федерального значения	г.ф.з.
СССР		Автономная область	а.обл., автоном. область
СССР		Автономный округ	а.окр., автоном. округ
Муниципальный район	м.р-н	Поселение	пос.
Городской округ	г.о.	Поселение	пос.
Городское поселение	г.п.	Район	р-н
Сельское поселение	с.п.	Район	р-н
Внутригородской район	вн.р-н	Сельсовет	с/с
Внутригородская территория (внутригородское муниципальное образование) города федерального значения	вн.тер.г.	Сельсовет	с/с
Населенные пункты		Элементы планировочной структуры
Город	г.	Берег	б-г
Поселок городского типа	пгт.	Вал	вал
Рабочий поселок	рп.	Жилой район	ж/р
Курортный поселок	кп.	Зона (массив)	зона
Городской поселок	гп.	Квартал	кв-л
Поселок	п.	Микрорайон	мкр.
Аал	аал	Остров	ост-в
Арбан	арбан	Парк	парк
Аул	аул	Платформа	платф.
Выселки	в-ки	Промышленный район	п/р
Городок	г-к	Район	р-н
Заимка	з-ка	Сад	сад
Починок	п-к	Сквер	сквер
Кишлак	киш.	Территория	тер.
Поселок при станции (поселок станции)	п. ст.	Территория садоводческих некоммерческих объединений граждан	тер. СНО
Поселок при железнодорожной станции	п. ж/д ст.	Территория огороднических некоммерческих объединений граждан	тер. ОНО
Железнодорожный блокпост	ж/д бл-ст	Территория дачных некоммерческих объединений граждан	тер. ДНО
Железнодорожная будка	ж/д б-ка	Территория садоводческих некоммерческих товариществ	тер. СНТ
Железнодорожная ветка	ж/д в-ка	Территория огороднических некоммерческих товариществ	тер. ОНТ
Железнодорожная казарма	ж/д к-ма	Территория дачных некоммерческих товариществ	тер. ДНТ
Железнодорожный комбинат	ж/д к-т	Территория садоводческих потребительских кооперативов	тер. СПК
Железнодорожная платформа	ж/д пл-ма	Территория огороднических потребительских кооперативов	тер. ОПК
Железнодорожная площадка	ж/д пл-ка	Территория дачных потребительских кооперативов	тер. ДПК
Железнодорожный путевой пост	ж/д п.п.	Территория садоводческих некоммерческих партнерств	тер. СНП
Железнодорожный остановочный пункт	ж/д о.п.	Территория огороднических некоммерческих партнерств	тер. ОНП
Железнодорожный разъезд	ж/д рзд.	Территория огороднических некоммерческих партнерств	тер. ОНП
Железнодорожная станция	ж/д ст.	Территория дачных некоммерческих партнерств	тер. ДНП
Местечко	м-ко	Территория дачных некоммерческих партнерств	тер. ДНП
Деревня	д., дер.	Территория товарищества собственников недвижимости	тер. ТСН
Село	с.	Территория товарищества собственников недвижимости	тер. ТСН
Слобода	сл.	Территория гаражно-строительного кооператива	тер. ГСК
Станция	ст.	Территория гаражно-строительного кооператива	тер. ГСК
Станица	ст-ца	Усадьба	ус.
Улус	у.	Территория фермерского хозяйства	тер.ф.х.
Хутор	х.	Территория фермерского хозяйства	тер.ф.х.
Разъезд	рзд.	Юрты	ю.
Зимовье	зим.	Совхоз	свх
Элементы улично-дорожной сети		Элементы объектов адресации
Аллея	ал.	Здание	зд.
Бульвар	б-р	Домовладение	двлд.
Взвоз	взв.	Владение	влд.
Въезд	взд.	Земельный участок	з/у
Дорога	дор.	Сооружение	coop.
Заезд	ззд.	Дом	д.
Километр	км	Объект незавершенного строительства	ОНС
Кольцо	к-цо	Объект незавершенного строительства	ОНС
Коса	коса	Типы зданий
Линия	лн.	Корпус	к.
Магистраль	мгстр.	Строение	стр.
Набережная	наб.	Шахта	шах.
Переезд	пер-д	Гараж	г-ж
Переулок	пер.	Котельная	кот.
Площадка	пл-ка	Типы помещений
Площадь	пл.	Квартира	кв.
Проезд	пр-д	Комната	ком.
Просек	пр-к	Офис	офис
Просека	пр-ка	Павильон	пав.
Проселок	пр-лок	Помещение	пом.
Проспект	пр-кт	Рабочий участок	раб.уч.
Проулок	проул.	Склад	скл.
Разъезд	рзд.	Торговый зал	торг.зал
Ряд(ы)	ряд	Цех	цех
Сквер	с-р	Подвал	подв.
Спуск	с-к
Съезд	сзд.
Тракт	тракт
Тупик	туп.
Улица	ул.
Шоссе	ш.

Example of use

Task

There is a text to recognize:

Информация

icon	false

Обращением к архитектуре итальянского ренессанса в 1930-е годы стал знаменитый дом на Моховой, построенный в 1932–1934 годах И.В. Жолтовским по адресу: Россия, Московская область, г. Москва, ул. Моховая, д. 13. Здание строилось по заказу Моссовета как жилой дом. Шестой и седьмой этажи со стороны главного фасада занимали двухэтажные квартиры, во двор выходили комнаты-мастерские высотой в два этажа, застеклённые большими окнами-витражами.

Addresses need to be extracted from the text and written into an existing tabular document.

Solution

Use the actions: "Extract addresses", "Get keys", "Get values", "Open", "Set column values", loop "For each", "Save".

Implementation

Drag the "Extract addresses" action to the workspace.
Image Added
Set the parameters of the "Extract addresses" action.
Enter the text to be recognized in the "Text" field.
Image Added
Set the "The original view of the address element" parameter to "true".
Image Added
Drag the "Open" action to the workspace and customize the action settings.
Image Added
Image Added
Drag the "For each" loop to the workspace.
Image Added
In the "Collection" parameter of the "For each" loop, add the result of the "Extract Addresses" action.
Image Added
Drag the "Get keys" and "Get values" actions into the "For each" loop on the workspace.
Image Added
Set up the "Get keys" and "Get values" action parameters.
Add the result of the "For each" loop to the "Dictionary" parameter.
Image AddedImage Added
Drag the "Set column values" and "Save" actions to the workspace.
Image Added
Set the "Set column values" action parameters.
1. Set context - result of "Open" action
2. Add columns A and B to the Column name parameter
3. Add the results of the "Get keys" and "Get values" actions to the "Cell value" parameter
4. Set the starting line number of the range
  Image AddedImage Added
Click on the "Start" button in the top panel.

Result

The program robot completed successfully.
Image Added

The extracted addresses are recorded in a tabular document.
Image Added

When "true" is set to "Without the address element type", the "Extract addresses" action is set to "Extract addresses"
Image Added

the resulting dictionary will not include the types of address elements:
Image Added

Извлечь адреса Версия 1 (Python)

Группа действий: Robin AI

Описание

Действие извлекает из указанного текста адреса. Каждый адрес сохраняется в виде словаря, где ключ – отдельный элемент адреса, а значения - извлеченные данные.

Варианты значений для ключей словаря:

...

Страна

...

АССР, УССР, УЗССР, ССР, СССР, Франция, ФРГ

...

Субъект Российской Федерации

...

федеральный округ, республика, край, область, автономный округ, автономная область

...

Муниципальное образование

...

Административно-территориальная единица

...

Населенный пункт

...

Элемент планировочной структуры

...

Элемент улично-дорожной сети

...

Элемент объекта адресации

...

Тип здания

...

Тип помещения

...

Если в одном предложении указаны страна, и город, а в другом предложении списком улица, дом, индекс, то есть в разных предложениях части одной сущности, то они извлекутся как разные адреса в отдельные словари.

Image Removed

Параметры

Входные параметры:

Текст - текст, из которого будут извлекаться адреса.
Без вида элемента адреса - параметр, с помощью которого в результирующем словаре будут указаны\не указаны вид элемента адреса. Пример с выключенным и включенным параметром:

Image RemovedImage Removed

Исходный вид элемента адреса - параметр, с помощью которого адрес будет представлен как в исходном тексте или записан как официальный полный вид элемента адреса. Например, с включенный параметром адрес "г. Нижний Новгород" так и будет записан, а если параметр отключен, то адрес в результате будет "Нижний Новгород".

Выходные параметры:

Результат - коллекция словарей с извлеченными адресами. Повторяющиеся в тексте адреса записываются в коллекции один раз.

Настройки

...

Свойство

...

Описание

...

Тип

...

Пример заполнения

...

Обязательность заполнения поля

...

Параметры

...

Текст

...

Текст, из которого будут извлечены адреса.

...

Robin.String

...

Да

...

Результат

...

Коллекция словарей с извлеченными данными. Если один и тот же адрес встречается в тексте несколько раз, то в результирующей коллекции он будет записан один раз.

...

Robin.Collection

Особые условия использования

Если в поданном тексте нет искомого поля, то оно вернется пустым. Словарь всегда создается с полным набором ключей, чтобы не возникало ошибки при обращении к любому ключу словаря.

Если одновременно отмечены параметры "Без вида элемента адреса" и "Исходный вид элемента адреса", то галочка у "Исходный вид элемента адреса" будет проигнорирована.

Если в одном предложении указаны страна, и город, а в другом предложении списком улица, дом, индекс, то есть в разных предложениях части одной сущности, то они извлекутся как разные адреса в отдельные словари, не дополняя друг друга.

Ключи словаря адресов:

Полный адрес
Страна
Субъект Российской Федерации
Муниципальное образование
Административно-территориальная единица
Населенный пункт
Элемент планировочной структуры
Элемент улично-дорожной сети
Элемент объекта адресации
Тип здания
Тип помещения
Почтовый индекс

В первый ключ "Полный адрес" попадает вся найденная строка с адресом, а остальные поля будут заполнены согласно ключам словаря.

Робот вернет пустую коллекцию словарей, если:

в исходном тексте не будет найдено ни одного элемента адреса,
исходный текст на неподдерживаемом языке. На данный момент поддерживается только русский язык.

Пример использования

Задача: записать в текстовый файл извлеченные адреса из текста.

Текст: Школа Евгении расположена по адресу: Нижегородская область, г.Нижний Новгород ,ул.Ленина, д.100

Решение: воспользоваться действиями "Извлечь адреса", "Получить длину", "Вычитание", "Получить значение по индексу", "Получить значение", "Получить коллекцию ключей", "Записать в текстовый файл", циклом "Для".

Реализация:

Собрать схему робота: Схема робота.
Настроить параметры действия "Извлечь адреса". В поле "Текст" ввести нужный текст.
Image Removed
Настроить параметры действия "Получить длину 1". В поле "Коллекция или массив" указать результат действия "Извлечь адреса".
Image Removed
Настроить параметры действия "Вычитание 1". В поле "Первый операнд" указать результат действия "Получить длину 1". В поле "Второй операнд" указать "1".
Image Removed
Настроить параметры действия "Для 1". В поле "Начальное значение" указать "0". В поле "Конечное значение" указать результат действия "Вычитание 2". В поле "Инкремент" указать "1".
Image Removed
Настроить параметры действия "Получить значение по индексу 2". В поле "Коллекция" указать результат действия "Получить коллекцию ключей 1". В поле "Индекс" указать результат цикла "Для 1".
Image Removed
Настроить параметры действия "Получить значение по индексу 3". В поле "Коллекция" указать результат действия "Получить значения 1". В поле "Индекс" указать результат цикла "Для 1".
Image Removed
Настроить параметры действия "Записать текстовый файл 1". В поле "Файл" указать путь к текстовому файлу, куда будет записан результат. В поле "Данные" указать результат действия "Получить значение по индексу 2". В поле "Добавить" указать чекбокс = true. В поле "С новой строки" указать чекбокс = true.
Image Removed
Настроить параметры действия "Записать текстовый файл 2". В поле "Файл" указать путь к текстовому файлу, куда будет записан результат. В поле "Данные" указать ":". В поле "Добавить" указать чекбокс = true.
Image Removed
Настроить параметры действия "Записать текстовый файл 3". В поле "Файл" указать путь к текстовому файлу, куда будет записан результат. В поле "Данные" указать результат действия "Получить значение по индексу 3". В поле "Добавить" указать чекбокс = true.
Image Removed
Заполнить параметры цикла "Для 2". В поле "Начальное значение" указать "0". В поле "Конечное значение" указать результат действия "Вычитание 1". В поле "Инкремент" указать "1".
Image Removed
Заполнить параметры действия "Получить значение по индексу 1". В поле "Коллекция" указать результат действия "Извлечь адреса 1". В поле "Индекс" указать результат цикла "Для 2".
Image Removed
Заполнить параметры действия "Получить значения 1". В поле "Словарь" указать результат действия "Получить значение по индексу 1".
Image Removed
Заполнить параметры действия "Получить коллекцию ключей". В поле "Словарь" указать результат действия "Получить значение по индексу 1".
Image Removed
Заполнить параметры действия "Получить длину 2". В поле "Коллекция или массив" указать результат действия "Получить значения 1".
Image Removed
Заполнить параметры действия "Вычитание 2". В поле "Первый операнд" указать результат действия "Получить длину 2". В поле "Второй операнд" указать "1".
Image Removed
Нажать на кнопку "Старт" в верхней панели.