# generaltranslation: General Translation Core SDK: getRegionProperties
URL: https://generaltranslation.com/es/docs/core/class/methods/locales/get-region-properties.mdx
---
title: getRegionProperties
description: Referencia de la API del método getRegionProperties de GT
---

## Descripción general

El método `getRegionProperties` obtiene información detallada sobre un código de región, incluido su nombre localizado y el emoji de bandera asociado.
Proporciona una forma práctica de obtener información de presentación específica de una región para crear interfaces de usuario internacionalizadas.

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

// Obtener propiedades de la región
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: '🇫🇷' }

// Detección automática desde la configuración regional actual
const currentRegion = gt.getRegionProperties(); // Usa la región de targetLocale
console.log(currentRegion);
// { code: 'FR', name: 'France', emoji: '🇫🇷' }
```

***


## Referencia

### Parámetros

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

### Descripción de los parámetros

| Parámetro       | Descripción                                                                                                                                 |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `region`        | Código de región ISO 3166-1 alpha-2 o UN M.49. Si no se proporciona, usa la región de la configuración regional de destino de la instancia. |
| `customMapping` | Asignación personalizada de regiones opcional para sobrescribir los nombres y emojis de región predeterminados                              |

### Devuelve

`{ code: string; name: string; emoji: string }` - Objeto que contiene:

* `code`: El código de región de entrada
* `name`: Nombre localizado de la región en el idioma de la configuración regional de destino
* `emoji`: Emoji de bandera o símbolo asociado

***

## Ejemplos

### Información básica de la región

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

// Códigos de región comunes
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: '🇯🇵' }
```

***


## Notas

* Usa la API `Intl.DisplayNames` para obtener nombres de región localizados
* Admite tanto códigos de región ISO 3166-1 alfa-2 como códigos UN M.49
* Las asignaciones personalizadas de región sustituyen los nombres y emojis predeterminados
* Detecta automáticamente la región a partir de la configuración regional de destino si no se proporciona ningún parámetro
* Usa el código de región como nombre si no puede resolver el nombre para mostrar

## Próximos pasos

* Obtén todas las propiedades de la configuración regional con [`getLocaleProperties`](/docs/core/class/methods/locales/get-locale-properties)
* Obtén el emoji de la configuración regional con [`getLocaleEmoji`](/docs/core/class/methods/locales/get-locale-emoji)