# generaltranslation: General Translation Core SDK: getRegionProperties
URL: https://generaltranslation.com/it/docs/core/class/methods/locales/get-region-properties.mdx
---
title: getRegionProperties
description: Riferimento API del metodo GT getRegionProperties
---

## Panoramica

Il metodo `getRegionProperties` recupera informazioni dettagliate su un codice regione, incluso il nome localizzato e l'emoji della bandiera associata.
Offre un modo pratico per ottenere informazioni di visualizzazione specifiche della regione per creare interfacce utente internazionalizzate.

```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: 'United States', emoji: '🇺🇸' }

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

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

***


## Riferimento

### Parametri

<TypeTable
  type={{
  "region?": {
    type: 'string',
    optional: true,
    default: 'this.getLocaleProperties().regionCode'
  },
  "customMapping?": {
    type: 'CustomRegionMapping',
    optional: true,
    default: 'this.customRegionMapping'
  }
}}
/>

### Descrizione dei parametri

| Parametro       | Descrizione                                                                                                                                        |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `region`        | Codice regione ISO 3166-1 alpha-2 o UN M.49. Se non viene fornito, usa la regione dell&#39;impostazione regionale di destinazione dell&#39;istanza |
| `customMapping` | Mappatura personalizzata facoltativa delle regioni per sovrascrivere i nomi delle regioni e le relative emoji predefinite                          |

### Restituisce

`{ code: string; name: string; emoji: string }` - Oggetto contenente:

* `code`: Il codice regione in input
* `name`: Nome localizzato della regione nella lingua dell&#39;impostazione regionale di destinazione
* `emoji`: Emoji della bandiera o simbolo associato

***

## Esempi

### Informazioni di base sulla regione

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

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

***


## Note

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

## Passaggi successivi

* Ottieni tutte le proprietà dell&#39;impostazione regionale con [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)
* Ottieni l&#39;emoji dell&#39;impostazione regionale con [`getLocaleEmoji`](/docs/core/class/methods/locales/get-locale-emoji)