# General Translation Platform: CustomMapping
URL: https://generaltranslation.com/es/docs/platform/core/reference/types/custom-mapping.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Mapeos personalizados de configuraciones regionales y anulaciones de propiedades de configuración regional. Referencia de la API para el tipo CustomMapping.

`CustomMapping` define mapeos personalizados de códigos de configuración regional y metadatos que amplían o anulan la información estándar de configuración regional de BCP-47. Pásalo como la opción `customMapping` al [Constructor](/docs/platform/core/reference/gt-class/constructor) de General Translation o en [`GTConstructorParams`](/docs/platform/core/reference/types/gt-constructor-params).

## Descripción general [#overview]

`CustomMapping` es un registro cuyas claves son un código de configuración regional personalizado o un alias. Cada valor es una cadena con el nombre para mostrar o un objeto parcial [`LocaleProperties`](/docs/platform/core/reference/types/locale-properties) que sobrescribe metadatos específicos de la configuración regional.

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

Los mapeos personalizados se resuelven al inicializar la instancia de GT y tienen prioridad sobre la resolución estándar de configuraciones regionales según BCP-47.

## Estructura [#structure]

* **Claves** — códigos de configuración regional personalizados o alias, como `'simplified-chinese'` o `'company-english'`.
* **Valores** — ya sea un `string` simple con el nombre para mostrar o un objeto `Partial<LocaleProperties>`.

| Tipo de valor               | Descripción                                            | Ejemplo                                             |
| --------------------------- | ------------------------------------------------------ | --------------------------------------------------- |
| `string`                    | Nombre para mostrar simple.                            | `'Simplified Chinese'`                              |
| `Partial<LocaleProperties>` | Anulaciones de metadatos de la configuración regional. | `{ code: 'zh-CN', name: 'Chinese', emoji: '🇨🇳' }` |

## Ejemplo [#example]

```typescript
// Mapeos de cadenas simples: alias -> nombre para mostrar
const simpleMapping: CustomMapping = {
  'english': 'English',
  'spanish': 'Spanish',
  'mexican-spanish': 'Mexican Spanish'
};

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

```typescript
// Anulaciones de metadatos de configuración regional mejoradas
const enhancedMapping: CustomMapping = {
  'simplified-chinese': {
    code: 'zh-CN',
    name: 'Simplified Chinese',
    nativeName: '简体中文',
    regionName: 'China',
    emoji: '🇨🇳'
  }
};
```

## Notas [#notes]

* Los mapeos personalizados sobrescriben la resolución estándar de configuraciones regionales BCP-47, por lo que un alias puede omitir la validación estándar de la configuración regional (por ejemplo, usar `cn` como alias de `zh`).
* Los valores de tipo `string` proporcionan nombres para mostrar sencillos; los valores `Partial<LocaleProperties>` permiten una personalización detallada de la configuración regional, como nombres y emojis personalizados.
* Los mapeos personalizados se resuelven durante la inicialización de la instancia de GT.
* Para anulaciones a nivel de región, [`getRegionProperties`](/docs/platform/core/reference/gt-class-methods/locales/get-region-properties) acepta un tipo `CustomRegionMapping` independiente.

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.