# generaltranslation: General Translation Core SDK: getRegionProperties
URL: https://generaltranslation.com/ja/docs/core/functions/locales/get-region-properties.mdx
---
title: getRegionProperties
description: getRegionProperties 関数の API リファレンス
---

## 概要

`getRegionProperties` 関数は、GT クラスのインスタンスがなくても、地域コードの詳細情報を取得できます。

***

## リファレンス

### パラメータ

<TypeTable
  type={{
  "region": {
    type: 'string',
    optional: false,
  },
  "defaultLocale?": {
    type: 'string',
    optional: true,
  },
  "customMapping?": {
    type: 'CustomRegionMapping',
    optional: true,
  }
}}
/>

### 戻り値

`{ code: string; name: string; emoji: string }` - 地域情報を表すオブジェクト

***

## 例

```typescript
import { getRegionProperties } from 'generaltranslation';

// 英語名で地域プロパティを取得する
console.log(getRegionProperties('US', 'en-US'));
// { code: 'US', name: 'United States', emoji: '🇺🇸' }

console.log(getRegionProperties('JP', 'en-US'));
// { code: 'JP', name: 'Japan', emoji: '🇯🇵' }

// ローカライズされた名前で地域プロパティを取得する
console.log(getRegionProperties('US', 'de-DE'));
// { code: 'US', name: 'Vereinigte Staaten', emoji: '🇺🇸' }
```

***


## 注記

* ローカライズされた地域名には `Intl.DisplayNames` API を使用します
* ISO 3166-1 alpha-2 および UN M.49 の地域コードに対応しています
* カスタムマッピングでデフォルトの名称や絵文字を上書きできます
* 表示名を解決できない場合は、地域コードにフォールバックします
* ブラウザ API 以外の外部依存関係はありません

## 次のステップ

* GT クラスメソッド [`getRegionProperties`](/docs/core/class/methods/locales/get-region-properties) を使用する
* [`getLocaleProperties`](/docs/core/functions/locales/get-locale-properties) を使ってロケールの完全な情報を取得する