What's new in version 2.4.4

New

• New Module:
  • arcgis.gis.video
    • Provides classes, methods and properties for administration capabilities on ArcGIS Video Server
• Beta Transtion
  • arcgis.raster.realitymapping
    • ArcGIS Reality Server product transitioned from beta to General Availability
      • note: Scripts written in 2.4.3 may need modified to accommodate necessary API changes based on overall product updates.

Guides

• New Subheading:
  • Introduction to gis module
    • The gis module
• Spatial Analysis
  • Raster Analysis
    • Reality Mapping
      • Introduction to Reality Mapping
      • Create 2D Digital Aerial Imagery Products
      • Create 3D Digital Aerial Imagery Products
      • Create True Ortho and Digital Surface model from Drone imagery
      • Create True Ortho and Digital Surface Model Product from Satellite Imagery
• AI Capabilities
  • Introduction to AI-Powered services
• Administration
  • Managing ArcGIS Applications
    • Working with Knowledge Graphs
      • Part 4 - Create Replicas and Synchronize Changes

Module Changes

arcgis.gis

• User
  • reassign_to()
    • BUG-000185255 Fixes issue where method inadvertently reassigned groups the user was a member of and not just groups owned by the user to the target_username
  • update()
    • New Parameters:
      • password
• UserManager
  • New methods:
    • all()
      • Adds ability to return all users when total in organization exceeds 10000
  • search()
    • Updates documentation note to specify number of users returned if no argument entered for query
    • Improves performance with updates to internal caching mechanism
• OfflineContentManager
  • export_items()
    • Updates internal logic to better define item structures to enable capability of export of most item types
    • New parameters:
      • run_async
      • async_workers
  • import_content()
    • New parameters:
      • run_async
      • async_workers
• Item
  • publish()
    • BUG-000184773 Improves performance with removal of unnecessary internal processing calls
• SharingManager
  • Public Repo Issue 2335 Improves performance with internal processing updates for:
    • shared_with
    • sharing_level
  • • sharing_level
    • Adds security protection to prevent sharing Datastore items publicly
• ItemProperties
  • Updates to internal processing for more accurate conversion between data objects and reading of object values
• ItemTypeEnum
  • Deprecates the TILES_PACKAGE_3D member in favor of new options
  • New Members:
    • TILES_PACKAGE_3D_GAUSSIAN
    • TILES_PACKAGE_3D_OBJECT
    • TILES_PACKAGE_3D_MESH
• PortalDataStore
  • publish()
    • New Parameters:
      • item_id

arcgis.gis.admin

• Updates internal processing of how admin property is assessed for users to better provide correct access for custom roles
• MapSettings
  • web_styles()
    • New Parameters:
      • ENH-000183856 two_dimensional_sketch_map
• SecuritySettings
  • New Methods:
    • set_app_signin_settings()
  • New Properties:
    • approved_apps
  • Deprecates the following methods and scheduled removal from next release:
    • set_approved_apps()
    • set_blocked_apps()
  • set_anonymous_access_notice()
    • New Parameters:
      • enabled
• DeveloperCredential
  • Updates reference documentation

arcgis.gis.agonb

• Adds numerous code examples to various Class initializers and methods
• Adds documentation for:
  • Container
  • AGORuntime
  • SnapShot
• InstancePreference
  • Deprecates class and schedules for removal at the next release
• AGOLNotebookManager
  • instance_preferences
    • Deprecates property and schedules removal at the next release
• ContainerManager()
  • list()
    • New Parameters:
      • as_dict

arcgis.gis.nb

• Updates to numerous areas of the API Reference documentation, including code examples

arcgis.gis.workflowmanager

• WorkflowManagerAdmin
• New Methods:
  • webhook_connection()
  • create_webhook_connection()
  • update_webhook_connection()
  • delete_webhook_connection()
• New Properties:
  • webhook_connections
• Improves performance by adding asynchronous processing to internal functions:
  • create_item()
  • upgrade_item()
• Job_Manager
  • create()
    • Updates extended_properties parameter documentation to specific argument as dictionary or list of dictionaries

arcgis.gis.video

** New Submodule **

• Provides administrative capabilities for ArcGIS Video Server sites. See Work with ArcGIS Video Server administrator options for information on what API can help automate.

arcgis.features

• Updates to class initialization methods
• New Submodule:
  • arcgis.features.models
    • EstimateResult
      • Adds class to function as return result when using setting the estimate argument to True for geoprocessing functions
• FeatureLayer
  • query_top_features()
    • New parameters:
      • return_count_only
  • append()
    • Adds more comprehensive error messaging

