---
{
  "title": "Cómo utilizar la búsqueda multilingüe",
  "description": "FHIR especifica la extensión de traducción para almacenar traducciones del idioma base de un recurso a otros idiomas. En esta entrada, explicaremos cómo buscar recursos especificando el idioma.",
  "date": "2025-04-11",
  "author": "Evgeny Mukha",
  "reading-time": "5 min",
  "tags": [
    "Aidbox",
    "FHIR Tools"
  ]
}
---

> For the complete documentation index, see [llms.txt](https://www.health-samurai.io/llms.txt).
> Use it to discover all available pages before guessing URLs.

---
## Búsqueda multilingüe

FHIR especifica la extensión de traducción para almacenar traducciones del idioma base de un recurso a otros idiomas. En esta entrada, explicaremos cómo buscar recursos especificando el idioma.

**1. Crear un recurso con traducciones:**

Defina un [recurso FHIR](http://www.health-samurai.io/articles/extending-fhir-resources) (p. ej., `Location`) con traducciones para campos específicos utilizando la extensión FHIR [translation](https://hl7.org/fhir/extensions/StructureDefinition-translation.html). Especifique las traducciones para cada idioma incluyendo las subextensiones `lang` y `content`.


```javascript
POST /fhir/Location

resourceType: Location
id: loc-1
status: active
name: Location name
_name:
  extension:
    - url: http://hl7.org/fhir/StructureDefinition/translation
      extension:
        - url: lang
          valueCode: fr-CA
        - url: content
          valueString: Clinique médicale du cœur de la ville
    - url: http://hl7.org/fhir/StructureDefinition/translation
      extension:
        - url: lang
          valueCode: en-CA
        - url: content
          valueString: Downtown Heart Medical Clinic
```


**2. Activar la búsqueda multilingüe:**

Active la función `_search-language` en Aidbox proporcionando la siguiente variable de entorno `BOX_FEATURES_MULTILINGUAL_ENABLE__SEARCH__LANGUAGE` y estableciéndola en `true`. Esto le permite utilizar el parámetro de búsqueda **no FHIR** `[_search-language](https://www.health-samurai.io/docs/aidbox/api-1/fhir-api/search-1/search-parameters-list/_search-language)` para especificar la configuración regional de búsqueda.

**3. Realizar búsquedas en idiomas específicos:**

Utilice el parámetro `_search-language` en su solicitud a la API para especificar el idioma deseado para la búsqueda (p. ej., francés o inglés). Por ejemplo, para buscar ubicaciones por nombre en francés:


```javascript
GET /Location?_search-language=fr-CA&name=Clinique
```


Para buscar ubicaciones por nombre en inglés:


```javascript
GET /Location?_search-language=en-CA&name=Downtown
```


**4. Como alternativa, puede utilizar la cabecera `Accept-Language`:**

En lugar del parámetro de búsqueda `_search-language`, puede habilitar el uso de la cabecera HTTP `Accept-Language` proporcionando la variable de entorno `BOX_FEATURES_MULTILINGUAL_USE__ACCEPT__LANGUAGE__HEADER` y estableciéndola en `true`. Esto le permite especificar el idioma directamente en la cabecera de la solicitud. Así, en lugar de utilizar la siguiente consulta de búsqueda:


```javascript
GET /Location?_search-language=fr-CA&name=Clinique
```


Puede realizar la siguiente solicitud:


```javascript
GET /Location?name=Clinique
Accept-Language: fr-CA
```


**5. Traducir conceptos:**

Utilice el endpoint `$translate-concept` para recuperar traducciones de conceptos de [terminología](/blog/automate-terminology-translation-with-aidbox-tx-engine) específicos a partir de su código y sistema. Especifique el idioma de destino y la lista de conceptos para obtener sus traducciones. En el siguiente ejemplo, obtendremos traducciones al francés canadiense para conceptos de terminología LOINC.


```javascript
POST /$translate-concepts

language: fr-CA
concepts:
- system: http://loinc.org
  code: 1-8
- system: http://loinc.org
  code: 2-6
```


En la respuesta, recibirá los conceptos con las visualizaciones traducidas al francés canadiense.


```javascript
- code: 2-6
  system: http://loinc.org
  language: fr-CA
  translation: Almécilline:Susceptibilité:Temps ponctuel:Isolat:Quantitatif:CLM
- code: 1-8
  system: http://loinc.org
  language: fr-CA
  translation: 'Acyclovir:Susceptibilité:Temps ponctuel:Isolat:Quantitatif ou ordinal:'
```


[Más detalles](https://www.health-samurai.io/docs/aidbox/readme-1/data-api/how-to-use-multilingual-search)

Véase también: [Motor de Terminology híbrido](/blog/introducing-hybrid-terminology-engine).