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

Parameters and their settings

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.
   
   
2. Set the parameters of the "Extract addresses" action.
   Enter the text to be recognized in the "Text" field.
   
   Set the "The original view of the address element" parameter to "true".
   
3. Drag the "Open" action to the workspace and customize the action settings.
   
   
4. Drag the "For each" loop to the workspace.
   
5. In the "Collection" parameter of the "For each" loop, add the result of the "Extract Addresses" action.
   
   
6. Drag the "Get keys" and "Get values" actions into the "For each" loop on the workspace.
   
   
7. Set up the "Get keys" and "Get values" action parameters.
   Add the result of the "For each" loop to the "Dictionary" parameter.
   
   
8. Drag the "Set column values" and "Save" actions to the workspace.
   
   
9. 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
      
10. Click on the "Start" button in the top panel.

Result

The program robot completed successfully.

The extracted addresses are recorded in a tabular document.

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

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