arcgis.features.analysis

• Adds documentation for new return type when estimate=True for any functions that support it

arcgis.features.analyze_patterns

• New Functions:
  • eight_twenty_analysis()

arcgis.features.managers

• Adds numerous code examples for initializing manager objects and running various operations
• New Enumerations:
  • FilterScopeEnum
  • TraversibilityScopeEnum
• ParcelFabricManager
  • Adds code examples to reference documentation
• AttachmentManager
  • add()
    • New Parameters:
      • gid - Addresses Public Repo Issue 2395

arcgis.features.enrich_data

• enrich_layer()
  • New Parameters:
    • travel_direction

arcgis.raster

• ImageSource
  • Updates supported raster_type_name list:
    • Removes Aerial
    • Adds Altum, RedEdge
  • Adds support for spatial reference
• RasterCollection
  • from_stac_api()
    • Enhances context parameter with 3 new options:
      • paginationMode
      • maxItems
      • maxPages
    • Enhances query parameter so that the bbox option accepts FeatureLayer and Geometry objects

arcgis.raster.analytics

• New Functions:
  • derive_stream_as_line()
  • derive_stream_as_raster()
  • geomorphon_landforms()

arcgis.raster.functions.gbl

• Numerous updates to API Reference documentation, particularly adding code examples for many functions

arcgis.raster.realitymapping

• ArcGIS Reality Server product transitioned from beta to General Availability
  • note: Scripts written in 2.4.3 may need modified to accommodate necessary API changes based on overall product updates.
  • Mission
    • reconstruct_surface()
      • Updates to documentation to clarify output types
      • RAPID added as an option for the quality argument

arcgis.network

• LocateSettings
  • Updates internal format and processing

arcgis.geometry

• Adds *deprecation notice that Geometry objects will no longer inherit from the Python dictionary object, so bracket notation will no longer be supported

arcgis.layers

• Working with Map Service Layers
  • MapImageLayer
  • TileLayer
  • VectorTileLayer
  • VectorTileLayerManager
    • edit_tile_service()

arcgis.map

• New Classes:
  • BaseGroup
  • Map Classes
    • LayerOptions
  • Popups
    • PointGeometry
  • Forms
    • FormChoice
    • FormMulipleChoiceInput
    • FormOtherChoice
• New API Reference Section:
  • Smart Mapping
    • Reorganized module with dataclasses for data validation of inputs and outputs, and standardization for renderer creation. See API Reference for full documentation.
  • Smart Mapping Enumerations
    • New objects to use as input arguments for various Smart Mapping methods. See API Reference for full documentation.

arcgis.apps

• New Beta features:
  • mapshowcase
• workforce
  • Announces deprecation of entire module and notes its removal from the API as Fall 2027
• storymap
  • New Classes:
    • Credits
  • New Methods:
    • content_info() - Added to numerous classes within the module for extracting the contents of complex components for easy visualization of content
      • See StoryMap.content_info()
      • Also added to Sidecar, MapTour, Timeline, Briefing
  • Collection
    • update_content_info()
      • New Parameters:
        • thumbnail
• itemgraph
  • New Classes:
    • GraphItemProperty
  • create_dependency_graph()
    • New Parameters:
      • include_services
      • run_async
      • async_workers
    • ENH-000178652 Adds warnings and enhances function to accommodate ArcGIS Online updates to handling of relationship types
  • load_from_file()
    • New Parameters:
      • run_async
  • ItemGraph
    • to_knowledge_graph()
      • New Parameters:
        • item_properties

arcgis.ai

• Adds note to the reference documentation about current beta status and pricing information for when services transition to General Availability
• New Functions:
  • image_extract_text()
  • analyze_file()
  • transcribe_audio()
  • generate_speech()
• New Dataclasses:
  • ExtractTextResult
  • TranscribeAudioResult
  • GenerateSpeechResult

arcgis.learn

• Adds ViTAdapter support to segmentation models for transformer-based backbones
• Data Preparation Methods
  • prepare_data()
    • New Keyword argument options:
      • valid_path
      • test_path

Fixes

Guides

Samples

Module Changes

arcgis.gis

• GIS
  • Updates error messaging if entering a non-existent profile for the profile argument
• Item
  • move
    • Public Repo Issue 2532Fixes error when attempting to move item to the Root folder
  • update()
    • Fixes issue when setting properties to None was not properly clearing values
  • copy_feature_layer_collection()
    • Fixes Invalid Definition error if there are relationships set
