# gt-next: General Translation Next.js SDK: getRegion
URL: https://generaltranslation.com/ru/docs/next/api/helpers/get-region.mdx
---
title: getRegion
description: Справка по API для серверного метода getRegion
---

## Обзор

Функция `getRegion` получает код текущего региона пользователя из встроенной cookie региона при рендеринге на сервере.

<Callout>
  `getRegion` — серверный метод, его можно использовать только в серверных компонентах.
</Callout>

Для использования на клиенте см. [`useRegion`](/docs/next/api/helpers/use-region).

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

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

`Promise<string | undefined>` — промис, который возвращает код региона пользователя (например, `"US"`, `"CA"`), либо `undefined`, если регион не задан.

***

## Примеры

### Основы использования

```jsx title="RegionDisplay.jsx" copy
import { getRegion } from 'gt-next/server';

export default async function RegionDisplay() {
  const region = await getRegion(); // [!code highlight]
  return <p>Current region: {region ?? 'Not set'}</p>;
}
```

***


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

* `getRegion` — асинхронная функция, поэтому её нужно вызывать с `await`.
* Возвращает `undefined`, если пользователь не выбрал регион.
* Регион хранится в cookie; задать его можно с помощью компонента [`<RegionSelector>`](/docs/next/api/components/region-selector) или хука [`useRegionSelector`](/docs/next/api/helpers/use-region-selector).

## Следующие шаги

* См. [`useRegion`](/docs/next/api/helpers/use-region) — клиентский аналог.
* Используйте [`<RegionSelector>`](/docs/next/api/components/region-selector), чтобы пользователи могли выбрать свой регион.