# General Translation Platform: CustomMapping
URL: https://generaltranslation.com/it/docs/platform/core/reference/types/custom-mapping.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Mappatura personalizzata dei codici locale e sovrascritture delle proprietà delle impostazioni regionali. Riferimento API per il tipo CustomMapping.

`CustomMapping` definisce mappature personalizzate dei codici locale e metadati che estendono o sovrascrivono le informazioni standard delle impostazioni regionali BCP-47. Passalo come opzione `customMapping` al [Constructor](/docs/platform/core/reference/gt-class/constructor) di General Translation o in [`GTConstructorParams`](/docs/platform/core/reference/types/gt-constructor-params).

## Panoramica [#overview]

`CustomMapping` è un record con chiave costituita da un codice locale personalizzato o da un alias. Ogni valore è una stringa con il nome visualizzato oppure un oggetto [`LocaleProperties`](/docs/platform/core/reference/types/locale-properties) parziale che sovrascrive metadati specifici dell'impostazione regionale.

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

Le mappature personalizzate vengono risolte quando l&#39;istanza GT viene inizializzata e hanno la precedenza sulla risoluzione standard delle impostazioni regionali BCP-47.

## Struttura [#structure]

* **Chiavi** — codici locale personalizzati o alias, come `'simplified-chinese'` o `'company-english'`.
* **Valori** — una semplice `stringa` con il nome visualizzato oppure un oggetto `Partial<LocaleProperties>`.

| Tipo di valore              | Descrizione                                            | Esempio                                             |
| --------------------------- | ------------------------------------------------------ | --------------------------------------------------- |
| `string`                    | Nome visualizzato semplice.                            | `'Simplified Chinese'`                              |
| `Partial<LocaleProperties>` | Override dei metadati dell&#39;impostazione regionale. | `{ code: 'zh-CN', name: 'Chinese', emoji: '🇨🇳' }` |

## Esempio [#example]

```typescript
// Mappature semplici di stringhe: alias -> nome visualizzato
const simpleMapping: CustomMapping = {
  'english': 'English',
  'spanish': 'Spanish',
  'mexican-spanish': 'Mexican Spanish'
};

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

```typescript
// Override avanzati dei metadati dell'impostazione regionale
const enhancedMapping: CustomMapping = {
  'simplified-chinese': {
    code: 'zh-CN',
    name: 'Simplified Chinese',
    nativeName: '简体中文',
    regionName: 'China',
    emoji: '🇨🇳'
  }
};
```

## Note [#notes]

* Le mappature personalizzate sovrascrivono la risoluzione standard delle impostazioni regionali BCP-47, quindi un alias può bypassare la normale convalida delle impostazioni regionali (ad esempio, usando `cn` come alias di `zh`).
* I valori stringa forniscono semplici nomi visualizzati; i valori `Partial<LocaleProperties>` consentono una personalizzazione dettagliata delle impostazioni regionali, come nomi ed emoji personalizzati.
* Le mappature personalizzate vengono risolte durante l&#39;inizializzazione dell&#39;istanza GT.
* Per le sovrascritture a livello di regione, [`getRegionProperties`](/docs/platform/core/reference/gt-class-methods/locales/get-region-properties) accetta un tipo `CustomRegionMapping` separato.

## Sitemap

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