# General Translation Platform: getRegionProperties
URL: https://generaltranslation.com/it/docs/platform/core/reference/gt-class-methods/locales/get-region-properties.mdx
---
title: getRegionProperties
description: Restituisce i metadati di una regione per un codice di impostazione regionale o di codice regione. Riferimento API per getRegionProperties.

---

Recupera i dettagli di un codice regione da un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor), inclusi il nome localizzato e l'emoji della bandiera associata. General Translation offre un modo pratico per ottenere informazioni di visualizzazione specifiche della regione e creare interfacce utente internazionalizzate.

## Panoramica [#overview]

Chiama `getRegionProperties` su un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor), facoltativamente con un codice regione. Se omesso, viene usata la regione dell'impostazione regionale di destinazione dell'istanza.

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

// Ottieni le proprietà della regione
const usProps = gt.getRegionProperties('US');
console.log(usProps);
// { code: 'US', name: 'États-Unis', emoji: '🇺🇸' }

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

// Rilevamento automatico dall'impostazione regionale corrente
const currentRegion = gt.getRegionProperties(); // Usa la regione del targetLocale
console.log(currentRegion);
// { code: 'FR', name: 'France', emoji: '🇫🇷' }
```

Firma:

```typescript
getRegionProperties(
  region?: string,
  customMapping?: CustomRegionMapping
): { code: string; name: string; emoji: string }
```

*Nota: `getRegionProperties` viene eseguito localmente con `Intl.DisplayNames` e non richiede una chiave API. Usa la regione del `targetLocale` dell'istanza quando `region` viene omesso e localizza il nome della regione per il `targetLocale` dell'istanza. Per le ricerche senza un'istanza `GT`, consulta la versione autonoma di [`getRegionProperties`](/docs/platform/core/reference/utility-functions/locales/get-region-properties).*

## Come funziona [#how-it-works]

* **Codici regione.** Accetta codici regione ISO 3166-1 alpha-2 o UN M.49 (ad esempio `"US"`, `"FR"`, `"419"`).
* **Nomi localizzati.** Usa `Intl.DisplayNames` per localizzare il nome della regione in base al `targetLocale` dell'istanza, con fallback all'impostazione regionale predefinita della libreria.
* **Priorità del custom mapping.** Se `customMapping` definisce un `name` o un `emoji` per la regione, questi valori hanno la precedenza su quelli predefiniti.
* **Fallback.** Usa il codice regione come `name` se la risoluzione del nome visualizzato fallisce, e un'emoji predefinita se non viene trovata alcuna mappatura per l'emoji.
* **Fallback della regione.** Quando `region` viene omesso, viene usata la regione dell'impostazione regionale di destinazione dell'istanza.
* **Impostazione regionale mancante.** Genera un `Error` se non è disponibile alcuna impostazione regionale di destinazione da cui determinare le proprietà della regione.

## Parametri [#parameters]

| Parametro                          | Descrizione                                                                         | Tipo                  | Facoltativo | Predefinito                             |
| ---------------------------------- | ----------------------------------------------------------------------------------- | --------------------- | ----------- | --------------------------------------- |
| [`region`](#region)                | Codice regione ISO 3166-1 alpha-2 o codice regione UN M.49.                         | `string`              | Sì          | `this.getLocaleProperties().regionCode` |
| [`customMapping`](#custom-mapping) | Mappatura personalizzata delle regioni per sovrascrivere nomi ed emoji predefiniti. | `CustomRegionMapping` | Sì          | `this.customRegionMapping`              |

### `region` [#region]

**Tipo** `string` · **Facoltativo** · **Predefinito** `this.getLocaleProperties().regionCode`

Codice regione ISO 3166-1 alpha-2 o UN M.49. Se non specificato, viene usata la regione dell'impostazione regionale di destinazione dell'istanza.

### `customMapping` [#custom-mapping]

**Tipo** `CustomRegionMapping` · **Facoltativo** · **Predefinito** `this.customRegionMapping`

Mappatura personalizzata delle regioni facoltativa per sovrascrivere i nomi e le emoji predefinite delle regioni.

## Valore restituito [#returns]

**Tipo** `{ code: string; name: string; emoji: string }`

Un oggetto che contiene:

* `code`: il codice regione in input.
* `name`: il nome della regione localizzato (o personalizzato) nella lingua dell'impostazione regionale di destinazione.
* `emoji`: la bandiera emoji o il simbolo associato.

## Esempi [#examples]

```typescript
// Informazioni di base sulla regione
const gt = new GT({ sourceLocale: 'en-US', targetLocale: 'en-US' });

// Codici regione comuni
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: '🇯🇵' }
```

```typescript
// La mappatura personalizzata delle regioni sovrascrive i valori predefiniti
const gt = new GT({ targetLocale: 'en-US' });

console.log(gt.getRegionProperties('US', { US: { name: 'USA', emoji: '🗽' } }));
// { code: 'US', name: 'USA', emoji: '🗽' }
```

## Note [#notes]

* Usa l'API `Intl.DisplayNames` per i nomi delle regioni localizzati.
* Supporta sia i codici regione ISO 3166-1 alpha-2 sia i codici regione UN M.49.
* Le mappature personalizzate sovrascrivono i nomi e le emoji predefiniti.
* Se non viene fornito alcun parametro, rileva automaticamente la regione dall'impostazione regionale di destinazione.
* Se la risoluzione del nome visualizzato non riesce, usa il codice regione come nome.