v1.8.3<\/code> of the ArcGIS API for Python has been released. This release adds a slew of new features and capabilities.<\/p>\n\n- No time to read the full article? Scroll to the end for an 1 slide overview.<\/li>\n
- Want the complete list of new features? You can get them from the release notes.<\/a><\/li>\n
- Ready to try out the new API? You can upgrade\u00a0 by typing
conda upgrade -c esri arcgis<\/code> into your anaconda prompt.<\/li>\n<\/ul>\n","image_reference":false,"layout":"standard","image_reference_figure":"","snippet":"","spotlight_name":"","section_title":"","position":"Center","spotlight_image":false},{"acf_fc_layout":"image","image":{"ID":1093721,"id":1093721,"title":"python api over 2300 tools","filename":"python-api-over-2300-tools.jpg","filesize":186741,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/python-api-over-2300-tools.jpg","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/api-python\/developers\/whats-new-in-arcgis-api-for-python-v183\/python-api-over-2300-tools","alt":"Python API - over 2300 tools","author":"7141","description":"","caption":"The ArcGIS API for Python has grown into a vast library with over 2300 methods and functions!","name":"python-api-over-2300-tools","status":"inherit","uploaded_to":1093541,"date":"2020-12-18 07:45:07","modified":"2020-12-21 00:12:57","menu_order":0,"mime_type":"image\/jpeg","type":"image","subtype":"jpeg","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":1500,"height":844,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/python-api-over-2300-tools-213x200.jpg","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/python-api-over-2300-tools.jpg","medium-width":464,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/python-api-over-2300-tools.jpg","medium_large-width":768,"medium_large-height":432,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/python-api-over-2300-tools.jpg","large-width":1500,"large-height":844,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/python-api-over-2300-tools.jpg","1536x1536-width":1500,"1536x1536-height":844,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/python-api-over-2300-tools.jpg","2048x2048-width":1500,"2048x2048-height":844,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/python-api-over-2300-tools-826x465.jpg","card_image-width":826,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/python-api-over-2300-tools.jpg","wide_image-width":1500,"wide_image-height":844}},"image_position":"center","orientation":"horizontal","hyperlink":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/python-api-over-2300-tools.jpg"},{"acf_fc_layout":"content","content":"The picture above (presented at Python Libraries for Spatial Data Science<\/a> talk) distills some of the key capabilities of the API. At version 1.8.3, we have tried to enhance each of these aspects and this blog is a rundown of the top features.<\/p>\n"},{"acf_fc_layout":"content","content":"Framework improvements<\/h2>\n
One of the biggest improvements we performed behind the scenes was migrating the HTTP communication modules to use requests<\/strong><\/a> (a popular 3rd<\/sup> party module) from built-in urllib<\/code> module. There is no change to your scripts, except that now and going forward we can better support some of your custom and complex authentication systems. For JSON parsing, we switched to UltraJSON<\/strong><\/a>. <\/strong>Combined, we were able to improve support for fundamental features such as multipart uploads while extracting performance improvements. <\/strong>Apart from this, we have added support for Python 3.8, JupyterLab 1x, 2x and Pandas v1.0.<\/p>\nGIS Administration<\/h2>\n
ArcGIS Notebooks<\/a> and the Notebook Server<\/a> play a key role in enabling spatial data science capability of the ArcGIS Platform. The arcgis.gis.nb<\/strong><\/a> module has been enhanced allowing you to manage notebook servers. You can now inspect the instances that are running and their properties. This module also enables powerful workflows such as executing notebooks on demand and scheduling notebooks. In the future, we plan to support managing different versions of notebook items.<\/p>\nThere have been numerous small updates and fixes to other parts of the GIS administration API. When creating users, for instance, you can now use smart defaults you as an admin have defined for your org. A new AGOLUsageReports<\/strong><\/a> class allows better compilation of usage reports in ArcGIS Online, something our users have been asking for.<\/p>\nOn the security front, the API now supports authentication using API keys. This is a new login mechanism targeted toward GIS developers and you will be learning more about it in the coming months.<\/p>\n"},{"acf_fc_layout":"content","content":"
Content management<\/h2>\n
We are excited to introduce the new `arcgis.apps.dashboard<\/strong><\/a>`<\/strong> module that allows users to compose ArcGIS Dashboards apps<\/a> using Python! A lot of data scientists want a medium that is simpler than notebooks to communicate their results and we hope this module can help them quickly compose such apps.<\/p>\nContent migration and cloning is a very important workflow for our users, and we are happy to introduce a new \u2018GroupMigrationManager<\/a>\u2019<\/strong> workflow that allows group admins to migrate content from one group to another across organizations. Long term users of the API would be familiar with `clone_items<\/a>` function that is native to the Python API. It has been enhanced to support a slew of new app types along with various bug fixes.<\/p>\nThis release also adds new publishing workflows \u2013 such as publishing directly from content deposited into a data store and the ability to set desired item ids for certain workflows and environments.<\/p>\n
On the OGC and FOSS4G <\/strong>fronts, we have added a new `arcgis.mapping.ogc<\/strong><\/a>` sub-module to work with OGC layers. Another exciting development is the ability to directly read in-memory GeoPandas GeoDataFrame<\/a> objects into ArcGIS! The API now supports reading geopackage files and newer columnar file formats like feather<\/a>. We are researching some of these new patterns to increase the performance of the Spatially enabled DataFrame (SeDF) objects.<\/p>\n"},{"acf_fc_layout":"content","content":"Spatial analysis<\/h2>\n
Let\u2019s talk about Spatially enabled DataFrames (SeDF)<\/strong>. You can now pass SeDF objects as inputs to spatial analysis tools. This allows you to easily enable data engineering workflows to use the powerful spatial analysis tools available as ready-to-use tools on your web GIS. Another feature is the ability to sanitize column names<\/a> before saving the DataFrame. SeDF objects now support a new `renderer<\/a>` property to store symbology or drawing info. When you read a feature layer<\/a>, the renderer will now pick up the symbology defined on that web layer and utilize that to visualize the layer on a map. You can override it with your custom symbols at any time.<\/p>\nNow almost all web tools in Python API support asynchronous processing<\/strong>. Async processing allows you to submit big and long running tasks to the server and get back a GPJob<\/a> object. This essentially frees up the Python kernel, allowing you to run subsequent commands while the server keeps working on the submitted job. You can poll the job object anytime to know the status or cancel the job.<\/p>\n"},{"acf_fc_layout":"content","content":"Raster analysis<\/h2>\n
While raster is part of spatial analysis section covered above, a lot of work went into it that we thought it warrants a new section of its own. In major news, we added two new classes \u2013 `Raster<\/strong><\/a>`<\/strong> and `RasterCollection<\/strong><\/a>` that allows you to work with a wide variety of imagery data in a seamless manner. You can read and work with local file-based raster data just as well as those published as imagery layers (services). When you read local raster data, the API chooses ArcPy as the processing engine and if you read an Image service, it uses the ArcGIS Image Server as the back-end engine. This allows users to work with one API immaterial of where the data is stored and processed in the back-end.<\/p>\nA slew of new raster functions and distributed raster analytics tools for applications such as trend analysis, multidimensional analysis, change detection etc. have been added.<\/p>\n
Deep Learning<\/h2>\n
A significant feature of the API is its ability to train deep learning models for geospatial applications using the `arcgis.learn<\/strong><\/a>` module. The API now supports over 30 models for various advanced workflows. These models can work with a wide variety of data such as planimetric & oriented imagery, point cloud, feature, tabular, time-series data and unstructured text<\/a>. This release adds models for key workflows such as edge detection<\/a>, change detection<\/a>, road extraction<\/a> and image translation<\/a>.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1095181,"id":1095181,"title":"geospatial ai in arcgis","filename":"arcgis-ai-2020.jpg","filesize":143435,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/arcgis-ai-2020.jpg","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/api-python\/developers\/whats-new-in-arcgis-api-for-python-v183\/arcgis-ai-2020","alt":"geospatial ai in arcgis","author":"7141","description":"","caption":"Geospatial AI in ArcGIS","name":"arcgis-ai-2020","status":"inherit","uploaded_to":1093541,"date":"2020-12-20 22:45:07","modified":"2020-12-20 22:45:36","menu_order":0,"mime_type":"image\/jpeg","type":"image","subtype":"jpeg","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":1920,"height":1080,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/arcgis-ai-2020-213x200.jpg","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/arcgis-ai-2020.jpg","medium-width":464,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/arcgis-ai-2020.jpg","medium_large-width":768,"medium_large-height":432,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/arcgis-ai-2020.jpg","large-width":1920,"large-height":1080,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/arcgis-ai-2020-1536x864.jpg","1536x1536-width":1536,"1536x1536-height":864,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/arcgis-ai-2020.jpg","2048x2048-width":1920,"2048x2048-height":1080,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/arcgis-ai-2020-826x465.jpg","card_image-width":826,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/arcgis-ai-2020.jpg","wide_image-width":1920,"wide_image-height":1080}},"image_position":"center","orientation":"horizontal","hyperlink":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/arcgis-ai-2020.jpg"},{"acf_fc_layout":"content","content":"A new computer-vision model allows users to go from scanned paper maps to georeferenced vector layers<\/a>! This release challenges the somewhat common myth in geospatial industry that deep learning is best suited only for imagery data by forging ahead with models that work on tabular and time-series data<\/a>. The `<\/strong>FullyConnectedNetwork<\/strong><\/a>` <\/strong>model allows you to feed tabular and raster layers into a deep neural network, letting it learn and model even the most complex of patterns. The `<\/strong>TimeSeriesModel<\/strong><\/a>` <\/strong>allows you to perform time-series forecasting.<\/p>\nThe new `<\/strong>MLModel<\/strong><\/a>` <\/strong>class allows you to integrate machine learning models from the popular scikit-learn<\/a> library and the new `arcgis.learn.text<\/strong><\/a>` submodule now houses a number of models for natural language processing (NLP). What does NLP have to do with GIS you ask? For starters, you can extract addresses and location information from unstructured text<\/a>, predict missing parts of an incomplete address<\/a>, and auto-correct errors in addresses making them suitable for geocoding.<\/p>\nTo simplify the installation of the libraries and frameworks needed to light up deep learning, we have added new deep learning installers<\/a> for ArcGIS Pro and Enterprise and a new conda metapackage<\/a> for independent installation.<\/p>\nA significant addition around this release is the availability of ready-to-use<\/strong> deep learning models in Esri Living Atlas<\/a>. Since these models have been previously trained by Esri, you can skip over the tedious and data-intensive task of cleaning and preparing large volumes of data necessary to train your models or procuring the hardware necessary for such tasks. You can download the models and proceed to perform inference.<\/p>\n"},{"acf_fc_layout":"content","content":"Mapping and visualization<\/h2>\n
The map widget in Jupyter notebooks can now link with other map widgets in the same notebook. You can thus synchronize navigation<\/a> between two or more widgets allowing you to load and visualize different layers side by side for the same extent. Once linked any interaction in one of the linked maps will cause other maps to follow suit as shown in the animation below.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1095191,"id":1095191,"title":"three 2D widgets sync 1080p 90fms","filename":"three-2D-widgets-sync-1080p-90fms.gif","filesize":1476769,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/three-2D-widgets-sync-1080p-90fms.gif","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/api-python\/developers\/whats-new-in-arcgis-api-for-python-v183\/three-2d-widgets-sync-1080p-90fms","alt":"","author":"7141","description":"","caption":"The map widgets now support synchronized navigation","name":"three-2d-widgets-sync-1080p-90fms","status":"inherit","uploaded_to":1093541,"date":"2020-12-20 23:03:23","modified":"2020-12-21 06:26:02","menu_order":0,"mime_type":"image\/gif","type":"image","subtype":"gif","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":1080,"height":567,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/three-2D-widgets-sync-1080p-90fms-213x200.gif","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/three-2D-widgets-sync-1080p-90fms.gif","medium-width":464,"medium-height":244,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/three-2D-widgets-sync-1080p-90fms.gif","medium_large-width":768,"medium_large-height":403,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/three-2D-widgets-sync-1080p-90fms.gif","large-width":1080,"large-height":567,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/three-2D-widgets-sync-1080p-90fms.gif","1536x1536-width":1080,"1536x1536-height":567,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/three-2D-widgets-sync-1080p-90fms.gif","2048x2048-width":1080,"2048x2048-height":567,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/three-2D-widgets-sync-1080p-90fms-826x434.gif","card_image-width":826,"card_image-height":434,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/three-2D-widgets-sync-1080p-90fms.gif","wide_image-width":1080,"wide_image-height":567}},"image_position":"center","orientation":"horizontal","hyperlink":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/three-2D-widgets-sync-1080p-90fms.gif"},{"acf_fc_layout":"content","content":"You are not limited to linking just 2D maps. The synced navigation works just as well between 2D and 3D modes of widgets allowing you to easily view both perspective and planimetric rendering of the same study area.<\/p>\n
By now, you must be familiar with the ability to take screenshots<\/a> of your map widgets. While screenshots embed a static version of the map as an image in the notebook, with this release, you can embed live, interactive versions<\/a> of the map. Thus, when you export your notebook as a HTML file, you now have the ability to choose whether to embed your maps as static images or as dynamic web maps. When the map in a notebook is just not big enough to fully appreciate the geography, you can use the existing export to HTML function<\/a> to generate a full size web page of your map.<\/p>\nDid I mention you can load local file-based raster files on the map widget? Yes, you can now simply add the new Raster class as a layer to your maps and easily visualize your imagery and raster data.<\/p>\n
Fans of JupyterLab IDE? We now support versions 1x and 2x of lab and you can now search for the \u2018arcgis\u2019 extension within the lab and install it without breaking a sweat. JupyterLab is a cool new interface and I recommend you check it out<\/a> if you haven\u2019t already.<\/p>\nDocumentation<\/h2>\n
The year 2020 has been a very busy year for us in terms of documentation. We started on a mission to overhaul some of our older guides and replace them with comprehensive, tutorial style notebooks. So far, we have rewritten guides for network analysis<\/a>, GeoEnrichment<\/a>, orthomapping<\/a> and the geometry<\/a> modules. You\u2019ll notice these guides begin by providing sufficient foundational information followed by a layout diagram which describes what different parts of the module are and how they work with rest of the API. These guides are also numbered in parts, demonstrating a clear progression for our new users.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":1095221,"id":1095221,"title":"python api-guides-newstyle","filename":"pythonap-guides-newstyle.png","filesize":152296,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/pythonap-guides-newstyle.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/api-python\/developers\/whats-new-in-arcgis-api-for-python-v183\/pythonap-guides-newstyle","alt":"","author":"7141","description":"","caption":"On-going documentation improvements feature guides with object model diagrams, comprehensive workflows and tutorial style progression.","name":"pythonap-guides-newstyle","status":"inherit","uploaded_to":1093541,"date":"2020-12-21 00:06:38","modified":"2020-12-21 00:08:29","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":1070,"height":1125,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/pythonap-guides-newstyle-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/pythonap-guides-newstyle.png","medium-width":248,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/pythonap-guides-newstyle.png","medium_large-width":768,"medium_large-height":807,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/pythonap-guides-newstyle.png","large-width":1027,"large-height":1080,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/pythonap-guides-newstyle.png","1536x1536-width":1070,"1536x1536-height":1125,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/pythonap-guides-newstyle.png","2048x2048-width":1070,"2048x2048-height":1125,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/pythonap-guides-newstyle-442x465.png","card_image-width":442,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/pythonap-guides-newstyle-1027x1080.png","wide_image-width":1027,"wide_image-height":1080}},"image_position":"center","orientation":"horizontal","hyperlink":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/pythonap-guides-newstyle.png"},{"acf_fc_layout":"content","content":"We have also embarked on a long-term project to improve the API reference by adding contextual snippets for parameters, cross referencing keywords, adding schematic images for certain tools and example Python scripts.<\/p>\n
"}],"related_articles":[{"ID":1035891,"post_author":"6911","post_date":"2020-10-13 11:49:30","post_date_gmt":"2020-10-13 18:49:30","post_content":"","post_title":"Introducing pretrained geospatial deep learning models","post_excerpt":"","post_status":"publish","comment_status":"open","ping_status":"closed","post_password":"","post_name":"introducing-ready-to-use-deep-learning-models","to_ping":"","pinged":"","post_modified":"2021-11-19 09:09:52","post_modified_gmt":"2021-11-19 17:09:52","post_content_filtered":"","post_parent":0,"guid":"https:\/\/www.esri.com\/arcgis-blog\/?post_type=blog&p=1035891","menu_order":0,"post_type":"blog","post_mime_type":"","comment_count":"0","filter":"raw"}],"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/solving-spaital-problems.jpg","wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2020\/12\/key-capabilities-plain.jpg"},"yoast_head":"\n