# Анализ, проверка и сравнение имен

## Синтаксический анализ полных имен

Tisane  может разбить полные имена на ключевые компоненты:

| Атрибут | Описание |
|  --- | --- |
| `given_name` | Имя (например, *Джон*) |
| `middle_name` | среднее имя (если уместно) |
| `surname` | Фамилия (например, * Доу*) |
| `title` | Почтительные обращения (например, *доктор, господин, госпожа*) |
| `suffix` | суффикс имени (например, *младший, старший, III* ) |
| `social_role` | Роли, как *хаджи* или *доктор.* |


## Как выполнить синтаксический анализ имени

Чтобы выполнить синтаксический анализ полного имени, отправьте запрос `POST/parse` с:

* `"entity": "person"`
* `"words": true`


В ответе компоненты имени будут отнесены к атрибуту `role`.

Пример синтаксического анализа имени:
![tisaneAliKilicoglu.png](/assets/tisanealikilicoglu.5951cdee9a0cb388e6ee70d83d35237e03a4472545f4afad2fe7f24608ccc2b5.9c1bb791.png)

## Проверка настоящих имен

Хотя Tisane не может проверить, является ли указанное пользователем имя реальным, он распознает множество имен, связанных с:

- известными личностями (`important_person`);
- вымышленными персонажами (`fictional_character`);
- духовными существами (`spiritual_being`);
- именами, которые не кажутся именами (например: User-13789026152908425434).


Список распространенных поддельных имен см. в [этой публикации на Quora](https://qr.ae/pNKxWl).

Атрибут `subtype` в структуре `entity` указывает тип обнаруженного имени с идентификатором Wikidata, если он доступен.

Пример синтаксического анализа имени вымышленного персонажа:

![tisaneFictionalCharacter.png](/assets/tisanefictionalcharacter.8303e6f6a0fe6f308d798a09a6a5daa2c2c8f3a9a3e452c30e0eadd8902fa953.9c1bb791.png)

## Сравнение имен

Метод `/compare/entities` позволяет сравнить два имени (даже на разных языках) и обнаружить различия.

### Примеры сравнений

| Имя 1 | Имя 2 | Результат |
|  --- | --- | --- |
| *Уильям Смит* | *Уилл Смит* | `{"result":"different","differences":["variation"]}` |
| *Муса бин Осман* | *Хадж Муса бин Осман* | `{"result":"different","differences":["social_role"]}` |
| *Уильям Смит* | *Вилл Смит* (т.е. Уилл Смит) | `{"result":"different","differences":["variation"]}` |
| *Кевин Тан* | *ТАН Кевин* | `{"result":"same"}` |


### **Как сравнивать имена**

Отправить запрос конечной точке `/compare/entities` с именами для сравнения, и ответ вернет различия в атрибутах, например:

- `variation` (например, *Уильям* по сранвнию с *Уилл*)
- `social_role` (например, *Хаджи Муса* по сравнению с *Муса*)
- `case_difference` (например, *Джон Доу* по сравнению с *ДЖОН ДОУ*)
- `same` (идентичные имена, даже если порядок разный)


## Проверка ников и псевдонимов

Имена пользователей и псевдонимы могут быть вводящими в заблуждение, оскорбительными или непристойными. Tisane обнаруживает неподходящие имена пользователей (например, *Гитлер*, *Пользователь Джон_является_ лжецом*).

### Как проверить псевдоним

Отправьте запрос `POST /parse` вместе с:

- ` "format": "alias"`
- Настройка `subscope` гарантирует правильную сегментацию имен, даже если они написаны слитно заглавными буквами, с подчеркиваниями или без пробелов.


Пример проверки псевдонима:

![tisaneAliasCreep.png](/assets/tisanealiascreep.32cde88dfdeefd6637dcae193827a5b8714a194f43c0c45459d776a94720ad2e.9c1bb791.png)