# General Translation Platform: getLocaleEmoji
URL: https://generaltranslation.com/it/docs/platform/core/reference/gt-class-methods/locales/get-locale-emoji.mdx
---

title: getLocaleEmoji
description: Restituisce un'emoji identificativa per un'impostazione regionale o una regione. Riferimento API per getLocaleEmoji.

---

Recupera una emoji bandiera o un simbolo per un codice locale in un'istanza di [GT](/docs/platform/core/reference/gt-class/constructor), in base alla relativa regione. General Translation restituisce emoji di bandiere di paesi e territori, con fallback per le lingue senza una regione specifica e supporto per emoji personalizzate tramite mappature.

## Panoramica [#overview]

Chiama `getLocaleEmoji` su un'istanza di [`GT`](/docs/platform/core/reference/gt-class/constructor) con un codice locale facoltativo. Se non viene specificato, viene usato il `targetLocale` dell'istanza.

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

const emoji = gt.getLocaleEmoji('fr-CA');
console.log(emoji); // "🇨🇦" (bandiera canadese)

const usEmoji = gt.getLocaleEmoji('en-US');
console.log(usEmoji); // "🇺🇸" (bandiera USA)

const enEmoji = gt.getLocaleEmoji('en');
console.log(enEmoji); // "🇺🇸" (bandiera USA)
```

Firma:

```typescript
getLocaleEmoji(locale?: string): string
```

*Nota: `getLocaleEmoji` viene eseguito in locale e non richiede una chiave API. Usa il `targetLocale` dell'istanza se `locale` non è specificato. Per le ricerche senza un'istanza `GT`, vedi la versione autonoma di [`getLocaleEmoji`](/docs/platform/core/reference/utility-functions/locales/get-locale-emoji).*

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

* **Selezione basata sulla regione.** Usa il codice regione dell'impostazione regionale (quando disponibile) per selezionare un'emoji di bandiera, composta dai simboli Unicode degli indicatori regionali.
* **Priorità di `CustomMapping`.** Le emoji definite in un [`CustomMapping`](/docs/platform/core/reference/types/custom-mapping) hanno la precedenza sulla selezione basata sulla regione.
* **Fallback.** Restituisce un'emoji specifica della lingua per alcune lingue senza regione e l'emoji del globo predefinita `🌍` per impostazioni regionali non riconosciute o non valide.
* **Impostazione regionale mancante.** Genera un `Error` se non viene fornita alcuna impostazione regionale e l'istanza non ha alcun `targetLocale` configurato.

## Parametri [#parameters]

| Parametro           | Descrizione                                        | Type     | Facoltativo | Predefinito         |
| ------------------- | -------------------------------------------------- | -------- | ----------- | ------------------- |
| [`locale`](#locale) | Codice locale BCP-47 per cui ottenere l'emoji. | `string` | Sì          | `this.targetLocale` |

### `locale` [#locale]

**Tipo** `string` · **Facoltativo** · **Predefinito** `this.targetLocale`

Codice locale BCP-47 per cui ottenere l'emoji. Se non viene fornito, viene usato il `targetLocale` dell'istanza.

## Restituisce [#returns]

**Tipo** `string`

Un'emoji di bandiera o un simbolo che rappresenta l'impostazione regionale:

* Emoji della bandiera del paese/territorio per le impostazioni regionali con una regione associata (ad esempio, `🇺🇸`, `🇫🇷`, `🇯🇵`).
* Emoji specifiche della lingua per alcune lingue senza regione.
* L'emoji del globo predefinita (`🌍`) per le impostazioni regionali non riconosciute.

Genera un `Error` se non viene fornita alcuna impostazione regionale e l'istanza non ha alcun `targetLocale` configurato.

## Esempi [#examples]

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

// Ottieni l'emoji per l'impostazione regionale target
console.log(gt.getLocaleEmoji()); // "🇪🇸" (uses targetLocale 'es')

// Ottieni emoji per diverse impostazioni regionali
console.log(gt.getLocaleEmoji('en-US')); // "🇺🇸"
console.log(gt.getLocaleEmoji('fr-FR')); // "🇫🇷"
console.log(gt.getLocaleEmoji('de-DE')); // "🇩🇪"
console.log(gt.getLocaleEmoji('ja-JP')); // "🇯🇵"
console.log(gt.getLocaleEmoji('zh-CN')); // "🇨🇳"
```

## Note [#notes]

* Restituisce emoji di bandiere in base al codice regione dell'impostazione regionale, quando disponibile.
* Le emoji del mapping personalizzato hanno la priorità sulla selezione basata sulla regione.
* Usa i simboli indicatori regionali Unicode per generare le bandiere.
* Per impostazione predefinita, usa `🌍` (globo) per le impostazioni regionali non riconosciute o non valide.
* Compatibile con tutti i browser moderni e i sistemi operativi che supportano le emoji Unicode.