# generaltranslation: General Translation Core SDK: CustomMapping
URL: https://generaltranslation.com/it/docs/core/types/custom-mapping.mdx
---
title: CustomMapping
description: Definizione di tipo per mappature personalizzate dei codici locale e metadati avanzati delle impostazioni regionali
---

## Panoramica

`CustomMapping` definisce mappature personalizzate dei codici locale e metadati che estendono o sovrascrivono le informazioni standard BCP-47 sulle impostazioni regionali.

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


## Definizione del tipo

### Struttura

`CustomMapping` è un record in cui:

* **Chiavi**: codici locale personalizzati o alias (ad es. `'simplified-chinese'`, `'company-english'`)
* **Valori**: una semplice stringa oppure un oggetto `LocaleProperties` parziale

### Tipi di valore

| Tipo                        | Descrizione                                   | Esempio                                             |
| --------------------------- | --------------------------------------------- | --------------------------------------------------- |
| `string`                    | Nome visualizzato semplice                    | `'Simplified Chinese'`                              |
| `Partial<LocaleProperties>` | Metadati avanzati dell’impostazione regionale | `{ code: 'zh-CN', name: 'Chinese', emoji: '🇨🇳' }` |

***

## Esempi

### Mappature semplici di stringhe

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

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


### Metadati avanzati dell’impostazione regionale

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

***


## Note

* Le mappature personalizzate prevalgono sulla risoluzione standard delle impostazioni regionali BCP-47
* I valori di tipo stringa forniscono semplici nomi da visualizzare
* Le LocaleProperties parziali consentono una personalizzazione dettagliata dell&#39;impostazione regionale
* Le mappature personalizzate vengono risolte durante l&#39;inizializzazione dell&#39;istanza GT

## Tipi correlati

* [`LocaleProperties`](/docs/core/types/locale-properties) - Struttura completa dei metadati dell’impostazione regionale