# General Translation React SDKs (gt-react, gt-next, gt-react-native): Registrare le impostazioni regionali delle richieste
URL: https://generaltranslation.com/it/docs/react/nextjs/registering-request-locales.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Come registrare un'impostazione regionale per i route handler di Next.js App Router e per gli handler delle immagini dei metadati generate con General Translation.

Con un segmento radice `[locale]`, `gt-next` legge normalmente l'impostazione regionale tramite `next/root-params`. I route handler e gli handler delle immagini dei metadati generate non possono usare quel modulo. Leggi l'impostazione regionale dall'input dell'handler, quindi chiama [`registerLocale`](/docs/react/nextjs/reference/functions/register-locale) prima di qualsiasi altra funzione di `gt-next/server`.

## Registra un Route Handler [#route-handlers]

Per un handler in `app/[locale]`, leggi l'impostazione regionale da `params`:

```ts title="app/[locale]/api/greeting/route.ts"
import { getGT, registerLocale } from 'gt-next/server';

export async function GET(
  _request: Request,
  { params }: { params: Promise<{ locale: string }> },
) {
  const { locale } = await params;
  registerLocale(locale);

  const gt = await getGT();
  return Response.json({ greeting: gt('Welcome') });
}
```

Per un handler esterno a `[locale]`, ricava l&#39;impostazione regionale dall&#39;URL della `Request`, dagli header, dai parametri di query o dal corpo della richiesta in base alla tua API, quindi registrala allo stesso modo.

L&#39;impostazione regionale registrata è disponibile per [`getGT`](/docs/react/nextjs/reference/functions/get-gt), [`getLocale`](/docs/react/nextjs/reference/functions/get-locale), [`getTranslations`](/docs/react/nextjs/reference/functions/get-translations), [`getMessages`](/docs/react/nextjs/reference/functions/get-messages) e altre funzioni di `gt-next/server` per il resto della richiesta.

## Registra un handler per le immagini dei metadati [#metadata-images]

Anche i file Open Graph, Twitter, icona e icona Apple generati ricevono i `params` della route:

```tsx title="app/[locale]/opengraph-image.tsx"
import { ImageResponse } from 'next/og';
import { getGT, registerLocale } from 'gt-next/server';

export default async function Image({
  params,
}: {
  params: Promise<{ locale: string }>;
}) {
  const { locale } = await params;
  registerLocale(locale);

  const gt = await getGT();
  return new ImageResponse(<div>{gt('Welcome')}</div>);
}
```

Usa lo stesso pattern in `twitter-image.tsx`, `icon.tsx` e `apple-icon.tsx`.

## Gestisci altri punti di ingresso [#other-entry-points]

`generateMetadata` riceve i parametri di route dinamici dalla radice fino al segmento corrente, quindi non ha la stessa limitazione di un handler per le immagini dei metadati.

I file `sitemap.ts`, `robots.ts` e `manifest.ts` generati non ricevono parametri di route né un oggetto `request`. Scegli esplicitamente l&#39;impostazione regionale nella logica di generazione, quindi registrala prima di chiamare una funzione di `gt-next/server`.

La registrazione è limitata alla richiesta corrente. Chiama [`registerLocale`](/docs/react/nextjs/reference/functions/register-locale) una sola volta, dopo aver determinato l&#39;impostazione regionale e prima di qualsiasi altra funzione server di General Translation.

## Next steps

- /docs/react/nextjs/reference/functions/register-locale
- /docs/react/nextjs/app-router-middleware
- /docs/react/nextjs/reference/functions/get-locale
- /docs/react/nextjs/reference/functions/get-gt

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.