

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Panel Geomapa
<a name="v9-panels-geomap"></a>

****  
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la **versión 9.x de Grafana**.  
Para ver los espacios de trabajo de Grafana que admiten la versión 12.x de Grafana, consulte. [Trabajando en Grafana versión 12](using-grafana-v12.md)  
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte [Uso de la versión 10 de Grafana](using-grafana-v10.md).  
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte [Uso de la versión 8 de Grafana](using-grafana-v8.md).

La visualización del panel Geomapa le permite ver y personalizar el mapamundi con datos geoespaciales. Puede configurar varios estilos de superposición y ajustes de visualización del mapa para centrarse fácilmente en las características importantes de los datos basadas en la ubicación.

## Vista de mapa
<a name="v9-panels-geomap-view"></a>

La vista de mapa controla la vista inicial del mapa cuando se carga el panel de control.

**Vista inicial**

La vista inicial configura el modo en que se representa el GeoMap panel cuando se carga por primera vez.
+ La **vista** establece el centro del mapa cuando se carga el panel por primera vez.
  + **Ajustar a los datos** ajusta la vista del mapa en función de la extensión de los datos de las capas del mapa y se actualiza cuando los datos cambian.
    + La opción **Datos** permite seleccionar la extensión en función de los datos de “todas las capas”, una sola “capa” o el “último valor” de una capa seleccionada.
    + La **capa** se puede seleccionar si se ajusta a los datos de una sola “capa” o al “último valor” de una capa.
    + **Relleno** establece el relleno en un porcentaje relativo más allá de la extensión de los datos (no está disponible si solo se analiza “Último valor”).
    + **Zoom máximo** establece el nivel de zoom máximo al ajustar los datos.
  + **Coordenadas** establece la vista del mapa en función de:
    + **Latitud**
    + **Longitud**
  + También están disponibles las vistas predeterminadas, que incluyen:
    + **(0°, 0°)**
    + **América del Norte**
    + **América del Sur**
    + **Europa**
    + **África**
    + **Asia occidental**
    + **Sur de Asia**
    + **South-East Asia**
    + **Asia oriental**
    + **Australia**
    + **Oceanía**
+ **Zoom** establece el nivel de zoom inicial.

## Capas de mapa
<a name="v9-panels-geomap-layers"></a>

La visualización de Geomapa permite mostrar varias capas. Cada capa determina cómo se visualizan los datos geoespaciales en la parte superior del mapa base.

**Tipos**

