{"id":1648802,"date":"2022-07-07T09:00:52","date_gmt":"2022-07-07T16:00:52","guid":{"rendered":"https:\/\/www.esri.com\/arcgis-blog\/?post_type=blog&p=1648802"},"modified":"2025-04-18T11:46:31","modified_gmt":"2025-04-18T18:46:31","slug":"whats-new-in-arcgis-api-for-python-2-0-1","status":"publish","type":"blog","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/api-python\/developers\/whats-new-in-arcgis-api-for-python-2-0-1","title":{"rendered":"What\u2019s new in ArcGIS API for Python 2.0.1"},"author":290632,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":""},"categories":[738191],"tags":[],"industry":[],"product":[36841,761642],"class_list":["post-1648802","blog","type-blog","status-publish","format-standard","hentry","category-developers","product-api-python","product-platform"],"acf":{"short_description":"In the June 2022 release, the team has enhanced several aspects of the API, including core API, content management, analysis and data science.","flexible_content":[{"acf_fc_layout":"content","content":"

The ArcGIS API for Python team has worked diligently to enhance<\/span>\u00a0the user experience of working with the API.\u00a0 All of this work culminated with a <\/span>major release to v2.0<\/span><\/a> in February 2022, which focused on improving performance and security for our users, framework and UX upgrades, introduction of new modules and functionality, and removal of deprecated functionality.\u00a0<\/span>In the June 2022 release of version 2.0.1, the team has continued to improve many of these features.\u00a0 Here are some highlights organized into common workflows and themes:<\/span>\u00a0<\/span><\/p>\n

Core API<\/span><\/b>\u00a0<\/span><\/h2>\n

More is always better\u2026right?\u00a0 When it comes to security, we think so.\u00a0 We worked closely with teams developing the <\/span>urllib3<\/span><\/a> and <\/span>requests<\/span><\/a> libraries, and the result is a big improvement in our handling of port forward proxies, which has been highly requested on the <\/span>Esri Community<\/span><\/a>. We now generate tokens with terms and conditions and check more locations for token presence, assign the API Key security handler, and add proxy detection and certificate verification to the <\/span>arcgis.auth<\/span><\/a> module. Looking ahead, we will continue to keep the API secure and add new ways to avoid security threats.\u202f<\/span>\u00a0<\/span><\/p>\n

Given the varied organizational configurations the API encounters, we constantly review and revise how we structure requests and responses, so they provide us with clearer direction to track down specific error causes.\u202f We continued adding details to login messages and zeroed in on the return information from invalid logins.\u202f In particular, with OAuth2, we changed how we assign some variables to determine what information is missing. We also tracked down situations where a missing security question in ArcGIS Online raised an uninformative error. So now <\/span>we<\/span><\/i> handle these situations!\u202f\u202f<\/span>\u00a0<\/span><\/p>\n

Administration\u00a0<\/span><\/b>\u00a0<\/span><\/h2>\n

In 2.0.1, we introduced several new capabilities for ArcGIS Online and ArcGIS Enterprise administrators via the new <\/span>arcgis.gis.sharing<\/span><\/a> submodule.\u202f With the new <\/span>invitations<\/span><\/i><\/a> property on any user object, you can administer accepting or declining of group invitations by your individual organization\u2019s users through the module’s classes. <\/span>Powerful additions to the <\/span>report<\/span><\/i><\/a> property and the new <\/span>provisions<\/span><\/a> method will make maintaining your licenses smooth as silk.\u00a0 Check out the full <\/span>2.0.1 release notes<\/span><\/a> for more details on organization administration.<\/span>\u00a0<\/span><\/p>\n

Content Management<\/span><\/b>\u00a0<\/span><\/h2>\n

Type hinting is here! We took the leap and added this functionality to further clean up the architecture for the API. Implementing type hints improves your experience by making explicit the types we\u2019re using and by weaning the API off any excessive dependency on multiple return types, overloaded methods, or duck typing. It took effort to add type hinting in order to modernize and improve the work of IDEs and Linters with the API,\u00a0 but you will find it totally worthwhile!<\/span><\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1652572,"id":1652572,"title":"Screen Shot 2022-07-04 at 14.58.09","filename":"Screen-Shot-2022-07-04-at-14.58.09.png","filesize":233150,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-14.58.09.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/api-python\/developers\/whats-new-in-arcgis-api-for-python-2-0-1\/screen-shot-2022-07-04-at-14-58-09","alt":"","author":"290632","description":"","caption":"Example of Type Hinting","name":"screen-shot-2022-07-04-at-14-58-09","status":"inherit","uploaded_to":1648802,"date":"2022-07-04 19:02:50","modified":"2022-07-04 19:03:13","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":2556,"height":1074,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-14.58.09-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-14.58.09.png","medium-width":464,"medium-height":195,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-14.58.09.png","medium_large-width":768,"medium_large-height":323,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-14.58.09.png","large-width":1920,"large-height":807,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-14.58.09-1536x645.png","1536x1536-width":1536,"1536x1536-height":645,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-14.58.09-2048x861.png","2048x2048-width":2048,"2048x2048-height":861,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-14.58.09-826x347.png","card_image-width":826,"card_image-height":347,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-14.58.09-1920x807.png","wide_image-width":1920,"wide_image-height":807}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Although we love to write Python code, we are a GIS company after all, and maps are central to everything we do.\u00a0 Therefore, we have added several new features such as the <\/span>configure_pop_ups()<\/span><\/a> and <\/span>view_bookmarks()<\/span><\/a> methods to improve the experience of working with web maps in the map widget.\u00a0 Stop hunting through your web map\u2019s data. Instead, access a method to make your pop-ups, well\u2026<\/span>POP! <\/span><\/i><\/b>And with view_bookmarks(),<\/span> a single method enables or disables that functionality, so combined with the <\/span>bookmarks<\/span><\/i><\/a>\u202fproperty, your web map visualizations are all that simpler to control.\u202f<\/span>\u00a0<\/span><\/p>\n

