# generaltranslation: General Translation Core SDK: CustomMapping
URL: https://generaltranslation.com/ru/docs/core/types/custom-mapping.mdx
---
title: CustomMapping
description: Определение типа для пользовательских сопоставлений кодов локалей и расширенных метаданных локалей
---

## Обзор

`CustomMapping` определяет пользовательские сопоставления кодов локалей и метаданные, которые расширяют или переопределяют стандартные сведения о локалях BCP-47.

```typescript
type CustomMapping = Record<string, string | Partial<LocaleProperties>>;
```


## Определение типа

### Структура

`CustomMapping` — это запись, в которой:

* **Ключи**: пользовательские коды локалей или псевдонимы (например, `'simplified-chinese'`, `'company-english'`)
* **Значения**: либо простое строковое имя, либо частичный объект `LocaleProperties`

### Типы значений

| Тип                         | Описание                      | Пример                                              |
| --------------------------- | ----------------------------- | --------------------------------------------------- |
| `string`                    | Простое отображаемое имя      | `'Упрощённый китайский'`                            |
| `Partial<LocaleProperties>` | Расширенные метаданные локали | `{ code: 'zh-CN', name: 'Chinese', emoji: '🇨🇳' }` |

***

## Примеры

### Простые соответствия строк

```typescript copy
const simpleMapping: CustomMapping = {
  'english': 'English',
  'spanish': 'Spanish',
  'mexican-spanish': 'Mexican Spanish'
};

const gt = new GT({
  sourceLocale: 'english',
  targetLocale: 'spanish',
  customMapping: simpleMapping
});
```


### Расширенные метаданные локали

```typescript copy
const enhancedMapping: CustomMapping = {
  'simplified-chinese': {
    code: 'zh-CN',
    name: 'Simplified Chinese',
    nativeName: '简体中文',
    regionName: 'China',
    emoji: '🇨🇳'
  }
};
```

***


## Примечания

* Пользовательские сопоставления имеют приоритет над стандартным определением локали BCP-47
* Строковые значения задают простые отображаемые имена
* Частичные LocaleProperties позволяют более тонко настраивать локаль
* Пользовательские сопоставления обрабатываются при инициализации экземпляра GT

## Связанные типы

* [`LocaleProperties`](/docs/core/types/locale-properties) — Полная структура метаданных локали