Aplicar estilo a una capa con Arcade
Creará una expresión de Arcade y la utilizará para aplicar estilo a una capa en su mapa. La expresión de Arcade calculará el consumo eléctrico anual per cápita. Comenzará por el consumo eléctrico anual de cada país y lo dividirá por la población total del país. Este cálculo es importante para una comparación significativa del consumo eléctrico, dado el amplio rango de recuentos de población entre los países de todo el mundo. A continuación, aplicará estilo a la capa World Countries utilizando los valores resultantes de consumo eléctrico anual per cápita.
En primer lugar, agregará las capas al mapa y elegirá otro mapa base.
Agregar capas y cambiar el mapa base
Creará un nuevo mapa en Visor de mapas. A continuación, agregará dos capas, Global Power Plants y World Countries Electricity Consumption, al nuevo mapa y cambiará el mapa base.
Nota:
Visor de mapas es la herramienta de creación de mapas de última generación de ArcGIS Online. Su objetivo es inspirar la experimentación y la creatividad, a la vez que proporciona una experiencia mejorada para flujos de trabajo clave de creación de mapas.
- Inicie sesión en su cuenta de la organización de ArcGIS.
Nota:
Si no tiene una cuenta de organización, consulte las opciones de acceso a software.
- En la cinta, haga clic en Mapa.
Nota:
En función de su configuración de usuario y de su organización, puede haber abierto Map Viewer Classic. ArcGIS Online ofrece dos map viewers para visualizar, utilizar y crear mapas. Para obtener más información sobre los visores de mapas disponibles y cuál usar, consulte estas Preguntas frecuentes.
Este tutorial utiliza Visor de mapas.
- En caso necesario, en la ventana emergente, haga clic en Abrir en Map Viewer o, en la cinta, haga clic en Abrir en Map Viewer.
Se abre Visor de mapas.
Ahora agregará la primera capa, Global Power Plants, al mapa.
- En el panel Capas, haga clic en Agregar.
- Haga clic en Mi contenido y seleccione ArcGIS Online.
- En la barra de búsqueda, escriba global power plants owner:Learn_ArcGIS.
La capa Global Power Plants aparece en los resultados de búsqueda.
- En el resultado de búsqueda de Global Power Plants, haga clic en el botón Agregar.
Aparece la capa en el mapa.
La capa es un inventario completo de centrales eléctricas de todo el mundo, simbolizadas por tipo de electricidad. Ahora agregará la segunda capa que usará en este flujo de trabajo.
- En la barra de búsqueda, copie y pegue el texto siguiente: electricity consumption owner:Learn_ArcGIS.
- En el resultado de búsqueda de World Countries Electricity Consumption, haga clic en Agregar.
Aparece la capa en el mapa.
La capa contiene información de población y consumo eléctrico de todos los países del mundo.
La capa se dibuja encima de la capa Global Power Plants cubriéndola parcialmente, por lo que cambiará el orden de las capas.
- En el panel Agregar capa, haga clic en el botón Atrás para volver al panel Capas.
- En el panel Capas, arrastre la capa World Countries Electricity Consumption debajo de la capa Global Power Plants.
Las entidades de centrales eléctricas ahora están visibles sobre la capa de países.
En ciertos países del mundo, existen muchas centrales eléctricas próximas entre sí. Para visualizar mejor la distribución de las centrales eléctricas, habilitará el clustering en la capa.
- En el panel Capas, haga clic en la capa Global Power Plants para seleccionarla.
- En la barra de herramientas Configuración (clara), haga clic en Agregación .
- En el panel Agregación, active Habilitar agregación.
Clustering está habilitado de forma predeterminada.
- En Clustering, haga clic en Opciones.
Aparece el panel Clustering.
- En el panel Clustering, en Radio de clúster, arrastre el control deslizante más cercano a Bajo. En Rango de tamaño, arrastre el control deslizante derecho hacia la izquierda.
La capa de centrales eléctricas está ahora simbolizada con clústeres. A medida que se acerca y se aleja, los clústeres se reconfiguran para adaptarse a la escala actual. Cada clúster está etiquetado con el número de centrales eléctricas que representa.
Ahora elegirá otro mapa base para que las entidades de centrales eléctricas destaquen mejor en el mapa. Dado que los puntos de esta capa se representan con símbolos brillantes, puede crear un contraste colocándolos sobre un mapa base oscuro y neutro.
- Haga clic de nuevo y cierre el panel Agregación.
- En la barra de herramientas Contenido (oscura), haga clic en Mapa base. En el panel Mapa base, elija Lona gris oscuro.
El mapa base se actualiza en el mapa.
- Cierre el panel Mapa base.
Ahora contraerá la barra de herramientas Contenido para poder ver más en el mapa.
- En la parte inferior de la barra de herramientas Contenido, haga clic en Contraer.
A continuación, guardará el mapa.
- En la barra de herramientas Contenido contraída, haga clic en Guardar y abrir y seleccione Guardar como..
- En la ventana Guardar mapa, introduzca la siguiente información:
- En Título, escriba Generación y consumo de energía globales, seguido de sus iniciales.
- En Etiquetas, escriba consumo eléctrico, centrales eléctricas y pulse Intro después de cada etiqueta.
- En Resumen, escriba Este mapa muestra las centrales eléctricas de todo el mundo, clasificadas por tipo de electricidad.
- Haga clic en Guardar.
Explorar los datos y el editor de expresiones de Arcade
A continuación, explorará el editor de expresiones de Arcade y lo utilizará para aplicar estilo a la capa World Countries Electricity Consumption. Su objetivo es poder comparar fácilmente el consumo eléctrico anual de cada país. Para ello, creará una expresión de Arcade que devuelva el consumo eléctrico anual per cápita dividiendo el consumo eléctrico anual (en kilovatios hora) entre la población total. De este modo, se podrá obtener una comparación significativa del consumo eléctrico entre países con recuentos de población muy diferentes.
Nota:
Este tipo de cálculo se denomina normalización: para cada país, normalizará el consumo de electricidad por la población total.
Antes de empezar a crear su expresión de Arcade, examinará la tabla de atributos de la capa.
- En la barra de herramientas Contenido, haga clic en el botón Capas.
- En el panel Capas, en la capa World Countries Electricity Consumption, haga clic en el botón Opciones y haga clic en Mostrar tabla.
Se abre la tabla de atributos.
Nota:
Para disponer de más espacio en pantalla, puede cerrar el panel Propiedades.
La tabla incluye el campo COUNTRY, donde aparecen los nombres de los países; un campo Annual Electricity Consumption, con valores en kilovatios hora (kWh); y un campo Pop, que contiene la población total de cada país. Estos son los atributos que utilizará en la expresión de Arcade.
Nota:
Los kilovatios hora son una medida común del consumo eléctrico en un periodo de tiempo. Si observa con detenimiento su factura mensual de la luz, es probable que su consumo se muestre en kilovatios hora.
Ahora se familiarizará con Arcade. Se trata de un lenguaje de expresión portátil, ligero y seguro escrito para su uso en ArcGIS. Al igual que otros lenguajes de expresión, es capaz de realizar operaciones matemáticas, manipular texto y evaluar sentencias lógicas. Arcade se diseñó específicamente para crear visualizaciones y etiquetas personalizadas al vuelo en ArcGIS. Permite a los usuarios manipular datos existentes y obtener nuevas perspectivas mediante la creación, el uso compartido y la ejecución de expresiones personalizadas en ArcGIS Pro, ArcGIS Runtime, ArcGIS Online, ArcGIS Enterprise y ArcGIS API for JavaScript.
En Visor de mapas, Arcade resulta útil al trabajar con datos en ventanas emergentes y etiquetas, y al aplicar estilos a una capa. Puede crear y aplicar expresiones de Arcade utilizando el editor de expresiones de Arcade. Ahora abrirá y explorará el editor de expresiones. Dado que su objetivo es aplicar estilo a la capa World Countries Electricity Consumption, abrirá el editor de expresiones mediante el panel Estilos de esa capa.
- En el panel Capas, asegúrese de que la capa World Countries Electricity Consumption esté seleccionada y, en la barra de herramientas Configuración, haga clic en Estilos.
- En el panel Estilos, en Elegir atributos, haga clic en Expresión.
Aparece la ventana del editor de expresiones de Arcade.
- Haga clic en el icono de expansión para ver las pestañas laterales.
Revise las distintas secciones de la ventana del editor. La ventana de expresión es donde se crea la expresión. Las pestañas Variables de perfil y Funciones son donde se encuentran los elementos que utilizará en la expresión. La pestaña Ayuda abre la página de ayuda de Arcade.
- Revise la pestaña Variables de perfil.
En esta pestaña se ofrece una lista de variables predefinidas, incluidos campos de atributos y geometría para las entidades de la capa.
- Haga clic en la pestaña Funciones.
En esta pestaña, se muestra una lista de todas las funciones de Arcade. Puede hacer clic en el botón de información situado a la derecha de cada función para acceder a la ayuda integrada de la función sobre parámetros, sintaxis y uso.
- Haga clic en la pestaña Ayuda.
Esta pestaña enlaza a la Arcade de Arcade.
- Haga clic en el botón Ejecutar.
Las pestañas Salida, Consola y Registro aparecen con el resultado Nulo. Una vez que haya creado la expresión, puede utilizar el botón Ejecutar para probar la salida de la expresión. Por ahora, no ha escrito ningún código de Arcade, por lo que las pestañas Salida y Registro no contienen mucha información.
Crear una expresión de Arcade para el consumo eléctrico per cápita
Ahora empezará a crear su expresión de Arcade para aplicar estilo a la capa World Countries Electricity Consumption. Primero definirá una variable para acceder al campo de atributo Annual Electricity Consumption (KwH).
- En la ventana de expresión, en la fila 1, escriba (o copie y pegue) var annualConsumptionKwh = .
AnnualConsumptionKwh es el nombre de la nueva variable. Al utilizar var <variableName>, las variables se inicializan en la memoria para utilizarlas más tarde en la expresión. Especificará el valor de la variable en el siguiente paso.
- Haga clic en la pestaña Variables de perfiles. En el panel Variables de perfiles, haga clic en la flecha situada junto a $feature.
- En Valores, haga clic en la variable $feature.Annual_Electricity_Consumption_.
La cadena de caracteres se copia en la ventana de expresión, con lo que se completa su primera línea de código.
Nota:
Anual_Electricidad_Consumption_ es el nombre del atributo, mientras que Annual Electricity Consumption es el alias, una forma más fácil de hacer referencia al atributo.
- En la ventana de expresión, pulse Intro para iniciar la siguiente línea de la expresión.
Cualquier referencia adicional a la variable annualConsumptionKwh accederá al valor del atributo Annual Electricity Consumption (KwH) por cada entidad de la capa (en este caso, todos los países del mundo).
Ahora probará la primera línea de su expresión. Una forma cómoda de probar una variable es solicitar a Arcade que devuelva su valor. Puede hacerlo usando una instrucción return.
- En la ventana Expresión, escriba return annualConsumptionKwh y pulse Intro.
- Haga clic en el botón Ejecutar.
En la pestaña Salida, aparece el valor 157200000 y Número es el tipo de datos.
Nota:
Para que sea más fácil probar las expresiones, el editor de expresiones de Arcade utiliza la primera entidad de la capa (ordenadas por Id. de objeto) para rellenar los atributos con valores de muestra. La primera entidad de la capa World Countries Electricity Consumption es Samoa Americana, con un consumo eléctrico anual de 157.200.000 kWh y una población de 46.366.
El resultado devuelto para su expresión es, efectivamente, el valor del consumo eléctrico anual de Samoa Americana: 157.200.000 (kWh). Este es el valor esperado, por lo que el código funciona de la forma prevista.
A continuación, definirá una variable para acceder al campo de población.
- En la ventana de expresión, al final de la primera línea de código, pulse Intro para agregar una nueva línea. Introduzca var population =.
- Si es necesario, en la pestaña Variables de perfil, haga clic en la flecha situada junto a la pestaña $feature. En Valores, seleccione $feature.POP para agregar el valor del atributo de población a la expresión.
Ahora usará la instrucción return para probar esta nueva variable.
- En la línea return, reemplace annualConsumptionKwh por population.
Nota:
El atributo anterior utilizaba la notación ["field"] porque contenía guiones bajos. El campo POP no contiene guiones bajos, de modo que Arcade usa una notación más simple. Una ventaja de agregar un atributo mediante la pestaña Variables de perfil en lugar de escribirlo es que elige el formato correcto por usted. También evita errores ortográficos.
- Haga clic en Ejecutar.
La Salida es 46366, que es, en efecto, el valor de población de Samoa Americana. Su código se sigue comportando de la forma prevista.
El siguiente paso es calcular el consumo eléctrico per cápita. Para ello, utilizará los valores almacenados en las dos variables y dividirá el consumo eléctrico anual entre la población. Almacenará el resultado en una tercera variable llamada consumptionPerCapita.
- En la ventana de expresión, pulse Intro para agregar una nueva línea antes de la línea return population. Escriba var consumptionPerCapita = annualConsumptionKwh / population.
- En la línea return, reemplace population por consumptionPerCapita.
- Haga clic en Ejecutar.
La Salida es 3390,415390587931, que, efectivamente, es el resultado de 157.200.000 dividido por 46.366.
Para probar una mayor variedad de casos, puede reasignar la variable population con un número literal.
- En la ventana de expresión, pulse Intro para agregar una nueva línea tras la línea var population = $feature.POP. Escriba population = 40000.
- Haga clic en Ejecutar.
El resultado se actualiza a 3930, que es el resultado de 157.200.000 dividido por 40.000.
- Del mismo modo, puede probar su expresión con distintos valores para los campos de consumo eléctrico anual y población.
- Elimine la línea de código population = 40000.
Nota:
La instrucción return no se utiliza solo para pruebas; es el modo en que el resultado final de la expresión se pondrá a disposición para usarlo en el mapa. Por ejemplo, ahora que el resultado final se devuelve en su expresión, podrá usarlo para aplicar estilo a la capa de países.
A continuación, se muestra la expresión final.
// Set variables var annualConsumptionKwh = $feature["Annual_Electricity_Consumption_"] var population = $feature.POP // Calculate the electricity consumption per capita var consumptionPerCapita = annualConsumptionKwh / population // Return the consumption per capita return consumptionPerCapitaPara que su código sea más legible, se han agregado comentarios.
Nota:
Para que su código sea más legible y fácil de mantener en el futuro, es una buena idea agregar comentarios, designados por // al inicio de la línea. Arcade ignora los comentarios y solo están pensados para las personas que leerán el código.
Ahora asignará un nombre a la expresión. Es importante asignar un nombre significativo a la expresión, ya que, en esencia, funcionará como el nombre de un nuevo campo de la capa. Se utilizará en la leyenda del mapa y también ayudará a identificar la expresión más adelante, cuando haga referencia a ella o necesite editarla.
- Haga clic en el botón Editar situado junto a Nueva expresión.
Nota:
También puede hacer clic en la expresión directamente para editar el título.
- En el cuadro de texto Nueva expresión, escriba Consumo eléctrico per cápita (kWh) y haga clic fuera del cuadro de texto.
- Haga clic en Hecho.
Se cierra la ventana del editor de Arcade y la expresión se agrega a la lista de atributos que se pueden utilizar para aplicar estilo a la capa World Countries Electricity Consumption.
- En la barra de herramientas Contenido, haga clic en Guardar y abrir y elija Guardar.
Al guardar el mapa se guardará lo que haya realizado en el mapa, incluidas las expresiones que haya creado.
Aplicar estilo a la capa
Ahora ya puede aplicar estilo a la capa World Countries Electricity Consumption con la expresión de Arcade que acaba de crear.
- En el panel Estilos, revise la configuración actual.
En el panel Estilos, la nueva expresión, Consumo eléctrico per cápita (kWh) se aplicó automáticamente para simbolizar la capa World Countries Electricity Consumption. De forma predeterminada, el estilo de dibujo es Recuentos y cantidades (color), que es como acabará estilizando la capa. Sin embargo, cambiará el estilo a Recuentos y cantidades (tamaño) para ver la diferencia.
- En Elegir un estilo, haga clic en Recuentos y cantidades (tamaño)
Dado que resulta difícil ver la capa, desactivará temporalmente la capa Global Power Plants.
- En el panel Capas, en Global Power Plants, haga clic en el botón de visibilidad para desactivar la capa.
El consumo eléctrico per cápita de cada país se representa por puntos de diferentes tamaños.
Nota:
Como cada país tiene diferentes valores de campo de consumo eléctrico y población totales, el resultado per cápita es diferente para cada uno, aunque la expresión de Arcade sea la misma. Esto es lo que hace que Arcade sea tan potente; puede observar los valores de campo de entidades específicas para devolver nuevos valores para cada una de ellas al vuelo. Otra característica de Arcade que se demuestra aquí es que no necesita tener la propiedad de las capas de datos originales para generar nueva información derivada.
Para ver mejor la capa de países junto con la capa de centrales eléctricas, usará otra simbolización.
- En el panel Estilos, elija el estilo de dibujo Recuentos y cantidades (color).
Se selecciona automáticamente para el estilo Recuentos y cantidades una rampa de color intuitiva y apta para daltonismo que es adecuada para fondos oscuros. Los países con un bajo consumo eléctrico per cápita aparecen en azul oscuro y los que tienen un alto consumo eléctrico per cápita aparecen en azul turquesa intenso.
Nota:
Si el fondo del mapa es oscuro, los valores más bajos se muestran en un color más oscuro y los valores más altos se muestran con un valor más claro o brillante. De este modo, se logra destacar las cifras más elevadas.
- Haga clic en Hecho para cerrar el panel Estilos.
- En el panel Capas, vuelva a activar la capa Global Power Plants.
Con el nuevo estilo, ahora es posible visualizar ambas capas al mismo tiempo.
Deshabilitará las ventanas emergentes informativas de la capa de países para que los usuarios puedan seleccionar fácilmente las entidades de centrales eléctricas.
- En el panel Capas, asegúrese de que la capa World Countries Electricity Consumption esté seleccionada y, en la barra de herramientas Configuración, haga clic en Elementos emergentes.
- En el panel Elementos emergentes, desactive la opción Habilitar elementos emergentes y cierre el panel Elementos emergentes.
- Guarde el mapa.
Ahora, su mapa tiene un estilo visualmente intuitivo que muestra patrones en el consumo eléctrico per cápita y la producción de energía en todo el mundo.
- Examine el contenido del mapa.
Puede comparar su país con otros de un vistazo. Existe un mayor consumo eléctrico per cápita en los países altamente industrializados de Europa occidental y Norteamérica, así como en los principales Estados del Golfo que producen electricidad. Puede ver que los países con mayor consumo eléctrico per cápita tienden a tener una mayor concentración de centrales eléctricas, lo cual resulta lógico. En los países en desarrollo, hay menos centrales eléctricas y un menor consumo eléctrico per cápita.
Ha creado un mapa y visualizado centrales eléctricas con una simbolización en clúster. A continuación, ha usado una expresión de Arcade para visualizar el consumo eléctrico anual per cápita en todo el mundo.
Configurar una ventana emergente con Arcade
Anteriormente, se familiarizó con Arcade y utilizó una expresión de Arcade para simbolizar la capa World Countries. A continuación, utilizará una expresión de Arcade para mostrar los datos de la capa de centrales eléctricas en una ventana emergente informativa. Esto le permitirá comprender mejor la producción de electricidad de las centrales eléctricas.
Explorar los atributos y ventanas emergentes de Global Power Plants
En primer lugar, explorará los atributos de Global Power Plants y examinará las ventanas emergentes de la capa.
En la capa Global Power Plants, hay un atributo que indica la generación de energía anual estimada de cada central eléctrica, expresada en gigavatios hora (gWh). El nombre de ese atributo es estimated_generation_gwh. Aunque le resulta útil, le gustaría expresar el valor de generación eléctrica como algo más fácil de entender para el público general: el número de bombillas de 60 vatios que la central eléctrica podría alimentar durante un año. Utilizará una expresión de Arcade para realizar esa conversión y mostrará el nuevo valor en una frase en la ventana emergente de la capa. Dado que algunas de las centrales eléctricas carecen de un valor para el atributo estimated_generation_gwh, también deberá administrar esos valores ausentes en la expresión de Arcade.
Primero, examinará la tabla de atributos de la capa de centrales eléctricas.
- Si es necesario, inicie sesión en ArcGIS Online. En la barra de herramientas, haga clic en Contenido y busque el mapa Generación y consumo de energía globales que creó en el módulo 1.
- Haga clic en el menú de opciones situado junto al mapa web Generación y consumo de energía globales y elija Abrir en Map Viewer.
- En el panel Capas, en la capa Global Power Plants, haga clic en el botón Opciones y elija Mostrar tabla.
- En la tabla de atributos de Global Power Plants, examine los campos. Use la barra de desplazamiento horizontal para ver todos los campos.
Entre los diversos atributos de la capa, observe lo siguiente:
- El campo country_long indica el nombre del país en el que se encuentra la central eléctrica.
- El campo name contiene el nombre de la central eléctrica.
- El campo fuel indica el tipo de central eléctrica.
Nota:
Es posible que tenga que ensanchar la columna para ver todo el alias del campo de atributo.
- Desplácese a la última columna de la tabla, estimated_generation_gwh.
Tal como se ha mencionado, este campo contiene la generación eléctrica anual estimada de la planta eléctrica, expresada en gigavatios hora (gWh). Un gigavatio hora es un millón de veces la electricidad de un kilovatio hora.
- Cierre la tabla de atributos Global Power Plants.
A continuación, explorará las ventanas emergentes de la capa.
- En el mapa, acérquese a un área de interés.
Nota:
Dado que ha habilitado el clustering en la capa Global Power Plants, deberá hacer zoom en el mapa hasta que los clústeres se disuelvan en entidades individuales para poder ver el elemento emergente de la entidad individual.
- En el mapa, seleccione una entidad de Global Power Plants para ver la ventana emergente original de la capa.
La ventana emergente ya muestra información útil, como el tipo de central eléctrica y su capacidad. Complementará la ventana emergente con una información adicional: la generación anual de energía de la central eléctrica.
Convertir unidades de generación de energía con Arcade
Ahora abrirá la ventana del editor de expresiones de Arcade para crear la nueva expresión. Como su objetivo es personalizar el elemento emergente, abrirá el editor de expresiones mediante el panel de configuración Elementos emergentes.
- En el panel Capas, asegúrese de que la capa Global Power Plants esté seleccionada.
- En la barra de herramientas Configuración (clara), si es necesario, haga clic en Elementos emergentes. En el panel Elementos emergentes, haga clic en Expresiones de atributos.
Ahora creará la nueva expresión de Arcade.
- Haga clic en Agregar expresión para abrir la ventana del editor de expresiones de Arcade.
Aparece la ventana del editor.
Nota:
La capa Global Power Plants ya tiene una expresión existente, Pop-up color. Se utiliza para generar los colores de simbolización en función del tipo de combustible.
Asignará un nombre a su expresión.
- Edite el título de la expresión para que sea Generación anual estimada en bombillas.
Ahora empezará a crear su expresión de Arcade. Primero, creará una variable, yearLightbulbPower, que contiene el número de kilovatios hora de electricidad necesarios para alimentar una bombilla de 60 vatios durante un año.
Una bombilla incandescente de 60 vatios consume 60 vatios hora o 0,06 kilovatios hora de electricidad por cada hora que está encendida. Para hallar los kilovatios hora de electricidad necesarios para alimentar una bombilla de 60 vatios durante un año, multiplicará 0,06 kilovatios hora por 24 horas y, después, por 365 días.
- En la primera línea de la ventana Expresión, escriba (o copie y pegue) var yearLightbulbPower = 0.06 * 24 * 365.
A continuación, agregará una instrucción return para probar la variable.
- Pulse Intro y agregue return yearLightbulbPower.
A continuación, ejecutará el código.
- Haga clic en el botón Ejecutar.
En la pestaña Salida, el valor es 525.6. Efectivamente, es el resultado de la operación 0,06 * 24 * 365, por lo que su código funciona de la forma prevista.
A continuación, creará una variable que contenga el nombre de la central eléctrica, utilizando el campo name de la capa Global Power Plant.
- En la ventana de expresión, agregue una línea nueva antes de la instrucción return y escriba var plantName =.
- En la pestaña Variables de perfil, haga clic en la flecha situada junto a $feature.
Aparece la lista de atributos de la capa de centrales eléctricas.
Nota:
La pestaña Variables de perfil tiene un aspecto algo diferente de cuando configuró la simbología para la capa de países del mundo en el módulo anterior. Se debe a que los elementos emergentes permiten utilizar variables de perfil adicionales, como FeatureSets.
- En la lista de valores, desplácese hacia abajo y haga clic en $feature.name para completar su línea de código.
- En la instrucción return, reemplace yearLightbulbPower por plantName para probar su segunda variable.
- Haga clic en el botón Ejecutar.
En la tabla Salida, el valor es Kajaki Hydroelectric Power Plant Afghanistan. Es el nombre de la primera central eléctrica que aparece en la tabla de atributos, a la que se ha designado de forma predeterminada como dato de muestra.
En el siguiente paso, creará una variable, annualGenerationGwh, que contendrá el valor del atributo de generación de electricidad anual.
- En la ventana de expresión, agregue una línea nueva antes de la instrucción return y escriba var annualGenerationGwh =.
- En el panel Variables de perfil, haga clic en $feature.estimated_generate_gwh.
- En la instrucción return, reemplace plantName por annualGenerationGwh para probar la última variable.
- Haga clic en el botón Ejecutar.
En la pestaña Salida, parece que no hay ningún valor y se muestra como Nulo. No es el resultado esperado, así que lo investigará más a fondo.
Comprobará si el valor de muestra actual para ese atributo está vacío o no. La función de Arcade para probar si una variable está vacía o no es IsEmpty. La función IsEmtpy devuelve true si el valor proporcionado es nulo o un texto vacío (por ejemplo, ''). Devuelve false en todos los demás casos, incluidas matrices vacías y diccionarios.
- En la ventana de expresión, para var annualGenerationGwh = $feature["estimated_generation_gwh"], reemplace $feature["estimated_generation_gwh"] por IsEmpty($feature["estimated_generate_gwh"]).
- Haga clic en Ejecutar.
En la pestaña Salida, el valor se muestra en Booleano y es True.
Esto indica que Kajaki Hydroelectric Power Plant Afghanistan no tiene ningún valor para el atributo estimated_generation_gwh. Por lo tanto, la prueba produjo anteriormente un vacío o resultado.
Nota:
Deberá ocuparse de esos casos especiales en los que faltan datos en su expresión de Arcade. Sin embargo, lo hará más adelante en el tutorial. Por ahora, completará el código para los casos normales en los que el valor del atributo está presente.
Para seguir desarrollando su expresión de Arcade, configurará manualmente un valor de muestra de 10 gWh.
- En la ventana de expresión, para var annualGenerationGwh = IsEmpty($feature["estimated_generation_gwh"]), elimine la función IsEmpty y los paréntesis inicial y final.
La expresión vuelve al formato anterior.
- Pulse Intro para agregar una nueva línea después de la línea var annualGenerationGwh = $feature["estimated_generation_gwh"]. Escriba annualGenerationGwh = 10.
- Haga clic en el botón Ejecutar otra vez.
En la pestaña Salida , el valor es ahora 10 como se esperaba y el tipo de datos es Número.
A continuación, en su código de Arcade, quiere calcular la generación anual de electricidad en bombillas de 60 vatios en función del valor de la variable annualGenerationGwh. El primer paso consiste en convertir el valor de kilovatios hora (kWh) a gigavatios hora (gWh) y poner el resultado en una nueva variable. Hay un millón de kWh en un gWh, por lo que debe multiplicar la variable annualGenerationGwh por un millón para convertirla a kWh.
- Agregue una línea nueva justo encima de la instrucción return y escriba var annualGenerationKwh = annualGenerationGwh * 1000000.
- En la instrucción return, reemplace annualGenerationGwh por annualGenerationKwh.
- Haga clic en Ejecutar para evaluar la expresión.
El resultado es 10.000.000, que es el resultado esperado, ya que el valor de muestra es 10.
En esta sección, ha empezado a desarrollar su segunda expresión de Arcade. Ha definido varias variables y ha convertido el valor de generación de electricidad anual de gWh a kWh.
Realizar cálculos y formatear texto con Arcade
Ahora realizará los cálculos principales en su expresión de Arcade. A continuación, formateará el resultado para mostrarlo como texto.
En primer lugar, calculará el número de bombillas de 60 vatios que la central podría alimentar durante un año dividiendo la generación anual de electricidad en kWh (annualGenerationKwh) entre el número de kWh necesario para alimentar una bombilla de 60 vatios durante un año (yearLightbulbPower).
Nota:
Recuerde que la variable yearLightbulbPower contiene el resultado de 0,06 * 24 * 365, que es 525,6.
- Agregue una línea nueva justo encima de la instrucción return y escriba var annualGenInLightbulbs = annualGenerationKwh / yearLightbulbPower.
- En la instrucción return, reemplace annualGenerationKwh por annualGenInLightbulbs.
- Haga clic en Ejecutar para evaluar la expresión.
El valor de Resultado es 19025,87519025875, que es el resultado esperado de 10.000.000 / 525,6. Son alrededor de 19.025,87 bombillas.
Sin embargo, resulta más lógico devolver el número de bombillas como un número entero en lugar de un decimal. Arcade puede ayudarle a hacerlo con la función Round.
- Agregue una línea nueva justo encima de la instrucción return y escriba var annualGenInLightbulbsRounded = .
Ahora buscará la función Round en la pestaña Funciones.
- Haga clic en la pestaña Funciones. En el campo de texto de búsqueda, escriba round.
Aparece la función Round.
- Haga clic en la función Round para insertarla en la ventana de expresión.
La función Round se agrega a la expresión con un parámetro de marcador de posición indicado en el paréntesis.
Revisará la información sobre la función en la ayuda integrada en la aplicación para comprender mejor qué parámetros se esperan.
- En la pestaña Funciones, haga clic en la flecha situada junto a la función Round.
- Revise la información de la función Round.
El primer parámetro es el número que se redondeará; en su caso, la variable annualGenInLightbulbs. El segundo parámetro indica el número de posiciones decimales al que se redondeará el número. Mantendrá el valor predeterminado 0, de modo que 19025.87519025875 debería redondearse a 19026, con 0 decimales después del punto.
- Cuando haya terminado de revisar la información sobre la función Round, haga clic en la flecha situada junto a Funciones para salir de la ayuda integrada en la aplicación.
- Modifique la línea annualGenInLightbulbsRounded para que quede como sigue:
var annualGenInLightbulbsRounded = Round(annualGenInLightbulbs, 0)
Nota:
Los parámetros de una función siempre deben aparecer entre paréntesis y estar separados por una coma.
- En la instrucción return, reemplace annualGenInLightbulbs por annualGenInLightbulbsRounded.
- Haga clic en Ejecutar para evaluar la expresión.
El resultado es 19026, como se esperaba. Son 19.026 bombillas.
Ha calculado correctamente el número de bombillas de 60 vatios a las que cada central eléctrica podría suministrar electricidad en un año. Sin embargo, aún no ha terminado. A continuación, formateará el número para que sea legible y creará una frase para poner el número en contexto.
Al igual que otros lenguajes de programación, Arcade tiene un método para convertir un número en texto. Esta función se denomina Text. Creará una nueva variable para que contenga el número de bombillas en forma de texto.
- Agregue una línea nueva justo encima de la instrucción return y escriba var annualGenInLightbulbsText =.
Ahora buscará la función Text en la pestaña Funciones.
- En la pestaña Funciones, busque text. En la lista Funciones de texto, haga clic en la función Texto para insertarla en la ventana de expresión.
La nueva línea tiene este aspecto:
var annualGenInLightbulbsText = Text(value)
Revisará la información sobre esta función en la ayuda integrada en la aplicación para comprender mejor qué parámetros se esperan.
- En la pestaña Funciones, haga clic en la flecha situada junto a la función Text.
El primer parámetro es el número que se transformará en texto; en su caso, la variable annualGenInLightbulbsRounded. El segundo parámetro es una plantilla que expresa el formato deseado. Por ejemplo, la plantilla predeterminada '#,###' agregará un punto de separador de miles, ya que la coma pasa a punto en la versión en español. Significa que un número escrito como 9563 pasará a ser 9.563.
- Cuando haya terminado de revisar la información, haga clic en flecha atrás para salir de la ayuda integrada en la aplicación.
- Modifique la línea annualGenInLightbulbsText para que quede como sigue:
var annualGenInLightbulbsText = Text(annualGenInLightbulbsRounded, '###,###,###,###')
Nota:
La plantilla '###,###,###,###' agregará separadores para números mayores que el valor predeterminado '#,###' proporcionado. Puesto que espera valores de millones o superiores, necesita una máscara más larga. Por ejemplo, un número escrito como 735790325 se convertirá en 735.790.325.
- En la instrucción return, reemplace annualGenInLightbulbsRounded por annualGenInLightbulbsText.
- Haga clic en Ejecutar para evaluar la expresión.
La Salida es "19.026", con un punto insertado, como se esperaba. Además, el tipo es ahora texto.
El siguiente paso es crear una frase completa que contenga el número con formato de texto y que explique lo que significa. Para ello, utilizará un literal de plantilla.
Nota:
Un literal de plantilla es una forma de insertar valores de variables y expresiones en una cadena en Arcade. Los literales de plantilla se encierran entre acentos graves (`) y utilizan la sintaxis ${variableName} para insertar en la cadena variables, expresiones o cualquier otro valor que no sea de cadena. Puede obtener más información sobre los literales de plantilla en el tema de ayuda Estructura y Lógica de ArcGIS Arcade.
- En la ventana Expresión, agregue una línea nueva antes de la declaración return y copie y pegue lo siguiente:
var popupSentence = `It's estimated that ${ plantName } generates enough electricity to power ${ annualGenInLightbulbsText } 60-watt incandescent light bulbs for a year.`
Nota:
El literal de la plantilla debe estar en una sola línea del editor de Arcade, ya que pasar a la siguiente línea generará una salida multilínea.
- En la línea de la instrucción return, reemplace annualGenInLightbulbsText por popupSentence para probar la última variable.
- Haga clic en el botón Ejecutar.
En la pestaña Salida, el valor es toda la frase, donde las variables ${plantName} y ${annualGenInLightbulbsText} se han reemplazado por sus valores actuales.
- En la ventana de expresión, elimine el código annualGenerationGwh = 10.
- Haga clic en Hecho para guardar la expresión y cerrar la ventana del editor de expresiones de Arcade.
- En la barra de herramientas Contenido contraída, haga clic en Guardar y abrir y haga clic en Guardar para guardar los cambios globales realizados en el mapa.
En esta sección, ha calculado el número de bombillas de 60 vatios a las que cada central eléctrica podría suministrar electricidad en un año, ha formateado ese número para que sea más legible y ha creado una frase para poner el número en contexto.
Agregar la expresión de Arcade a un elemento emergente
Ahora agregará su expresión de Arcade guardada al elemento emergente y la probará en una entidad de Global Power Plants en el mapa.
- En el panel Expresiones de elementos emergentes, haga clic en el botón Atrás.
- En el panel Elementos emergentes, haga clic en Texto y luego en Editar texto.
Se abre el editor de texto emergente y muestra el texto que aparece actualmente en la ventana emergente de la capa Global Power Plants. Agregará el resultado de su expresión de Arcade al texto existente.
- En el editor de texto emergente, coloque el cursor en la siguiente línea, debajo del texto existente. Escriba una sola llave: {.
Aparece una lista de campos disponibles y expresiones de Arcade.
- Localice y seleccione la expresión que acaba de crear, Generación anual estimada en bombillas.
Nota:
Puede ver que la expresión de Arcade que ha creado aparece en la lista como cualquier otro campo de atributo disponible. Puede reconocerla fácilmente gracias al nombre significativo que le asignó antes.
- La expresión se agrega con el identificador único {expression/expr1}.
- Haga clic en Aceptar.
La vista previa emergente se actualiza con la expresión Arcade personalizada que ha configurado.
Ahora abrirá un elemento emergente de una central eléctrica concreta en el mapa para ver cómo se muestra su expresión de Arcade.
- En la barra de herramientas vertical del mapa, haga clic en el botón Buscar.
- En el cuadro de búsqueda, escriba Kitzingen, Bayern, Germany y pulse Intro.
El mapa se acerca a la ciudad de Kitzingen en Alemania.
- Haga clic en la central eléctrica al oeste de la etiqueta Kitzingen. Está simbolizada en verde claro porque es una central solar.
El elemento emergente se abre y se muestra el mensaje que ha creado. La frase incluye el número de bombillas de 60 vatios que la central eléctrica podría alimentar durante un año: 146.258.
- Cierre la ventana emergente.
Ha creado correctamente una expresión de Arcade y la ha mostrado en el elemento emergente de la capa Global Power Plants. Sin embargo, todavía no se ha ocupado del caso especial, cuando una central eléctrica no presenta ningún valor en el campo estimated_generation_gwh. Lo hará en la siguiente sección.
Probar el caso especial de ausencia de datos
Ahora gestionará el caso en el que faltan datos de atributos. En primer lugar, examinará el aspecto del elemento emergente cuando esto ocurre.
- Haga clic en el botón Buscar. En el cuadro de búsqueda, escriba Antananarivo, Analamanga, Madagascar y pulse Intro.
El mapa se acerca a la ciudad de Antananarivo en Madagascar.
- Haga clic en la central eléctrica al noroeste de la etiqueta Antananarivo. Está simbolizada en rojo porque es una central térmica de petróleo.
El elemento emergente se abre y se muestra el mensaje que ha creado. Sin embargo, el número de bombillas de 60 vatios mencionado es 0.
Esto es engañoso: no se estima que la central eléctrica genere 0 gWh en un año, sino que no hay datos de generación anual de electricidad. En estos casos, es mejor que se muestre otro mensaje que indique con claridad que no hay datos disponibles. Volverá a la expresión de Arcade para implementar este comportamiento más preciso.
- Cierre la ventana emergente.
- En el panel Capas, confirme que la capa Global Power Plants esté seleccionada.
- En la barra de herramientas Configuración, haga clic en Elementos emergentes. En el panel de configuración Elementos emergentes, haga clic en Administrar expresiones.
- Haga clic en la expresión Generación anual estimada en bombillas para abrirla en la ventana del editor.
- En la ventana del editor, haga clic en el botón Ejecutar para verificar que obtiene el mismo comportamiento que en el elemento emergente.
En la pestaña Salida, el valor incluye la misma frase que en el elemento emergente con el número engañoso de 0 bombillas.
Nota:
Recuerde que, de forma predeterminada, el editor de Arcade utiliza la primera central eléctrica de la capa, Kajaki Hydroelectric Power Plant Afghanistan, y ya vio anteriormente que esta central eléctrica no tiene ningún valor para el campo estimated_generation_gwh.
Agregar código para gestionar datos que faltan
Ahora agregará código a su expresión para gestionar mejor los casos en los que falten datos.
Para gestionar mejor los casos en los que faltan datos, la expresión de Arcade debe probar si el valor del campo estimated_generation_gwh está vacío o no.
- Si lo está, devolverá un mensaje para indicar que no hay datos.
- Si no lo está, procederá a crear el mensaje de las bombillas de 60 vatios.
Usará de nuevo la función IsEmpty. Almacenará el resultado de la prueba en una nueva variable, generationCheck. Quiere realizar la prueba lo antes posible, por lo que agregará el nuevo código inmediatamente después de haber leído el valor del campo estimated_generation_gwh.
- En la ventana Expresión, agregue una línea después de la línea que comienza por var annualGenerationGwh.
- Escriba var generationCheck = .
- Haga clic en la pestaña Funciones y busque la función IsEmpty.
- Haga clic en la función IsEmpty para agregarla a su línea de código.
- En la pestaña Funciones, haga clic en la flecha situada junto a la función IsEmpty para obtener información sobre cómo funciona.
IsEmpty engloba un solo parámetro (en su caso, evaluará el campo estimated_generation_gwh). Si el valor es nulo o una cadena de caracteres vacía, la función devuelve true; si no es así, devuelve false. Almacenará la salida de IsEmpty en una variable y luego evaluará la variable para comprobar si es verdadera (true) o falsa (false).
- Cuando haya terminado de revisar la información en isEmpty, haga clic en la flecha atrás situada junto a Funciones.
- En la ventana Expresión, reemplace el texto de marcador de posición value por annualGenerationGwh. La línea entera debería tener este aspecto:
var generationCheck = isEmpty(annualGenerationGwh)
A continuación, agregará código para decidir qué hacer en función del valor de la variable generationCheck. Para ello, utilizará una instrucción if (también denominada declaración condicional). La sintaxis de esta instrucción es "if (la condición es verdadera) {hacer algo}". Puede obtener más información sobre las declaraciones condicionales en Estructura y Lógica de ArcGIS Arcade.
- Agregue una línea nueva después de la línea que comienza por var generationCheck.
- En la nueva línea, escriba if (generationCheck) {. Pulse Intro. Omita una línea y agregue un corchete de cierre } que no esté sangrado.
Nota:
Dado que la variable generationCheck contiene true o false, en esencia está preguntando a Arcade if(true) o if(false). Las instrucciones entre corchetes solo se ejecutarán si generationCheck es true.
Ahora escribirá el código para realizar la acción deseada cuando estimated_generation_gwh esté vacío. Entre los corchetes, creará el mensaje que se mostrará. Como antes, utilizará un literal de plantilla y lo almacenará en una nueva variable.
- Entre los corchetes, escriba (o copie y pegue) el siguiente texto (todo en una misma línea):
var noGenerationTL = `${ plantName } does not have estimated annual generation data. Unable to return electricity generation in 60w incandescent light bulbs.`
La expresión utiliza la variable plantName que definió anteriormente en su código.
Por último, agregará una instrucción return para devolver ese mensaje.
- Agregue una nueva línea encima del corchete de cierre y escriba return noGenerationTL.
- Haga clic en Ejecutar para probar su script.
Esta vez, el mensaje no habla erróneamente de 0 bombillas. En su lugar, explica que faltan datos para la central eléctrica Kajaki Hydroelectric Power Plant Afghanistan.
Nota:
Es importante entender que, cuando Arcade ejecuta una instrucción return, considera que es el final de la ejecución del código y se ignora el resto de código situado debajo de esa instrucción. Este es el comportamiento que desea, ya que el resto de código solo se aplica a las entidades que tienen datos para la generación de electricidad anual estimada.
Realizar más pruebas con una instrucción console
Como tarea final en la ventana del editor de expresiones de Arcade, ahora aprenderá otro método para probar su expresión de Arcade. Hasta ahora, ha utilizado instrucciones return para ver la salida de su script. Sin embargo, puede haber casos en los que también desee visualizar el valor de las variables en el código. Para verlos, puede utilizar instrucciones console que escribirán el valor de sus variables de interés en la pestaña Consola. Por ejemplo, es posible que desee ver el valor de la variable generationCheck.
- En la ventana Expresión, agregue una línea nueva después de la línea que comienza por var generationCheck.
- En la nueva línea, escriba console("generationCheck value:", generationCheck).
El primer parámetro ofrece una explicación del objeto que está registrando en la consola. El segundo parámetro es el propio objeto.
- Haga clic en el botón Ejecutar.
La pestaña Salida tiene el mismo aspecto que antes, donde se muestra el resultado final de la expresión Arcade.
- Cambie a la pestaña Consola para ver el valor de la variable registrado en la consola.
El valor que se mantiene en la variable generationCheck es true, porque el valor de estimated_generate_gwh está vacío.
- Pruebe otros valores de muestra para $feature["estimated_generation_gwh"], pruebe la expresión para cada uno y examine las pestañas Salida y Consola. Incluya ejemplos que proporcionen un valor true o false para generationCheck.
Nota:
Puede agregar tantas instrucciones console como desee para desarrollar y depurar su expresión de Arcade. Sin embargo, se recomienda eliminar o marcar como comentario esas instrucciones una vez finalizada la expresión.
Como esta línea de código fue a efectos de prueba, ahora comentará la instrucción console.
- Al inicio de la instrucción console, escriba //.
La instrucción console ahora es un comentario y no se ejecutará como un comando.
El siguiente ejemplo muestra el aspecto de la expresión final. Se han agregado comentarios para describir cada paso.
// Calculate the kilowatt-hours (kWh) required to power a // 60w light bulb for a year var yearLightbulbPower = 0.06 * 24 * 365 // Save the power plant name and annual generation to a variable // for later use var plantName = $feature.name var annualGenerationGwh = $feature["estimated_generation_gwh"] // Check if there is a value in the estimated annual generation // attribute field. isEmpty(fieldOrValue) returns true if empty var generationCheck = isEmpty(annualGenerationGwh) // Write to the generationCheck value to the Message tab for // testing purposes (commented out) // console("generationCheck value:", generationCheck) // If there is not annual generation data, return a sentence for use // in the pop-up that informs the user about this. if (generationCheck) { var noGenerationTL = `${ plantName } does not have estimated annual generation data. Unable to return electricity generation in 60w incandescent light bulbs.` return noGenerationTL } // If the annual generation data is present, continue with the remainder of the script. // Convert the annual generation attribute from // gigawatt-hours to kilowatt-hours var annualGenerationKwh = annualGenerationGwh * 1000000 // Compute the annual electricity generation in light bulbs var annualGenInLightbulbs = annualGenerationKwh / yearLightbulbPower // Round the number var annualGenInLightbulbsRounded = Round(annualGenInLightbulbs, 0) // Format the number to add thousand separators var annualGenInLightbulbsText = Text( annualGenInLightbulbsRounded, '###,###,###,###') // Build the sentence for use in the pop-up // (Create a string using a template literal) var popupSentence = `It's estimated that ${ plantName } generates enough electricity to power ${ annualGenInLightbulbsText } 60-watt incandescent light bulbs for a year.` // Return the value return popupSentenceNota:
Dado que la frase que gestiona la ausencia de datos se encuentra dentro de una instrucción if, puede encerrar opcionalmente el resto de su expresión de Arcade dentro de else {<rest of expression>}. Sin embargo, si no se escribe explícitamente else {}, como ha visto, el resto de la expresión seguirá ejecutándose si no se cumple la condición de la instrucción if.
Ahora cerrará el editor de expresiones de Arcade y probará los elementos emergentes en el mapa.
- Seleccione Hecho para guardar la expresión y cerrar la ventana del editor.
La vista previa de la ventana emergente de Mandroseza muestra ahora el mensaje adecuado.
- En el panel Expresiones de elementos emergentes, haga clic en el botón Atrás. Cierre el panel Elementos emergentes.
- Guarde el mapa.
- Haga clic en varias centrales eléctricas del mapa para comprobar que su expresión de Arcade funciona correctamente.
Nota:
Puede buscar las dos ubicaciones de antes (Kitzingen, Bayern, Germany y Antananarivo, Analamanga, Madagascar). También puede probar otras nuevas.
Ha calculado la cantidad de electricidad necesaria para alimentar una bombilla de 60 vatios durante un año y el número de bombillas de 60 vatios que cada central eléctrica podría alimentar durante un año. Ha redondeado un valor a un número entero y ha agregado separadores de miles. Ha creado dos frases diferentes que se pueden devolver en el elemento emergente: una para los casos en los que existen datos de generación de electricidad anuales para la central eléctrica y otra para cuando no existen datos. Después, se ha asegurado de que las entidades de centrales eléctricas del mapa muestran la frase adecuada utilizando una instrucción if.
En este tutorial, se ha familiarizado con el editor de expresiones de Arcade. Ha utilizado Arcade para simbolizar los países del mundo por el consumo eléctrico per cápita. Ha utilizado Arcade para entender cuántas bombillas de 60 vatios podría alimentar cada central eléctrica durante un año y ha mostrado el resultado en un elemento emergente. Todo el código Arcade se ha ejecutado al vuelo, sin afectar a los datos subyacentes.
En este tutorial se han tratado solamente algunas de las tareas que puede hacer con Arcade. Para obtener más información sobre el etiquetado de expresiones y el cálculo de campos en Arcade, explore Acoplar sus ventanas emergentes con FeatureSets de Arcade y Living Atlas y Utilizar los colores del mapa en su elemento emergente utilizando Arcade.
Encontrará más tutoriales en la galería de tutoriales.
