# General Translation React SDKs (gt-react, gt-next): useRegion
URL: https://generaltranslation.com/ja/docs/react/reference/hooks/use-region.mdx
---

title: useRegion
description: General Translation gt-react で現在のリージョンを取得します。useRegion の API リファレンス。

---

`useRegion` フック は、[`<GTProvider>`](/docs/react/reference/components/gt-provider) context からユーザーが現在選択しているリージョンを返します。設定されていない場合は `undefined` を返します。

*`gt-react`、`gt-next`、`gt-react-native` で利用できます。例では `gt-react` からインポートしていますが、代わりに使用しているフレームワークのパッケージからインポートしてください。*

*注: `gt-tanstack-start` ではエクスポートされていません。*

## 概要 [#overview]

現在有効なリージョンコードを取得するには、`useRegion` を呼び出します。

```tsx
import { useRegion } from 'gt-react';

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

*注: `gt-react` では、[`<GTProvider>`](/docs/react/reference/components/gt-provider) 配下で `useRegion` を呼び出します。`gt-next` では、同期的なサーバーコンポーネントでも使用できます。*

## 仕組み [#how-it-works]

リージョンは、[`<RegionSelector>`](/docs/react/reference/components/region-selector) コンポーネントまたは [`useRegionSelector`](/docs/react/reference/hooks/use-region-selector) フックを使って設定します。ユーザーがリージョンを選択していない場合、このフックは `undefined` を返します。

## 戻り値 [#returns]

**型** `string | undefined`

現在アクティブなリージョンコードです。たとえば `US` や `CA` で、リージョンが設定されていない場合は `undefined` になります。

## メモ [#notes]

* 非同期の App Router コンポーネントでは、代わりに [`getRegion`](/docs/react/nextjs/reference/functions/get-region) を使用します。
* リージョンを変更するには、[`useSetRegion`](/docs/react/reference/hooks/use-set-region) または [`<RegionSelector>`](/docs/react/reference/components/region-selector) を使用します。