# generaltranslation: General Translation Core SDK: getRegionProperties
URL: https://generaltranslation.com/ru/docs/core/class/methods/locales/get-region-properties.mdx
---
title: getRegionProperties
description: Справка по API для метода GT getRegionProperties
---

## Обзор

Метод `getRegionProperties` возвращает подробную информацию о коде региона, включая его локализованное название и соответствующий эмодзи-флаг.
Это удобный способ получить данные для отображения, зависящие от региона, при создании интернационализированных пользовательских интерфейсов.

```typescript
const gt = new GT({
  sourceLocale: 'en-US',
  targetLocale: 'fr-FR'
});

// Получить свойства региона
const usProps = gt.getRegionProperties('US');
console.log(usProps);
// { code: 'US', name: 'United States', emoji: '🇺🇸' }

const frProps = gt.getRegionProperties('FR');
console.log(frProps);
// { code: 'FR', name: 'France', emoji: '🇫🇷' }

// Автоопределение из текущей локали
const currentRegion = gt.getRegionProperties(); // Использует регион targetLocale
console.log(currentRegion);
// { code: 'FR', name: 'France', emoji: '🇫🇷' }
```

***


## Справочник

### Параметры

<TypeTable
  type={{
  "region?": {
    type: 'string',
    optional: true,
    default: 'this.getLocaleProperties().regionCode'
  },
  "customMapping?": {
    type: 'CustomRegionMapping',
    optional: true,
    default: 'this.customRegionMapping'
  }
}}
/>

### Описание параметров

| Параметр        | Описание                                                                                                               |
| --------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `region`        | Код региона в формате ISO 3166-1 alpha-2 или UN M.49. Если не указан, используется регион из целевой локали экземпляра |
| `customMapping` | Необязательное пользовательское сопоставление регионов, переопределяющее названия регионов и эмодзи по умолчанию       |

### Возвращает

`{ code: string; name: string; emoji: string }` — объект, содержащий:

* `code`: код входного региона
* `name`: локализованное название региона на языке целевой локали
* `emoji`: соответствующий эмодзи-флаг или символ

***

## Примеры

### Основная информация о регионе

```typescript
const gt = new GT({
  sourceLocale: 'en-US',
  targetLocale: 'en-US'
});

// Распространённые коды регионов
console.log(gt.getRegionProperties('US')); // { code: 'US', name: 'United States', emoji: '🇺🇸' }
console.log(gt.getRegionProperties('GB')); // { code: 'GB', name: 'United Kingdom', emoji: '🇬🇧' }
console.log(gt.getRegionProperties('DE')); // { code: 'DE', name: 'Germany', emoji: '🇩🇪' }
console.log(gt.getRegionProperties('JP')); // { code: 'JP', name: 'Japan', emoji: '🇯🇵' }
```

***


## Примечания

* Использует API `Intl.DisplayNames` для локализованных названий регионов
* Поддерживает коды регионов ISO 3166-1 alpha-2 и UN M.49
* Пользовательские сопоставления переопределяют стандартные названия и эмодзи
* Если параметр не указан, регион автоматически определяется по целевой локали
* Если не удаётся определить отображаемое имя, в качестве имени используется код региона

## Что дальше

* Получите полные свойства локали с помощью [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)
* Получите эмодзи локали с помощью [`getLocaleEmoji`](/docs/core/class/methods/locales/get-locale-emoji)