What's new in version 1.3


  • Added support to render and work with Vector Tile Layers in arcgis.mapping module with a new VectorTileLayer class.
  • Added ability to add text and archives as resource files to Items.
  • Added a find_outliers task to the arcgis.features.analysis module to locate features and clusters that differ significantly
  • Added support for Living Atlas Content
  • Added ability to select layers to add when creating new feature service from FeatureLayerCollection item
  • Added detect_track_incidents tool to the arcgis.geoanalytics.find_locations module
  • Added support for unfederated ArcGIS Server instances from the arcgis.gis.server module
  • Added ability to cancel Geoprocessing jobs with keyboard
  • Added ability to publish map services from Geoanalytics results for visualizing large spatiotemporal feature services
  • Added ability to login with a public account to ArcGIS Online
  • Added support for Dynamic Map Image Layers
  • Enhanced search capabilities to look for specific categories
  • Added ability to create Features from and convert features to geojson
  • Improved spatial refernce support when using arcgis.features.SpatialDataFrame
  • Improved function to export SpatialDataFrame by checking for required modules
  • Improved performance when creating Imagery Layers
  • Added new functions to raster.functions module. See here for function details
    • complex - computes magnitude from an input raster with complex pixel types
    • colormap_to_rgb - converts a single-band raster with a colormap to three-band raster
    • statistics_histogram - defines the statistics and histogram of a raster to help render output
    • tasseled_cap - analyzes certain multispectral datasets and calculates new bands useful to map vegetation and urban developmet changes
    • identity - default function required in a mosaic dataset if there is no other function
    • colorspace_converstion - converts the color model of a three-band unsigned 8-bit images from HSV or RGB, or vice versa
    • grayscale - converts a multi-band image into a single-band grayscale image
    • pansharpen - enhances spatial resolution of a multi-band image by fusing with higher-resolution panchromatic image
    • spectral_conversion - applies a matrix to affect the spectral values output by a multi-band image
    • raster_calculator - allows you to call all existing math functions for building expressions
    • speckle - filters a speckled radar dataset to smooth out noise
  • Added a new GeoEnrichment module
  • Added ability to set and configure the identity provider for managing user credentials
  • Added support for passing geometry columns into PySal functions
  • Added a new esri_access property to User objects so Esri training materials could be accessed
  • Added support for feeding SpatialDataFrame objects to GeoProcessing tools
  • A new SpatialDataFrame.plot() method to do bar, line and scatterplots
  • Added support for multi-part Polygon geometries in FeatureSet objects
  • Added support for creating Hosted Feature Layer Views
  • Added support for cloning items directly from the ContentManager
  • Added ability to directly read, write and author Web Maps from arcgis.mapping.WebMap objects
  • Added support for High Performance on geocoding and geoanalytics
  • Added geocode_locations tool in arcgis.geoanalytics.find_locations module
  • Added functionality to the ReconstructTracks and JoinFeatures in the arcgis.geoanalytics.summarize_data module
  • Added support for setting content status on Item objects


  • BUG-00010973 Using the "services.list()" function fails with Traceback error
  • BUG-000105897 When iterating over items from a non-existent folder, the Python API iterates over the ArcGIS Online root folder
  • BUG-000105969 When creating replicas, a json data format replica was not being created in the output directory
  • BUG-000109342 Errow when importing premium toolboxes using geoprocessing.import_toolbox function
  • Fixed FeatureSet issue so geometry type is set properly
  • Fixed issue where new datastores were not being returned from the servers.datastores.list() method
  • Fixed issue where querying a FeatureLayer with returnIDsOnly, returnCountOnly, and returnIdsOnly were not returning all records
  • Fixed issue where publishing from service definition files was not placing service items in folders
  • Fixed issue where no error was reported when creating a big data file share using an invalid path
  • Fixed issue when using the defaults for the arcgis.admin.System.reindex function
  • Fixed issue where publish_sd() function to publish from service definition files was not available
  • Fixed issue where Python API tried to use ArcGIS Online basemaps in a disconnected environment
  • Improved ability to save Features in non-English data
  • Fixed issue where creating a SpatialDataFrame from a feature class was not importing spatial reference correctly
  • Improved security on anonymous connections to ArcGIS Online
  • Fixed security issue using NTLM and Kerberos works with Python 3.6.1
  • Improved performance for download of Python API
  • Fixed issue where geometry extents were not properly returned which affected some projecting operations
  • Fixed issue where fields over 255 characters in length were not properly created
  • Fixed issue when updating the large thumbnail on an item the image was not updating to the proper type

What's new in version 1.2.4

A number of quality improvements were made in versions 1.2.3 and 1.2.4. Below is the list of bugs reported to Technical Support that were fixed:

  • BUG-000108063 ArcGIS Python API is unable to connect to Portal for ArcGIS with Integrated Windows Authentication configured.
  • BUG-000107899 In the ArcGIS Python API, cannot update the ArcGIS Online organization banner using the set_banner method when using a custom html string.
  • Added support for using the API behind proxy servers

