# generaltranslation: General Translation Core SDK: getRegionProperties
URL: https://generaltranslation.com/fr/docs/core/functions/locales/get-region-properties.mdx
---
title: getRegionProperties
description: Référence d’API de la fonction getRegionProperties
---

## Vue d’ensemble

La fonction `getRegionProperties` récupère des informations détaillées sur un code de région sans nécessiter d’instance de la classe GT.

***

## Référence

### Paramètres

<TypeTable
  type={{
  "region": {
    type: 'string',
    optional: false,
  },
  "defaultLocale?": {
    type: 'string',
    optional: true,
  },
  "customMapping?": {
    type: 'CustomRegionMapping',
    optional: true,
  }
}}
/>

### Renvoie

`{ code: string; name: string; emoji: string }` - Objet d&#39;information sur la région

***

## Exemples

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

// Obtenir les propriétés de région avec des noms en anglais
console.log(getRegionProperties('US', 'en-US'));
// { code: 'US', name: 'United States', emoji: '🇺🇸' }

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

// Obtenir les propriétés de région avec des noms localisés
console.log(getRegionProperties('US', 'de-DE'));
// { code: 'US', name: 'Vereinigte Staaten', emoji: '🇺🇸' }
```

***


## Remarques

* Utilise l’API `Intl.DisplayNames` pour les noms de régions localisés
* Prend en charge les codes de région ISO 3166-1 alpha-2 et UN M.49
* Des mappages personnalisés peuvent remplacer les noms et émojis par défaut
* Utilise le code de région comme solution de repli si la résolution du nom d’affichage échoue
* Aucune dépendance externe en dehors des API du navigateur

## Étapes suivantes

* Utilisez la méthode de classe GT [`getRegionProperties`](/docs/core/class/methods/locales/get-region-properties)
* Obtenez les informations complètes sur le paramètre régional avec [`getLocaleProperties`](/docs/core/functions/locales/get-locale-properties)