{"id":626722,"date":"2023-10-31T19:59:44","date_gmt":"2023-11-01T02:59:44","guid":{"rendered":"https:\/\/www.esri.com\/about\/newsroom\/?post_type=arcnews&p=626722"},"modified":"2023-10-26T15:41:11","modified_gmt":"2023-10-26T22:41:11","slug":"three-ways-to-use-arcgis-arcade-to-enhance-web-maps","status":"publish","type":"arcnews","link":"https:\/\/www.esri.com\/about\/newsroom\/arcnews\/three-ways-to-use-arcgis-arcade-to-enhance-web-maps","title":{"rendered":"Three Ways to Use ArcGIS Arcade to Enhance Web Maps"},"author":5752,"featured_media":0,"menu_order":0,"template":"","format":"standard","meta":{"_acf_changed":false,"sync_status":"","episode_type":"","audio_file":"","castos_file_data":"","podmotor_file_id":"","cover_image":"","cover_image_id":"","duration":"","filesize":"","filesize_raw":"","date_recorded":"","explicit":"","block":"","itunes_episode_number":"","itunes_title":"","itunes_season_number":"","itunes_episode_type":"","_links_to":"","_links_to_target":""},"categories":[10532,10432,10392],"tags":[157412,279962,295152,411322,1281],"arcnews_issues":[486972],"class_list":["post-626722","arcnews","type-arcnews","status-publish","format-standard","hentry","category-arcgis-arcade","category-arcgis-enterprise","category-arcgis-online","tag-data","tag-layers","tag-map-viewer","tag-pop-ups","tag-visualization","arcnews_issues-fall-2023","arcnews_sections-esri-technology"],"acf":{"short_description":"Elevate the look and feel of your web maps by setting rules that determine how text, pop-ups, and other dynamic content get displayed.","pdf":{"host_remotely":false,"file":"","file_url":""},"flexible_content":[{"acf_fc_layout":"content","content":"ArcGIS Arcade is an expression language created by Esri that gives users the ability to define and save custom content in their web maps. Through Arcade, users set rules that determine how dynamic content, such as text and pop-ups, displays within the context of a map. When an Arcade expression gets saved, any app that an organization creates using ArcGIS technology\u2014whether it\u2019s on the desktop, a mobile device, or the web\u2014honors that logic to maintain consistency wherever the map is viewed.\r\n\r\nAlthough Arcade was initially created for ArcGIS Pro, it also works in ArcGIS Online and ArcGIS Enterprise. Here are three ways that users can employ Arcade in Map Viewer to enhance the look, feel, and interactive elements of web maps."},{"acf_fc_layout":"content","content":"

1. Format Data Values<\/h2>\r\nIt\u2019s no secret that GIS professionals are often required to work with messy data. To make this data more presentable, Arcade provides built-in functions that let users format data values in pop-ups and labels.\r\n

Change Case<\/h3>\r\nConsider a text attribute in a layer representing parks that stores the name of each park in all caps or even inconsistently, with some park names in all lowercase letters and others in mixed case. Arcade\u2019s Proper function allows users to transform any text value to the proper case.\r\n\r\nFor example, if some data sources list \u201cLASSEN VOLCANIC NATIONAL PARK\u201d while others show \u201classen volcanic national park,\u201d employing the following Arcade expression will format both so they display as \u201cLassen Volcanic National Park.\u201d\r\n
Proper($feature.NAME)<\/code><\/pre>"},{"acf_fc_layout":"content","content":"
Calculate Formulas<\/h3>\r\nUsing Arcade, Map Viewer users can calculate both simple and complex formulas, such as the percentage change in an area\u2019s population from one year to another. In the 2020 Census, for example, the town of Poultney, Vermont, recorded a population of 3,020 people, whereas in the 2010 Census, the town\u2019s population was recorded as 3,432 people. To calculate this difference, a user can employ the following Arcade expression:\r\n
var current = $feature.pop2020; \/\/ current = 3020\r\nvar previous = $feature.pop2010 \/\/ previous = 3432\r\nvar change = (current - previous) \/ previous;<\/code><\/pre>\r\nIn many cases, dividing two numbers returns a number with many decimal places, such as 0.12004662004662005\u2014the difference in Poultney\u2019s population between 2010 and 2020. This level of precision, however, is often too high or not required by the end user. That\u2019s why Arcade also enables users to format values so they are more readable. (Learn more about this in the next section.)"},{"acf_fc_layout":"content","content":"
Format Numeric Values<\/h3>\r\nUsers can employ the Text function to create an Arcade expression that formats numeric values. So a number with 17 decimal places, as in the example above, is automatically cut to two places, or a four-digit year (2023) is displayed as a two-digit year (23).\r\n\r\nThis function also respects the locale of the map. As people view the map from different locations\u2014say, the United States versus Spain\u2014the number formatting conventions for where the end user is located are honored.\r\n\r\nAdding the following line to the previous example in the Arcade expression for labeling would display -12.0 percent in the United States and -12,0 percent in Spain.\r\n
Text(change, \"+#.#%;-#.#%\");\r\n\/\/ displays \"-12.0%\" if locale is English\r\n\/\/ displays \"-12,0%\" if locale is Spanish<\/code><\/pre>"},{"acf_fc_layout":"content","content":"
Synthesize Data into Meaningful Categories<\/h3>\r\nSome numeric values need to be classified into categories that help a general audience better understand them. For instance, the average person likely doesn\u2019t know whether a value of 30 parts per thousand is a high or low salinity value for the ocean. Arcade\u2019s When function helps give context to raw data values by classifying them in meaningful categories. Here\u2019s how to do this for ocean salinity:\r\n
When(\r\n    $feature.SALINITY > 37, \"high\",\r\n    $feature.SALINITY > 33, \"normal\",\r\n    \"low\"\r\n);\r\n\/\/ returns \"low\" if the value of SALINITY in the selected features is 30<\/code><\/pre>"},{"acf_fc_layout":"content","content":"
When to Apply Arcade to Format Data Values<\/h2>\r\nThese examples demonstrate how users can employ Arcade to transform raw or even messy data values into meaningful information for end users. This can be useful in the following situations:\r\n