Просмотреть исходный

Извлечь адреса / Extract addresses

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

Описание

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

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

Страна
АССР, УССР, УЗССР, ССР, СССР
Субъект Российской Федерации
федеральный округ, республика, край, область, автономный округ, автономная область
Муниципальное образование
Административно-территориальная единица
район
Населенный пункт
город, село, деревня, посёлок
Элемент планировочной структуры
совхоз
Элемент улично-дорожной сети
улица, проспект, проезд, переулок, площадь, шоссе, набережная, бульвар
Элемент объекта адресации
дом
Тип здания
корпус, строение
Тип помещения
офис, квартира

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

Параметры

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

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

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

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

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

Настройки

Свойство	Описание	Тип	Пример заполнения	Обязательность заполнения поля
Параметры
Текст	Текст, из которого будут извлечены адреса.	Robin.String	Школа Евгении расположена по адресу: Нижегородская область, г.Нижний Новгород ,ул.Ленина, д.100	Да
Без вида элемента адреса	Если значение "true", то будет указано только значение элемента адреса. Если "false", в словаре будут записаны значение и вид элемента адреса.	Robin.Boolean	True	Нет
Исходный вид элемента адреса	Если значение "true", то вид элемента адреса будет указан как в исходном тексте. Если "false", в словаре будет записан официальный полный вид элемента адреса.	Robin.Boolean	True	Нет
Результаты
Результат	Коллекция словарей с извлеченными данными. Если один и тот же адрес встречается в тексте несколько раз, то в результирующей коллекции он будет записан один раз.	Robin.Collection

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

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

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

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

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

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

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

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

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

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

Задача: извлечь из текста адрес и получить коллекцию всех значений словаря.

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

Решение: воспользоваться действиями "Извлечь адреса", "Для каждого", "Получить значения".

Реализация:

Собрать схему робота, состоящего из действий:
Настроить параметр действия "Извлечь адреса". Создать переменную ,которая будет включать в себя целевой текст.
Настроить параметр действия "Для каждого".
Настроить параметр действия "Получить значения".
Нажать на кнопку "Старт" в верхней панели.

Результат:

Программный робот отработал успешно.

Документация ROBIN > Извлечь адреса NR > image2023-4-27_18-55-16.png

Значения коллекции с извлеченными данными получены.

Документация ROBIN > Извлечь адреса NR > image2023-5-12_15-38-44.png