"},{"ID":320932,"user_firstname":"Omar","user_lastname":"Kawach","nickname":"Omar Kawach","user_nicename":"okawach","display_name":"Omar Kawach","user_email":"okawach@esri.com","user_url":"","user_registered":"2022-10-25 16:27:17","user_description":"Omar is a biotechnologist, geographer and computer scientist who works at Esri as a Product Engineer on the ArcGIS Maps SDK for JavaScript components and Arcade expression language. Omar's main focus is to help develop and integrate modern web components like the Arcade editor which you can now find across ArcGIS Online!","user_avatar":"
"}],"short_description":"The Arcade 1.23 release introduces three powerful new functions, an updated playground for testing your Arcade expressions, and more!","flexible_content":[{"acf_fc_layout":"content","content":"The latest release<\/a> (v1.23) of Arcade<\/a> introduces three powerful new functions, an updated playground for prototyping and testing your Arcade expressions, and more! Let\u2019s dive in.<\/p>\n The GetEnvironment<\/a> function is a game-changer when it comes to accessing contextual information within your Arcade expressions. It provides valuable metadata about the execution context of the expression, allowing you to write dynamic and responsive scripts. Whether you need to extract the Arcade runtime engine, spatial reference, locale, or other important details, GetEnvironment has got you covered.<\/p>\n The NearestCoordinate<\/a> function allows you to determine the closest coordinate<\/strong> to a given point within a geometry or feature. Whether you need to identify the nearest point, line, or polygon from a given reference, this function makes it possible. By employing NearestCoordinate, you can calculate distances, identify closest facilities, and determine proximity-based relationships.<\/p>\n The following expression uses NearestCoordinate to find the minimum distance between the current feature and the closest building.<\/p>\n Similar to the NearestCoordinate<\/a> function, NearestVertex<\/a> enables you to identify the\u00a0closest<\/strong>\u00a0vertex<\/strong>\u00a0on a geometry to a given location. NearestVertex can be used to determine the nearest point on a path or route, proximity of certain features to a point of interest, and more.<\/p>\n This function proves particularly valuable in the utility space, as all features on lines within utility networks are required to have vertices. By calling NearestVertex, we can effectively obtain the precise location and distance to the nearest feature, making it an indispensable tool for utility network analysis.<\/p>\n"},{"acf_fc_layout":"content","content":" The original Arcade playground was developed as a standalone environment for users to test their Arcade expressions and try out the latest features of Arcade.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1958752,"id":1958752,"title":"The old Arcade playground","filename":"Screenshot-2023-06-08-at-13.23.49.png","filesize":92029,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/07\/Screenshot-2023-06-08-at-13.23.49.png","link":"https:\/\/www.esri.com\/arcgis-blog\/screenshot-2023-06-08-at-13-23-49","alt":"The old Arcade playground as seen in the Developer doc site","author":"320932","description":"The old Arcade playground","caption":"The old Arcade playground","name":"screenshot-2023-06-08-at-13-23-49","status":"inherit","uploaded_to":0,"date":"2023-06-08 20:25:33","modified":"2023-06-08 20:28:01","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":1644,"height":856,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/07\/Screenshot-2023-06-08-at-13.23.49-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/07\/Screenshot-2023-06-08-at-13.23.49.png","medium-width":464,"medium-height":242,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/07\/Screenshot-2023-06-08-at-13.23.49.png","medium_large-width":768,"medium_large-height":400,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/07\/Screenshot-2023-06-08-at-13.23.49.png","large-width":1644,"large-height":856,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/07\/Screenshot-2023-06-08-at-13.23.49-1536x800.png","1536x1536-width":1536,"1536x1536-height":800,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/07\/Screenshot-2023-06-08-at-13.23.49.png","2048x2048-width":1644,"2048x2048-height":856,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/07\/Screenshot-2023-06-08-at-13.23.49-826x430.png","card_image-width":826,"card_image-height":430,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/07\/Screenshot-2023-06-08-at-13.23.49.png","wide_image-width":1644,"wide_image-height":856}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":" As part of our ongoing effort to enhance the Arcade documentation site<\/a>, we have updated the playground to use the new and improved Arcade editor. The new editor was introduced in the November 2022 release of ArcGIS Online<\/a> and brought many powerful new features<\/a> to enhance your experience with writing Arcade expressions. In the June 2023 release of ArcGIS Online, we\u2019re bringing a new accessible color palette<\/a> for better overall syntax highlighting \/ code colorization, meeting Web Content Accessibility Guidelines<\/a> (WCAG 2.0).<\/p>\n Experience these enhanced capabilities firsthand in the new Arcade playground<\/a>. With its user-friendly interface, along with advanced functionalities like syntax highlighting, auto-completion, and improved error messages, you’ll enjoy a seamless debugging and testing experience for your new functions. Witness instant results as you test and debug, empowering you to explore the full potential of Arcade in real-time.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1970942,"id":1970942,"title":"The new Arcade playground","filename":"Screenshot-2023-06-13-at-12.50.42-PM.png","filesize":344343,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/06\/Screenshot-2023-06-13-at-12.50.42-PM.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-online\/mapping\/arcgis-arcade-123-release\/screenshot-2023-06-13-at-12-50-42-pm","alt":"The new Arcade playground as seen in the Developer documentation site","author":"10062","description":"The new Arcade playground","caption":"The new Arcade playground","name":"screenshot-2023-06-13-at-12-50-42-pm","status":"inherit","uploaded_to":1969802,"date":"2023-06-13 19:51:10","modified":"2023-06-14 04:59:10","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":2290,"height":1560,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/06\/Screenshot-2023-06-13-at-12.50.42-PM-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/06\/Screenshot-2023-06-13-at-12.50.42-PM.png","medium-width":383,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/06\/Screenshot-2023-06-13-at-12.50.42-PM.png","medium_large-width":768,"medium_large-height":523,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/06\/Screenshot-2023-06-13-at-12.50.42-PM.png","large-width":1585,"large-height":1080,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/06\/Screenshot-2023-06-13-at-12.50.42-PM-1536x1046.png","1536x1536-width":1536,"1536x1536-height":1046,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/06\/Screenshot-2023-06-13-at-12.50.42-PM-2048x1395.png","2048x2048-width":2048,"2048x2048-height":1395,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/06\/Screenshot-2023-06-13-at-12.50.42-PM-683x465.png","card_image-width":683,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2023\/06\/Screenshot-2023-06-13-at-12.50.42-PM-1585x1080.png","wide_image-width":1585,"wide_image-height":1080}},"image_position":"center","orientation":"horizontal","hyperlink":"https:\/\/developers.arcgis.com\/arcade\/playground\/"},{"acf_fc_layout":"content","content":" In addition to the new functions mentioned earlier, the recent release of Arcade also introduces updated functions that streamline the process of copying or converting data types within Arcade expressions.<\/p>\n The\u00a0Array<\/a>\u00a0and\u00a0Dictionary<\/a>\u00a0functions have new signatures with an optional\u00a0 We\u2019ve also added new signatures to\u00a0Dictionary<\/a>\u00a0and\u00a0Feature<\/a>\u00a0that allow for easier conversion between data types without first having to convert to JSON text.<\/p>\n We\u2019re listening to your feedback! At this release, the\u00a0Attachment<\/a>\u00a0data type was updated to include\u00a0New Functions<\/h2>\n
GetEnvironment<\/h3>\n
var<\/span> env = GetEnvironment<\/span>();<\/strong>\r\n\/\/ returns the following when executed in the Map Viewer<\/span>\r\n\/\/ {<\/span>\r\n\/\/ \"version\":\"1.23\",<\/span>\r\n\/\/ \"engine\":\"web\",<\/span>\r\n\/\/ \"engineVersion\":\"4.27\",<\/span>\r\n\/\/ \"application\":\"ArcGISMapViewer\",<\/span>\r\n\/\/ \"locale\":\"en-US\",<\/span>\r\n\/\/ \"spatialReference\": { \"wkid\": 3857 }<\/span>\r\n\/\/ }<\/span>\r\nvar<\/span> locale = IIF<\/span>(HasValue<\/span>(env, \"locale\"<\/span>), env.locale, \"\"<\/span>);\r\n\/\/ returns the locale if it exists, otherwise returns an empty text value<\/span>\r\nreturn<\/span> locale;\r\n<\/code><\/pre>\n"},{"acf_fc_layout":"content","content":"NearestCoordinate<\/h3>\n
\/\/ find all buildings within a 50ft buffer of the current feature<\/span>\r\nvar<\/span> bldgDistance = 50<\/span>;\r\nvar<\/span> bufferedDistance = Buffer<\/span>($feature<\/span>, bldgDistance, \"feet\"<\/span>);\r\nvar<\/span> buildings = FeatureSetByName<\/span>($map<\/span>, \"Boston buildings\"<\/span>);\r\nvar<\/span> buildings_filtered = Intersects<\/span>(buildings, bufferedDistance);\r\n\r\nvar<\/span> min_dist = bldgDistance;\r\nif<\/span> (Count<\/span>(buildings_filtered) > 0<\/span>) {\r\n for<\/span> (var<\/span> building in buildings_filtered) {\r\n \/\/ find the nearest coordinate between the feature and building<\/span>\r\n var<\/span> dict = NearestCoordinate<\/span>(building, $feature<\/span>);<\/strong>\r\n \/\/ distance is in meters<\/span>\r\n if<\/span> (dict.distance<\/span> <= min_dist) {\r\n min_dist = dict.distance<\/span>;\r\n }\r\n }\r\n}\r\n\/\/ convert to feet & round<\/span>\r\nreturn<\/span> Round<\/span>(min_dist * 3.281<\/span>, 2<\/span>);\r\n<\/code><\/pre>\nNearestVertex<\/h3>\n
Updated Playground<\/h2>\n
Updated functions<\/h2>\n
deep<\/code>\u00a0parameter, which allows you to create a shallow or deep copy of the Dictionary or Array. When\u00a0deep: true<\/code>, the functions create a deep copy of each element in the input array\/dictionary, meaning elements in the output array\/dictionary will not share the same references as the elements of the input array\/dictionary. Creating a deep copy allows you to make changes to the copied array\/dictionary without impacting the original data.<\/p>\nUpdated data types<\/h2>\n
keywords<\/code>. Also,\u00a0Number<\/a>\u00a0data values can now be represented as\u00a0binary<\/a>,\u00a0octal<\/a>, and\u00a0hexadecimal<\/a>\u00a0values.<\/p>\n
\n