Hay tres tipos de capas de mapa entre los que elegir en la visualización de geomapa.
+ [Capa de marcadores](#v9-panels-geomap-markers) representa un marcador en cada punto de datos.
+ [Capa de mapa de calor](#v9-panels-geomap-heatmap) visualiza un mapa de calor de los datos.
+ [Capa de GeoJSON](#v9-panels-geomap-geojson) representa datos estáticos de un archivo GeoJSON.

También hay cinco tipos de capas que se encuentran actualmente en versión alfa.
+ [Capa noche/día (alfa)](#v9-panels-geomap-nightday) representa una región diurna o nocturna.
+ El **icono en el último punto (alfa)** representa un icono en el último punto de datos.
+ El **GeoJSON dinámico (alpha)** estiliza un archivo GeoJSON en función de los resultados de la consulta.
+ **Ruta (alfa)** representa los puntos de datos como una ruta.
+ [Capa de fotos (alfa)](#v9-panels-geomap-photos) representa una foto en cada punto de datos.

**Controles de capa**

Los controles de capa permiten crear capas, cambiarles el nombre, reordenarlas y eliminarlas.
+ **Agregar capa** crea una capa de datos adicional y configurable para la visualización de geomapa. Al agregar una capa, se le pide que seleccione un tipo de capa. Puede cambiar el tipo de capa en cualquier momento durante la configuración del panel. Consulte la sección **Tipos de capas** anterior para obtener detalles sobre cada tipo de capa.
+ Los controles de capa permiten cambiar el nombre, eliminar y reordenar las capas del panel.
  + **Editar nombre de capa** (icono de lápiz) cambia el nombre de la capa.
  + La **Papelera** elimina la capa.
  + **Reordenar** (seis dots/grab controles) permite cambiar el orden de las capas. Los datos de las capas superiores aparecerán por encima de los datos de las capas inferiores. El panel actualizará el orden de las capas al arrastrar y soltar para facilitar la elección del orden de las capas.

Puede agregar varias capas de datos a un único panel Geomapa para crear visualizaciones ricas y detalladas.

**Ubicación**

El panel Geomapa necesita un origen de datos geográficos. Estos datos provienen de una consulta a una base de datos y hay cuatro opciones de asignaciones para los datos.
+ **Automático** busca los datos de ubicación automáticamente. Utilice esta opción cuando la consulta se base en uno de los siguientes nombres para los campos de datos.
  + geohash: “geohash”
  + latitud: “latitude”, “lat”
  + longitud: “longitude”, “lng”, “lon”
  + búsqueda: “lookup”
+ **Coordenadas** especifica que la consulta contiene datos de coordenadas. Se le solicitará que seleccione campos de datos numéricos para la latitud y la longitud de la consulta de la base de datos.
+ La opción **Geohash** especifica que la consulta contiene datos de geohash. Se le pedirá que seleccione un campo de datos de cadena de caracteres para el geohash de la consulta de la base de datos.
+ La opción **Búsqueda** especifica que la consulta contiene los datos del nombre de la ubicación que deben asignarse a un valor. Se le pedirá que seleccione el campo de búsqueda de la consulta de la base de datos y un nomenclátor (índice de topónimos). El nomenclátor es el directorio que se utiliza para asignar los datos consultados a un punto geográfico.

## Capa de marcadores
<a name="v9-panels-geomap-markers"></a>

La capa de marcadores le permite mostrar los puntos de datos en diferentes formas de marcadores, como círculos, cuadrados, triángulos, estrellas y más.

Los marcadores tienen muchas opciones de personalización.
+ La opción **Color del marcador** configura el color del marcador. El `Single color` predeterminado mantiene todos los puntos de un solo color. Hay una opción alternativa para tener varios colores en función de los valores de los puntos de datos y del umbral establecido en la sección `Thresholds`.
+ La opción **Tamaño del marcador** configura el tamaño del marcador. El valor predeterminado es `Fixed size` y hace que todos los marcadores tengan el mismo tamaño independientemente de los puntos de datos. Sin embargo, también hay una opción para escalar los círculos a los puntos de datos correspondientes. El tamaño del marcador `Min` y `Max` debe configurarse de manera que la capa de marcadores pueda escalarse dentro de este rango.
+ La **Forma del marcador** le permite elegir el símbolo, el icono o el gráfico para ayudar a proporcionar un contexto visual adicional a los datos. Elija entre los recursos que se incluyen con Grafana, como formas simples o la biblioteca Unicon. También puede especificar una URL que contenga un recurso de imagen. La imagen debe ser un gráfico vectorial escalable (SVG).
+ **Opacidad de relleno** configura la transparencia de cada marcador.

## Capa de mapa de calor
<a name="v9-panels-geomap-heatmap"></a>

La capa de mapa de calor agrupa varios puntos de datos para visualizar ubicaciones con diferentes densidades. Adición de una capa de mapa de calor:

Haga clic en el menú desplegable de Capa de datos y seleccione `Heatmap`.

Al igual que con los `Markers`, se le muestran opciones para determinar qué puntos de datos desea visualizar y cómo desea visualizarlos.
+ Los **valores de peso** configuran la intensidad de los clústeres del mapa de calor. El `Fixed value` mantiene un valor de peso constante en todos los puntos de datos. Este valor debe estar en el intervalo comprendido entre 0 y 1. Al igual que con los marcadores, hay una opción alternativa en el menú desplegable para escalar automáticamente los valores de ponderación en función de los valores de los datos.
+ **Radio** configura el tamaño de los clústeres del mapa de calor.
+ **Desenfoque** configura la cantidad de desenfoque en cada clúster.

## Capa de GeoJSON
<a name="v9-panels-geomap-geojson"></a>

La capa GeoJSON le permite seleccionar y cargar un archivo GeoJSON estático desde el sistema de archivos.
+ La **URL de GeoJSON** proporciona una selección de archivos GeoJSON que se incluyen con Grafana.
+ **Estilo predeterminado** controla los estilos que se deben aplicar cuando ninguna de las reglas anteriores coincide.
  + **Color** configura el color del estilo por defecto.
  + **Opacidad** configura la opacidad predeterminada
+ Las **reglas de estilo** aplican estilos en función de las propiedades de las características.
  + **Regla** le permite seleccionar una *característica*, una *condición* y un *valor* del archivo GeoJSON para definir una regla. El icono de la papelera se puede utilizar para eliminar la regla actual.
  + **Color** configura el color del estilo de la regla actual
  + **Opacidad** configura el nivel de transparencia de la regla actual.
+ **Agregar regla de estilo** crea reglas de estilo adicionales.

## Capa de CARTO
<a name="v9-panels-geomap-carto"></a>

La capa de CARTO proviene de mapas base ráster de [CARTO](https://carto.com/about-us/).

**Opciones**
+ **Tema**

   Elija un tema, ya sea **Claro**, **Oscuro** o **Automático.**
+ **Mostrar etiquetas** muestra los detalles del país en la parte superior del mapa.
+ **Opacidad** de 0 (transparente) a 1 (opaco).

## Capa de mosaicos XYZ
<a name="v9-panels-geomap-xyz"></a>

La capa de mosaicos XYZ es un mapa de una capa de mosaicos genérica.

**nota**  
Para obtener más información sobre las capas de mosaicos genéricas, consulte [Tiled Web Maps](https://en.wikipedia.org/wiki/Tiled_web_map) y [List of Open Street Map Tile Servers](https://wiki.openstreetmap.org/wiki/Tile_servers).

**Opciones**
+ **Plantilla de URL**
**nota**  
Establezca una URL de servidor de mosaicos válida, con {z}/{x}/{y}, por ejemplo: `https://tile.openstreetmap.org/{z}/{x}/{y}.png`.
+ **Atribución** establece la cadena de referencia de la capa si se muestra en los [controles del mapa](#v9-panels-geomap-controls)
+ **Opacidad** de 0 (transparente) a 1 (opaco).

## Capa de Open Street Map
<a name="v9-panels-geomap-osm"></a>

Mapa de [Open Street Map](https://www.openstreetmap.org/about), una base de datos geográfica mundial gratuita y colaborativa.

**Opciones**
+ **Opacidad** de 0 (transparente) a 1 (opaco).

## Capa de ArcGIS
<a name="v9-panels-geomap-arcgis"></a>

Una capa de [ArcGIS](https://services.arcgisonline.com/arcgis/rest/services) es una capa de un ArcGIS de [ESRI](https://www.esri.com/en-us/about/about-esri/overview). MapServer

**Opciones**
+ **Instancia del servidor** para seleccionar entre los siguientes tipos de mapas.
  + Callejero mundial
  + Imágenes del mundo
  + Mundo físico
  + Topográfico
  + Topográfico de EE. UU.
  + Océano mundial
  + Personalizada MapServer (consulte [XYZ](#v9-panels-geomap-xyz) para obtener información sobre el formato)
    + Plantilla de URL
    + Atribución
+ **Opacidad** de 0 (transparente) a 1 (opaco).

## Capa noche/día (alfa)
<a name="v9-panels-geomap-nightday"></a>

La capa noche/día muestra las regiones diurnas y nocturnas en función del intervalo de tiempo actual.

**nota**  
Para obtener más información, consulte [Extensiones para OpenLayers - DayNight](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html).

**Opciones**
+ **Mostrar** alterna el origen horario del intervalo de tiempo del panel.
+ **Color de la región nocturna** selecciona el color de la región nocturna.
+ **Mostrar sol** cambia el icono del sol.
+ **Opacidad** de 0 (transparente) a 1 (opaco).

## Capa de fotos (alfa)
<a name="v9-panels-geomap-photos"></a>

La capa de fotos renderiza una fotografía en cada punto de datos.

**nota**  
Para obtener más información, consulte [Extensiones para OpenLayers - Image Photo Style](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html).

**Opciones**
+ **Campo de origen de la imagen**

  Seleccione un campo de cadena que contenga los datos de la imagen en uno de los siguientes formatos:
  + **URL de la imagen**
  + Imagen binaria **codificada en Base64** (`data:image/png;base64,…`)
+ **Tipo**

   Seleccione el estilo de marco alrededor de las imágenes.
  + **Square (Cuadrado)**
  + **Circle (Círculo)**
  + **Anclado**
  + **Folio**
+ **Recortar** alterna si las imágenes se recortan para que quepan.
+ **Sombra** alterna la sombra de un cuadro detrás de las imágenes.
+ **Borde** establece el tamaño del borde alrededor de las imágenes.
+ **Color del borde** establece el color del borde alrededor de las imágenes.
+ **Radio** establece el tamaño total de las imágenes en píxeles.

## Controles del mapa
<a name="v9-panels-geomap-controls"></a>

La interfaz de controles del mapa contiene las siguientes opciones de información del mapa y superposiciones de herramientas.

**Zoom**

En esta sección se describe cada uno de los controles de zoom.

*Mostrar control del zoom*

Muestra los controles de zoom en la esquina superior izquierda.

*Zoom con la rueda del ratón*

Se activa o desactiva con la rueda del ratón para acercar o alejar el zoom.

**Mostrar atribución**

Muestra la atribución de las capas del mapa base del mapa.

**Mostrar escala**

Muestra la información de la escala en la esquina inferior izquierda.

**nota**  
Muestra las unidades en [m]/[km].

**Mostrar las herramientas de medición**

Muestra las herramientas de medición en la esquina superior derecha. Las medidas aparecen solo cuando este control está abierto.
+ **Haga clic** para empezar a medir.
+ **Siga haciendo clic** para continuar con la medición
+ **Double-click**para finalizar la medición

**nota**  
Al cambiar el tipo o las unidades de medida, la medida anterior se elimina del mapa.  
Si el control se cierra y, a continuación, se vuelve a abrir, se muestra la medida más reciente.  
Para modificar una medida, haga clic y arrastre sobre ella.

*Longitud*

Obtenga la longitud esférica de una geometría. Esta longitud es la suma de las distancias entre las coordenadas de los grandes círculos. Para geometrías de varias partes, la longitud es la suma de la longitud de cada parte. Se supone que las geometrías están en ''. EPSG:3857

Puede elegir las siguientes unidades para las medidas de longitud:
+ **Métrica () m/km**
+ **Pies (ft)**
+ **Millas (mi)**
+ **Millas náuticas (nmi)**

*Área*

Obtenga el área esférica de una geometría. Esta área se calcula suponiendo que las aristas de los polígonos son segmentos de grandes círculos de una esfera. Se supone que las geometrías están en ''. EPSG:3857

Puede elegir las siguientes unidades para las medidas de área:
+ **Metros cuadrados (m²)**
+ **Kilómetros cuadrados (km²)**
+ **Pies cuadrados (ft²)**
+ **Millas cuadradas (mi²)**
+ **Acres (acre)**
+ **Hectárea (ha)**

**Mostrar depuración**

Muestra la información de depuración en la esquina superior derecha del mapa. Esto es útil para depurar o validar un origen de datos.
+ **Zoom** muestra el nivel de zoom actual del mapa.
+ **Centro** muestra la **longitud** y la **latitud** actuales del centro del mapa.

**Ayuda contextual**
+ **Ninguno** muestra información sobre herramientas solo cuando se hace clic en un punto de datos.
+ **Detalles** muestra información sobre herramientas cuando el puntero pasa el ratón sobre un punto de datos.