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

...

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 Removed

Параметры

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

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

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

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

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

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

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

Настройки

Image Added

Parameters and their settings

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

1. Если в поле "Текст" заданный текст не имеет какого-либо поля адреса, то значение в словаре вернется пустым. При отсутствии в тексте всех адресообразующих элементов действие вернет пустой результат.
2. Словарь всегда создается с полным набором ключей, чтобы не возникало ошибки при обращении к любому ключу словаря.
3. Если одновременно отмечены параметры "Без вида элемента адреса" и "Исходный вид элемента адреса", то галочка у "Исходный вид элемента адреса" будет проигнорирована.
4. Если в одном предложении указаны страна, и город, а в другом предложении списком улица, дом, индекс, то есть в разных предложениях части одной сущности, то они извлекутся как разные адреса в отдельные словари, не дополняя друг друга.

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

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

• • В исходном тексте не будет найдено ни одного элемента адреса.

  • Исходный текст на неподдерживаемом языке. В текущей версии поддерживается русский язык.

Справочная таблица

Special conditions of use

1. 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.
2. A dictionary is always created with a complete set of keys so that no error occurs when accessing any key in the dictionary.
3. 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.
4. 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.

5. 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.

6. 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Общепринятые сокращения слов, которые включаются в адрес и адресообразующие элементы приведены в таблице.

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

Задача

Имеется текст для распознавания:

...

Example of use

Task

There is a text to recognize:

...

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

1. Drag the "Extract addresses" action to the workspace.
   Image Added
   
2. 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

...

Необходимо извлечь из текста адреса и записать в имеющийся табличный документ.

Решение

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

Реализация

1. Перетащить на рабочую область действие "Извлечь адреса".
   Image Removed
   Настроить параметры действия "Извлечь адреса".
   В поле "Текст" ввести текст для распознавания.
   Image Removed
   Для параметра "Исходный вид элемента адреса" установить значение "true".
   Перетащить на рабочую область действие "Открыть" и настроить параметры действия
2. Drag the "Open" action to the workspace and customize the action settings.
   
   
3. Перетащить на рабочую область цикл "Для каждого"Drag the "For each" loop to the workspace.
   
4. В параметр In the "КоллекцияCollection" цикла "Для каждого" добавить результат действия "Извлечь адреса"parameter of the "For each" loop, add the result of the "Extract Addresses" action.
   
   
5. Перетащить на рабочую область действия "Получить ключи" и "Получить значения" в цикл "Для каждого"Drag the "Get keys" and "Get values" actions into the "For each" loop on the workspace.
   
   Настроить параметры действий "Получить ключи" и "Получить значения".
   В параметр "Словарь" добавить результат цикла "Для каждого"
6. Set up the "Get keys" and "Get values" action parameters.
   Add the result of the "For each" loop to the "Dictionary" parameter.
   
   Перетащить на рабочую область действия "Установить значения столбца".
   Image Removed
   Настроить параметры действий "Установить значения столбца". 
7. Установить контекст - результат действия "Открыть"
8. В параметр "Имя столбца" добавить столбцы A и B
9. В параметр "Значение ячеек" добавить результаты действий "Получить ключи" и "Получить значения"
Установить номер начальной строки диапазона
Image RemovedImage Removed

10. Нажать на кнопку "Старт" в верхней панели.

Результат

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

Извлеченные адреса записаны в табличный документ.

Image Removed

Image Removed

При установке значения "true" параметра "Без вида элемента адреса" действия "Извлечь адреса"

Image Removed

1. Drag the "Set column values" and "Save" actions to the workspace.
   Image Added
   
2. 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
3. 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 в результирующем словаре не будут указаны виды элементов адреса: