# generaltranslation: General Translation Core SDK: CustomMapping
URL: https://generaltranslation.com/ja/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`                    | 単純な表示名         | `'Simplified Chinese'`                              |
| `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) - ロケールの完全なメタデータ構造