> For the complete documentation index, see [llms.txt](https://m-moyaconsulting.gitbook.io/gisbook/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://m-moyaconsulting.gitbook.io/gisbook/geoprocesamiento/merge-combinar.md).

# Merge (combinar)

#### 📌 ¿Qué es?

La herramienta **Merge** permite combinar dos o más capas vectoriales con la misma estructura (tipo de geometría y campos) en una sola capa unificada. Es útil cuando se desea consolidar información dispersa en varias capas en un único archivo para facilitar el análisis o la visualización.

#### ⚙️ ¿Cómo funciona?

* **Entrada**: varias capas con el mismo tipo de geometría (puntos, líneas o polígonos) y atributos compatibles.
* **Proceso**: se unifican todas las entidades en una nueva capa.
* **Salida**: una única capa que contiene todos los elementos de entrada, con sus respectivos atributos.

> 💡 *Importante: A diferencia de Union o Append, Merge no requiere que las capas estén espacialmente relacionadas. Solo deben ser del mismo tipo geométrico.*

<figure><img src="/files/syblZJTPQ2Es6Q8ocy6U" alt="" width="319"><figcaption><p>Ejemplo del uso de la herramienta Merge</p></figcaption></figure>

🌱 Aplicación en recursos naturales&#x20;

* Unir coberturas de suelo por provincia para crear una capa nacional de uso del suelo.
* Consolidar inventarios forestales realizados por distintas municipalidades.
* Unificar capas de incendios forestales registradas por región (Pacífico Norte, Caribe, etc.).
* Combinar zonas de conservación de varias ONG en una sola capa para análisis conjunto.
* Integrar parcelas de monitoreo de biodiversidad de diferentes áreas protegidas.
* Fusionar mapas de ecosistemas costeros obtenidos de diferentes campañas de campo.
* Combinar datos de humedales de distintas cuencas para un estudio hidrológico nacional.
* Unificar capas de cultivos permanentes (piña, banano, café) por cantón para planificación agrícola.
* Integrar capas de caminos rurales recopiladas por proyectos distintos en una red vial completa.
* Combinar mapas de áreas prioritarias para restauración en distintos corredores biológicos.

#### 🧰 Consideraciones según el tipo de geometría

* Las capas deben tener el **mismo tipo de geometría**: puntos, líneas o polígonos.
* Los **nombres de los campos pueden ser diferentes**, pero ArcGIS permite definir cómo se alinearán los campos durante el proceso.
* Si algunas capas tienen campos que otras no, esos campos quedarán vacíos (NULL) para las entidades que no los posean.
* No se requiere que las capas estén espacialmente conectadas o que se solapen.
* Es ideal para **unir datos distribuidos espacialmente pero temáticamente iguales**.

#### 📂 Visualización de la herramienta en ArcGIS Pro:

<figure><img src="/files/QKrMnjDbaMIFsm9NGmgi" alt="" width="170"><figcaption><p>Ventana de configuración</p></figcaption></figure>

* Entrada (input): `Cobertura_Forestal_Heredia.shp   +  Cobertura_Forestal_Cartago.shp`
* Output (Salida): `Cobertura_Forestal_Heredia_Cartago.shp`

### 🐍 **Ejemplo de código en Python – Merge de capas de uso del suelo (ArcPy)**

```python
pythonCopiarEditar# -----------------------------------------------
# Script: merge_uso_suelo.py
# Descripción: Combina varias capas de uso del suelo
# por provincia en una sola capa nacional.
# -----------------------------------------------

import arcpy

# Configurar el entorno de trabajo
arcpy.env.workspace = r"C:/SIG/proyecto"
arcpy.env.overwriteOutput = True  # Permitir sobrescribir archivos existentes

# Lista de capas de entrada (pueden estar en .shp, .gdb o .lyr)
capas_entrada = [
    "uso_suelo_limon.shp",
    "uso_suelo_cartago.shp",
    "uso_suelo_sanjose.shp"
]

# Ruta de salida para la capa combinada
salida = r"C:/SIG/salida/uso_suelo_nacional.shp"

# Ejecutar Merge
arcpy.management.Merge(capas_entrada, salida, "", "ADD_SOURCE_INFO")

# Mensaje de confirmación
print("✅ Proceso finalizado: capas combinadas en", salida)
```

***

#### 🧰 Explicación de los parámetros clave:

| Parámetro         | Valor                              | Descripción                                                      |
| ----------------- | ---------------------------------- | ---------------------------------------------------------------- |
| `capas_entrada`   | Lista de shapefiles                | Capas individuales de cada provincia que se van a unir           |
| `salida`          | Ruta del shapefile combinado       | Capa nacional resultante                                         |
| `ADD_SOURCE_INFO` | Activado                           | Agrega un campo `MERGE_SRC` con el origen de cada entidad        |
| `field_mappings`  | Vacío (usa los campos por defecto) | No se hace fusión personalizada de campos en este ejemplo básico |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://m-moyaconsulting.gitbook.io/gisbook/geoprocesamiento/merge-combinar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
