# General Translation Platform: getRegionProperties
URL: https://generaltranslation.com/it/docs/platform/core/reference/utility-functions/locales/get-region-properties.mdx
---

title: getRegionProperties
description: Restituisce i metadati di una regione senza un'istanza GT. Riferimento API per getRegionProperties.

---

[`getRegionProperties`](/docs/platform/core/reference/gt-class-methods/locales/get-region-properties) è una funzione di utilità autonoma della libreria Core di General Translation che restituisce i metadati di un codice regione, incluso il nome localizzato e l'emoji che lo rappresenta.

## Panoramica [#overview]

Importa `getRegionProperties` direttamente da `generaltranslation` e chiamalo con un codice regione e, facoltativamente, un'impostazione regionale di visualizzazione. Non richiede una chiave API né un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor). Per l'equivalente basato su istanza, usa invece il metodo [`getRegionProperties`](/docs/platform/core/reference/gt-class-methods/locales/get-region-properties) di un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor).

```typescript
import { getRegionProperties } from 'generaltranslation';

console.log(getRegionProperties('US', 'en-US'));
// { code: 'US', name: 'United States', emoji: '🇺🇸' }
```

Firma:

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

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

* **Nomi localizzati.** Usa l'API `Intl.DisplayNames` per generare nomi di regioni localizzati nella `defaultLocale`.
* **Codici regione.** Supporta i codici regione ISO 3166-1 alpha-2 e UN M.49.
* **mappatura personalizzata.** Un `CustomRegionMapping` può sovrascrivere i nomi e le emoji predefiniti.
* **Fallback.** Usa il codice regione come fallback se non riesce a risolvere il nome visualizzato.

## Parametri [#parameters]

| Parametro                          | Descrizione                                                         | Tipo                  | Facoltativo | Predefinito |
| ---------------------------------- | ------------------------------------------------------------------- | --------------------- | ----------- | ----------- |
| [`region`](#region)                | Codice regione di cui recuperare le proprietà.                      | `string`              | No          | —           |
| [`defaultLocale`](#default-locale) | Impostazione regionale usata per localizzare il nome della regione. | `string`              | Sì          | `en`        |
| [`customMapping`](#custom-mapping) | Mappatura personalizzata per codici regione, nomi ed emoji.         | `CustomRegionMapping` | Sì          | —           |

### `region` [#region]

**Tipo** `string` · **Obbligatorio**

Il codice regione per cui ottenere le proprietà (ISO 3166-1 alpha-2 o UN M.49).

### `defaultLocale` [#default-locale]

**Tipo** `string` · **Facoltativo** · **Predefinito** `en`

L'impostazione regionale utilizzata per localizzare il nome della regione restituito.

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

**Tipo** `CustomRegionMapping` · **Facoltativo**

Una mappatura personalizzata facoltativa per i codici regione, che può sovrascrivere i nomi e le emoji predefiniti.

## Restituisce [#returns]

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

Un oggetto contenente le informazioni sulla regione, inclusi il codice regione, il nome localizzato e l'emoji.

## Esempi [#examples]

```typescript
import { getRegionProperties } from 'generaltranslation';

// Proprietà della region con nomi in inglese
console.log(getRegionProperties('US', 'en-US'));
// { code: 'US', name: 'United States', emoji: '🇺🇸' }

console.log(getRegionProperties('JP', 'en-US'));
// { code: 'JP', name: 'Japan', emoji: '🇯🇵' }

// Proprietà della region con nomi localizzati
console.log(getRegionProperties('US', 'de-DE'));
// { code: 'US', name: 'Vereinigte Staaten', emoji: '🇺🇸' }
```

## Note [#notes]

* Usa l'API `Intl.DisplayNames` per i nomi localizzati delle regioni.
* Supporta i codici regione ISO 3166-1 alpha-2 e UN M.49.
* Le mappature personalizzate possono sovrascrivere nomi ed emoji predefiniti.
* Se la risoluzione del nome visualizzato non riesce, usa come fallback il codice regione.
* Nessuna dipendenza esterna oltre alle API del browser.