# generaltranslation: General Translation Core SDK: getRegionProperties
URL: https://generaltranslation.com/ru/docs/core/functions/locales/get-region-properties.mdx
---
title: getRegionProperties
description: Справка по API функции getRegionProperties
---

## Обзор

Функция `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: '🇺🇸' }
```

***


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

* Использует API `Intl.DisplayNames` для локализованных названий регионов
* Поддерживает коды регионов 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)