# generaltranslation: General Translation Core SDK: getRegionProperties
URL: https://generaltranslation.com/fr/docs/core/class/methods/locales/get-region-properties.mdx
---
title: getRegionProperties
description: Référence de l’API de la méthode getRegionProperties de GT
---

## Vue d’ensemble

La méthode `getRegionProperties` récupère des informations détaillées sur un code de région, notamment son nom localisé et l’emoji de drapeau correspondant.
Elle offre un moyen pratique d’obtenir des informations d’affichage spécifiques à une région pour créer des interfaces utilisateur internationalisées.

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

// Obtenir les propriétés de la région
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: '🇫🇷' }

// Détection automatique à partir du paramètre régional actuel
const currentRegion = gt.getRegionProperties(); // Utilise la région du targetLocale
console.log(currentRegion);
// { code: 'FR', name: 'France', emoji: '🇫🇷' }
```

***


## Référence

### Paramètres

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

### Description des paramètres

| Paramètre       | Description                                                                                                                                                      |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `region`        | Code de région ISO 3166-1 alpha-2 ou code de région UN M.49. S&#39;il n&#39;est pas fourni, la région du paramètre régional cible de l&#39;instance est utilisée |
| `customMapping` | Mappage de région personnalisé facultatif permettant de remplacer les noms de région et les émojis par défaut                                                    |

### Renvoie

`{ code: string; name: string; emoji: string }` - Objet contenant :

* `code` : Le code de région en entrée
* `name` : Le nom localisé de la région dans la langue du paramètre régional cible
* `emoji` : Le drapeau emoji ou symbole associé

***

## Exemples

### Informations générales sur la région

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

// Codes de région courants
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: '🇯🇵' }
```

***


## Remarques

* Utilise l’API `Intl.DisplayNames` pour les noms de région localisés
* Prend en charge les codes de région ISO 3166-1 alpha-2 et UN M.49
* Les mappages de région personnalisés remplacent les noms et émojis par défaut
* Détecte automatiquement la région à partir du paramètre régional cible si aucun paramètre n’est fourni
* Utilise le code de région comme nom si la résolution du nom d’affichage échoue

## Étapes suivantes

* Récupérez l’ensemble des propriétés du paramètre régional avec [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)
* Récupérez l’emoji du paramètre régional avec [`getLocaleEmoji`](/docs/core/class/methods/locales/get-locale-emoji)