• ContentManager
  • clone_items()
    • ENH-000178319 Updates method to preserve _content_status, delete protection, and migrate categories
• User
  • Fixes issue in Jupyter Lab notebooks where code completion was not available
• UserManager
  • search()
    • BUG-000183570 Fixes issue that more than 10000 users could not be returned by providing a new all() method
• Folder
  • add()
    • BUG-000186625 Fixes issue where large file uploads were failing to configure valid item from all parts
    • Fixes UnboundLocalError for "calculate_upload_size" when setting stream=False
  • list()
    • Fixes issue iterating over items if any orphaned items are in the folder

arcgis.gis.admin

• DeveloperCredential
  • generate_token()
    • Fixes issue where other API Key was deleted when providing the slot argument
• LicenseManager
  • bundles
    • Public Repo Issue 2519 Fixes incorrect results returned when more than 10000 users are assigned the bundle
• SecuritySettings
  • Public Repo Issue 2518
    • Fixes error when setting following properties to empty list:
      • allowed_redirect_uris
      • allowed_origins
• Webhook
  • update()
    • BUG-000186528 Fixes error returned when setting events argument to ALL

arcgis.gis.agonb

• Container
  • shutdown()
    • Updates return value

arcgis.features

• FeatureLayer
  • get_unique_values()
    • Public Repo Issue 2534 Fixes issue where duplicate values were being returned on queries of thousands of features
  • query()
    • Fixes issue where queried with return_distinct_values=True were entering into an infinite loop
• Spatially Enabled DataFrame (GeoAccessor)
  • to_parquet()
    • [Public Repo Issue 2499}(https://github.com/Esri/arcgis-python-api/issues/2499) Fixes TypeError resulting from improper handling of internal metadata
  • area
    • Fixes issue where negative values returned for polygons with holes in an environment with ArcPysx
• FeatureSet
  • to_geojson()
  • Public Repo Issue #2490 Fixes Key Error when used on Multipoint geometry

arcgis.features.managers

• AttachmentManager
  • search()
    • BUG-000160369 Fixes issue where return_metadata=True did not return all EXIF information
  • download()
    • **Public Repo Issue #2479 Removes reference to return_all argument from the attachment_id parameter description and updates code to properly return all attachments if no attachment_id is provided
• FeatureLayerCollectionManager
  • create_view()
    • BUG-000184553 Fixes issue that if using the view_layers argument, the sublayer is removed from the source feature layer item

arcgis.features.analysis

• Updates API Reference with code examples for numerous functions

arcgis.raster.realitymapping

• ArcGIS Reality Server product transitioned from beta to General Availability
  • note: Scripts written in 2.4.3 may need modified to accommodate necessary API changes based on overall product updates.
  • Project
    • Fixes issue when using AERIAL_DIGITAL for the sensor_type argument

arcgis.notebook

• NotebookJob
  • running()
    • Fixes issue on ArcGIS for Kubernetes where a currently running job was returning False

arcgis.geometry

• Fixes invalid literal ValueError when setting ARCGIS_IO_ENGINE to Shapely

arcgis.geoprocessing

• import_toolbox()
  • Fixes failure to import toolboxes from ArcGIS Online that were created by Model Builder

arcgis.layers

• Working with Map Service Layers
  • VectorTileLayerManager
    • edit_tile_service()
      • Fixes Invalid Service Definition error when attempting to update properties

arcgis.map

• Improves performance with load times for:
  • Map
  • Scene

arcgis.apps

• storymap
  • Storymap
    • save
      • Fixes issue where typeKeywords property for items was not being update correctly
• itemgraph
  • create_dependency_graph()
    • Updates handling of service URLs to create more accurate and comprehensive graphs
    • Updates processing to better distinguish between GUID and Item ID values
• expbuilder
  • WebExperience
    • save()
      • BUG-000185104 Fixes issue where saving a cloned Experience item carried over the source-<item_id> keyword, causing subsequent clones of the original item to fail

arcgis.learn

• Automated Machine Learning
  • AutoML
    • Fixes memory, redundant downloading, and ambiguity issues with Geometry output when using location embeddings
    • Fixes training failure when using a blob embedding field as explanatory variables
• Feature, Tabular, and Timeseries Models
  • TimeSeriesModels
    • fit()
      • Fixes AttributeError regarding DynamicCache and from_legacy_cache because of change in Transformers in environment
• Unstructured Text Models
  • Fixes AttributeError regarding batch_encode_plus when using fit() on various methods
  • arcgis.learn.text module
    • EntityRecognizer
      • Fixes memory issue for Living Atlas DLPK