"}],"short_description":"Learn more about how you can use Arcade with labels and pop-ups for your CSV, GeoJSON, and WFS layers in ArcGIS Online. ","flexible_content":[{"acf_fc_layout":"content","content":"This year at the 2024 User Conference, many individuals expressed an interest in being able to do more with Arcade and non-feature layer items. Well, you asked, and we listened! With the latest update of ArcGIS Online, we are excited to announce that we have improved Arcade support for CSV, GeoJSON, and WFS layers. In addition to the Visualization profile (where there was already support for these layers), these layer types are now fully supported within the context of the Arcade Popup and Labeling profiles. Let\u2019s dive into what this support entails before providing some examples of how you can take advantage of this new functionality during the map authoring experience.<\/p>\n
<\/p>\n"},{"acf_fc_layout":"content","content":"
There are multiple ways to create and work with CSV<\/a>, GeoJSON<\/a>, and WFS<\/a> layers in Map Viewer. All three of these layer types can be added directly to your web map using a URL<\/a>, or via file upload<\/a> (GeoJSON and CSV only). Additionally, a WFS layer can be created from a pre-existing feature layer you own using the Publish<\/a> option on the layer\u2019s item details page.<\/p>\n If a GeoJSON layer already exists in your organization, you can also add it directly to the map using the browse layers workflow<\/a>. After opening the browse experience in Map Viewer, click the Refine content option and apply a filter where the item type is \u2018GeoJSON\u2019.<\/p>\n Once you\u2019ve added your layer(s) to the map, it\u2019s time to start writing some Arcade.<\/p>\n <\/p>\n"},{"acf_fc_layout":"content","content":" Arcade\u2019s labeling profile is used to dynamically label features within your map. Now, when you open the Label pane in Map Viewer with a CSV, GeoJSON, or WFS layer as your active layer, you will see the option to label the feature with an Arcade expression. When authoring your expression, you\u2019ll only have access to attributes for that feature. Like the Visualization profile, FeatureSets and their functions are not supported in the Labeling profile for performance reasons<\/a>.<\/p>\n"},{"acf_fc_layout":"content","content":" Let\u2019s say you\u2019ve just found a WFS layer that indicates lakes in and around California that would be perfect for your map. In the map, you want to label each lake to show the name and the relevant state(s) where it is located. Fortunately, there are fields that contain this information. Unfortunately, the attribute values aren\u2019t formatted as you\u2019d like to display them in the label. That\u2019s where Arcade comes in.<\/p>\n In the expression below, the name of the lake has been capitalized with the Upper()<\/a> function to ensure it\u2019s prominence in the label. Then, the Decode()<\/a> function is used to map the various attribute state codes to more easily understood strings.<\/p>\n"},{"acf_fc_layout":"content","content":" After saving the expression, the feature labels will look like this.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":2594712,"id":2594712,"title":"lake_label","filename":"lake_label.png","filesize":604115,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/lake_label.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/arcade\/improved-arcade-support-for-csv-geojson-and-wfs-layers\/lake_label","alt":"A feature that is labelled with Arcade to show the lake's name and the state(s) it is found in.","author":"319692","description":"","caption":"Arcade can be used to dynamically label features in a WFS, GeoJSON, or CSV layer in Map Viewer. ","name":"lake_label","status":"inherit","uploaded_to":2536462,"date":"2024-11-19 23:09:03","modified":"2024-11-20 18:12:16","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":426,"height":641,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/lake_label-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/lake_label.png","medium-width":173,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/lake_label.png","medium_large-width":426,"medium_large-height":641,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/lake_label.png","large-width":426,"large-height":641,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/lake_label.png","1536x1536-width":426,"1536x1536-height":641,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/lake_label.png","2048x2048-width":426,"2048x2048-height":641,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/lake_label-309x465.png","card_image-width":309,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/lake_label.png","wide_image-width":426,"wide_image-height":641}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":" This is just one example of the myriad ways Arcade can be used to label features. Other possibilities include returning multi-line labels with a template literal<\/a>, or performing on the fly conversions (e.g., \u00b0F \u2194 \u00b0C) and mathematical calculations.<\/p>\n <\/p>\n"},{"acf_fc_layout":"content","content":" Authoring both attribute expressions and Arcade content elements<\/a> is now fully supported for CSV, GeoJSON, and WFS layer pop-ups in Map Viewer. Prior to this update, Arcade expressions could only be authored on CSV and GeoJSON layers, and available profile variables were limited to $feature. Now that we\u2019ve added support for additional profile variables ($layer, $map, $userInput) and FeatureSet functions<\/a>, you can go even further with your layer pop-ups.<\/p>\n"},{"acf_fc_layout":"sidebar","content":" Note: Make sure to use FeatureSets responsibly in your Arcade expressions. Iterating through FeatureSets or making data requests within a loop can have performance and scalability concerns, particularly when you’re working with a large number of features.<\/p>\n","image_reference":false,"layout":"standard","image_reference_figure":"","snippet":"","spotlight_name":"","section_title":"","position":"Center","spotlight_image":false},{"acf_fc_layout":"content","content":" The ability to use other $map and FeatureSet functions in your pop-ups makes it incredibly easy to determine spatial relationships between different map layers. In the example below, we have a map with two distinct WFS layers that contain counties and golf courses in the state of California. With just one Arcade expression (and some HTML for formatting) we can create a dynamic rich text element in the county layer pop-up that displays the number of golf courses in each county.<\/p>\n"},{"acf_fc_layout":"content","content":"Labeling profile support<\/h2>\n
An example<\/h3>\n
\/\/ Get the name and state fields from the layer<\/span>\r\nvar<\/span> name<\/span> = Upper($feature.NAME)<\/span>;\r\nvar<\/span> state<\/span> = $feature.STATE<\/span>;\r\n\r\n\/\/ Get the relevant text string according to attribute value<\/span>\r\nstate<\/span> = Decode(<\/span>\r\n state<\/span>,\r\n \"CA\"<\/span>, \"California\"<\/span>,\r\n \"CA-OR\"<\/span>, \"California\/Oregon\"<\/span>,\r\n \"AZ-CA\"<\/span>, \"California\/Arizona\"<\/span>,\r\n \"CA-NV\"<\/span>, \"California\/Nevada\"<\/span>,\r\n \"AZ-CA-NV\"<\/span>, \"California\/Arizona\/Nevada\"<\/span>,\r\n \"AZ\"<\/span>, \"Arizona\"<\/span>,\r\n \"State unknown\"<\/span>\r\n)<\/span>;\r\n\r\n\/\/ Return formatted fields in the feature's label<\/span>\r\nreturn<\/span> `<\/span>${name}<\/span>(${state}<\/span>)`<\/span>\r\n<\/code><\/pre>\n"},{"acf_fc_layout":"content","content":"Popup profile support<\/h2>\n
Attribute expressions<\/h3>\n
\r\n\/\/ Get featureset of all golf courses in the state<\/span>\r\nvar<\/span> golf<\/span> = FeatureSetById<\/span>($map<\/span>, \"193033f7032-layer-7\"<\/span>, [\"NAME\"<\/span>]);\r\n\r\n\/\/ find golf courses that intersect the county and determine count<\/span>\r\nvar<\/span> int_golf<\/span> = Intersects<\/span>(golf<\/span>, $feature<\/span>);\r\nvar<\/span> cnt_golf<\/span> = Count(int_golf)<\/span>;\r\n\r\n\/\/ return value in pop-up<\/span>\r\nreturn<\/span> cnt_golf<\/span>\r\n<\/code><\/pre>\n"},{"acf_fc_layout":"image","image":{"ID":2596642,"id":2596642,"title":"expression_popup_with_pic","filename":"expression_popup_with_pic.png","filesize":88646,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/expression_popup_with_pic.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/arcade\/improved-arcade-support-for-csv-geojson-and-wfs-layers\/expression_popup_with_pic","alt":"A pop-up formatted with HTML that indicates the number of golf courses in Sonoma county alongside a picture of a golfer teeing off.","author":"319692","description":"","caption":"The pop-up uses an Arcade attribute expression to indicate the number of golf courses in Sonoma County, California.","name":"expression_popup_with_pic","status":"inherit","uploaded_to":2536462,"date":"2024-11-20 22:55:30","modified":"2024-11-20 22:56:41","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":337,"height":285,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/expression_popup_with_pic-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/expression_popup_with_pic.png","medium-width":309,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/expression_popup_with_pic.png","medium_large-width":337,"medium_large-height":285,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/expression_popup_with_pic.png","large-width":337,"large-height":285,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/expression_popup_with_pic.png","1536x1536-width":337,"1536x1536-height":285,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/expression_popup_with_pic.png","2048x2048-width":337,"2048x2048-height":285,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/expression_popup_with_pic.png","card_image-width":337,"card_image-height":285,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2024\/10\/expression_popup_with_pic.png","wide_image-width":337,"wide_image-height":285}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"Content element<\/h3>\n