Huge additions to the <\/span>arcgis.apps.storymap<\/span><\/a> submodule really amp up your ability to automate your <\/span>StoryMapping<\/span><\/a>. Some behind-the-scenes security checks enable you to easily create multiple StoryMap objects. In addition, the <\/span>publish<\/span><\/i> argument within the <\/span>save()<\/span><\/a> method now lets you publish directly from where you\u2019re using the API. Plus, we reworked how the <\/span>map<\/span><\/a> node updates layers, so layer management is snappier than ever. Don\u2019t forget to check out the new <\/span>get()<\/span><\/a> method on the <\/span>Sidecar<\/span><\/a> to unlock full editing on that node. So good!<\/span>\u00a0<\/span><\/p>\n

Analysis and Data Science<\/span><\/b>\u00a0<\/span><\/h2>\n

In version 2.0.1, we listened to your feedback and added several enhancements and new functionalities related to the APIs’ analysis and data science capabilities.\u00a0 One of the main focus areas has been on creating better interoperability between ArcGIS Pro data (e.g. feature classes) and WebGIS data (e.g. hosted feature layers), and to improve data I\/O between ArcPy and the ArcGIS API for Python.\u00a0 Currently, this interoperability is mainly achieved using the Spatially Enabled DataFrame (SeDF), which is an easy way to convert feature classes\/feature layers to Pandas DataFrames, do your data wrangling and manipulation, then convert back to whatever GIS data model you require.<\/span>\u00a0<\/span><\/p>\n

In version 2.0.1, we also improved the type hinting when bringing feature layers in as SeDF such that it aligns better with the ArcGIS Pro geodatabase data model.\u00a0 We have also added the ability for the SeDF to directly ingest ArcGIS Pro layer objects, and improved the interoperability between the ArcGIS API for Python feature set and the ArcPy feature set.\u00a0 Going forward, we will continue to focus on implementing user suggestions and strengthening this interoperability story.\u00a0 <\/span>\u00a0<\/span><\/p>\n

Diving into the feature analysis tools, you\u2019ll see another great addition that will be helpful to many users.\u00a0 In version 2.0.1, several of the <\/span>feature analysis tools<\/span><\/a> now support overwrite as a key in the <\/span>context<\/span><\/i> parameter. When you set this key to True, you can overwrite an existing feature layer with the output of a feature analysis tool.\u00a0 We will continue to add support for overwrite in all other feature analysis tools in future releases. <\/span>\u00a0<\/span><\/p>\n

Last, we can\u2019t forget the <\/span>arcgis.learn module<\/span><\/a> of the API.\u00a0 The sheer amount of new capabilities in this module is far too extensive to include here, so check out our help documentation<\/a> for all new things in arcgis.learn.<\/span>\u00a0<\/span><\/p>\n

Documentation<\/span><\/b>\u00a0<\/span><\/h2>\n

One of first things you may notice when visiting the <\/span>ArcGIS API for Python documentation home page<\/span><\/a> is that it has a completely different look and feel than previous versions.\u00a0 Migrating the old documentation to this new framework is aimed at improving the user experience of working with the API, as well as making it visually consistent with all other ArcGIS Developer APIs (e.g. <\/span>ArcGIS API for JavaScript<\/span><\/a>, <\/span>ArcGIS Runtime API for .NET<\/span><\/a>, etc.).\u00a0 Many of the driving forces behind this migration have been based on your feedback and suggestions.\u00a0 Here are a few examples:<\/span>\u00a0<\/span><\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1652622,"id":1652622,"title":"Screen Shot 2022-07-04 at 15.01.22","filename":"Screen-Shot-2022-07-04-at-15.01.22.png","filesize":84884,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-15.01.22.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/api-python\/developers\/whats-new-in-arcgis-api-for-python-2-0-1\/screen-shot-2022-07-04-at-15-01-22","alt":"","author":"290632","description":"","caption":"Old documentation (left), new documentation (right)]","name":"screen-shot-2022-07-04-at-15-01-22","status":"inherit","uploaded_to":1648802,"date":"2022-07-04 19:24:36","modified":"2022-07-04 19:24:55","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":1453,"height":487,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-15.01.22-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-15.01.22.png","medium-width":464,"medium-height":156,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-15.01.22.png","medium_large-width":768,"medium_large-height":257,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-15.01.22.png","large-width":1453,"large-height":487,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-15.01.22.png","1536x1536-width":1453,"1536x1536-height":487,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-15.01.22.png","2048x2048-width":1453,"2048x2048-height":487,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-15.01.22-826x277.png","card_image-width":826,"card_image-height":277,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/07\/Screen-Shot-2022-07-04-at-15.01.22.png","wide_image-width":1453,"wide_image-height":487}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"