What's new in version 1.2.2

Version 1.2.2 ensures the map widget in Jupyter notebooks continues to work with newer installs of the API.

What's new in version 1.2.1

Version 1.2.1 is a primarily a bug fix and documentation update release. Below is a non exhaustive list of bug fixes that were fixed:

  • Fix to ensure DataStoreManager.list() is updated when user adds, modifies or updates data stores.
  • BUG-000104664 ArcGIS API for Python fails to return the groupProviderName value
  • BUG-000105897 When iterating through items in a nonexistent folder using the ArcGIS Python API, items from the ArcGIS Online root folder are returned.
  • BUG-000105969 In ArcGIS Python API, using replicas.create() and data_format = 'json' is not able to create output in local directory when out_path is defined.
  • ENH-000106710 Automate the creation of Enterprise groups in ArcGIS Online and Portal using the ArcGIS API for Python.
  • Support for Living Atlas on ArcGIS Enterprise
  • Better error messages
  • BUG-000104664 ArcGIS API for Python fails to return the groupProviderName value.
  • BUG-000105270 returnAttachments is an invalid parameter and is repeated multiple times in the arcgis.features.managers module reference page for the Python API
  • Support for find_outliers tool
  • Support to add Item resources as text, URL and archive
  • Geocoding results can be returned as FeatureSet objects.
  • Support for publishing hosted tile layers from feature layers
  • Documentation for administering your GIS, administering your ArcGIS servers, building a distributed GIS, customizing your GIS look and feel are added.

What's new in version 1.2.0

Version 1.2 brings with it a slew of new capabilities. Below is a non exhaustive list of enhancements

  • A new arcgis.gis.admin sub module -- expands your admin capabilities, manage credits, create gis collaborations to build a distributed GIS, modify the user experience of the portal website
  • A new arcgis.gis.server sub module -- allows you to manage servers federated with your ArcGIS Enterprise
  • A new arcgis.raster.functions sub module for raster functions -- express raster functions as Python functions, chain them together and perform raster algebra using regular Python arithmetic operators
  • A new SpatialDataFrame class which extends your regular Pandas DataFrame with spatial capabilities and ability to work with local datasets
  • Feature layer improvements -- overwrite feature layers, better support for attachments
  • Map widget enhancements -- disable zoom when scrolling the notebook
  • oAuth login using app id, secret
  • A new GeoAnalytics tool to create space-time cubes

What's new in version 1.0.1

Version 1.0.1 is a bug fix release. Following are some of the bugs that were resolved:

  • BUG-000101507 gis.groups.search returns incorrect results if the User is an owner of more than 100 groups.
  • Enabled building initial cache when publishing vector tile packages
  • Fixed bug in creating new users on ArcGIS Online or Portal for ArcGIS 10.5 or newer
  • Fix to ignore values like size of -1 when initializing item objects
  • Reorder batch geocoding results to match input array

What's new in version 1.0.0

Ever since we released the public beta versions, your response to this API has been phenomenal. Since the last release of beta 3, the API went through a redesign phase. We took a critical look at the previous design and evaluated it against the ease of use, extensibility and our original goal of developing a Pythonic API for GIS. The result is this new design, a design that simply does not contour to the implementation logic, but efficiently abstracts it, ensuring the simplicity and beauty of the programming language prevails.

API design changes

The following are some of the high level changes you would notice in the version 1.0 of the API. You might have to update your notebooks and scripts and we apologize for this inconvenience.

  • Various layer types in arcgis.lyr module are now in their own separate modules such as arcgis.features, arcgis.raster, arcgis.network etc.
  • arcgis.viz is now arcgis.mapping with additional support for vector tiles, map image layers
  • Tools in arcgis.tools are accessible as functions in the corresponding layer modules. This allows a better grouping and presentation of tools making them available right alongside the layer types they process. For instance, the feature analysis tools available earlier as arcgis.tools.FeatureAnalysisTools is now arcgis.features.analyze_patterns, arcgis.features.enrich_data etc.
  • Big data analysis tools available earlier as arcgis.tools.BigData is now in a separate module arcgis.geoanalytics.

Enhancements and new features

This is by no means an exhaustive list. Below are some major enhancements you may notice in version 1.0 of the API

  • ability to work with replicas for feature layers
  • ability to manage user roles
  • support for multiple outputs in GP tools
  • support for stream layers
  • added more big data analysis tools in the arcgis.geoanalytics module
  • extended support for web tools
  • smart mapping improvements
  • extended ability to publish package items such as vector tile, scene, tile
  • enhanced support for login using ArcGIS Pro

Feedback on this topic?