What's new in version 2.4.4

New

• New methods and objects added to arcgis.ai module
  • Accesses beta ArcGIS Online services for analyzing files, extracting text from images, transcribing audio files and generating synthesized speech
• New Rust-powered arcgis-geometry package
  • Processes geometry object operations with a Rust engine for faster performance and more secure, reliable memory management
  • Installed by default in 2.4.4 environments adn requires no code updates
  • Client-side processing removes need to have the ArcPy library for some methods
• 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.
• OfflineContentManager
  • Support for KnowledgeGraph items added to import and export methods
  • Support for running methods asynchronously to boost performance
• arcgis.gis.graph
  • Support for Synchronization functionality added

Guides

• New Subheading:
  • AI Capabilities
    • Introduction to AI-Powered services
• Introduction
  • 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
• Administration
  • Managing ArcGIS Applications
    • Working with Knowledge Graphs
      • Part 4 - Create Replicas and Synchronize Changes

Module Changes

arcgis.gis

• Updates processing for private, internal functions to avoid unnecessary processing and private URL resolution
• Public Repo Issue #2542 Adds warning messages when configuring environments specifically with gdal library
• User
  • 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
• ContentManager
  • create_service()
    • New Parameters:
      • groups - Works to share service with groups if access is set to shared in the item_properties
• OfflineContentManager
  • Adds support for KnowledgeGraphs as items that can be exported and imported
  • 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
  • update()
    • New Parameters:
      • groups - Works to share service with groups if access is set to shared in the item_properties
• SharingManager
  • Public Repo Issue 2335 Improves performance with internal processing updates for:
    • shared_with
    • 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
• ViewManager
  • create_join_layer()
    • Adds reference documentation specifying return type
  • get_definitions()
    • Adds reference documentation specifying return value when operation is run on item that is not a view service
  • update()
    • Adds reference documentation specifying return value

arcgis.gis.admin

• Updates internal processing of how admin property is assessed for users to better provide correct access for custom roles
• New Classes:
  • AIManager
• New Enumerations:
  • AICapability
• 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
• UX
  • New Properties:
    • ai - includes note about beta status of AI features
• Kubernetes
  • LogManager
    • query()
      • Updates internal logic so start_time and end_time properly handle string and datetime.datetime values

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.mission

• LogManager
  • query()
    • Updates internal logic so start_time and end_time properly handle string and datetime.datetime values

arcgis.gis.nb

• WebAdaptorManager
  • Adds code examples for properties and methods
  • config
    • Raises RuntimeError when the configuration update endpoint returns an unsuccessful or unexpected status response
• WebAdaptor
  • Adds code examples for properties and methods
• LogManager
  • query()
    • Updates internal logic so start_time and end_time properly handle string and datetime.datetime values
• SiteManager
  • Adds code example for object initialization
• Runtime
  • Adds initialization code example
  • Adds text and code examples to properties and methods
• DirectoryManager
  • Adds explanation and object initialization code example

arcgis.gis.workflowmanager

• New Classes:
  • WebhookConnection
• 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
• Updates code examples to include import statements, data retrieval and other context before calling functions

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
• FeatureLayerCollectionManager
  • insert_layer()
    • New Parameters:
      • location_type - Addresses Public Repo Issue #2357
• TraceConfiguration
  • Updates architecture from Python class to Pydantic data model (non-breaking change)
  • Updates reference documentation

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
      • New Parameters:
        • output_products
    • compute_sensor_model()
      • Updates documentation for the context parameter description

arcgis.network

• LocateSettings
  • Updates internal format and processing

arcgis.network.analysis

• New Functions:
  • solve_last_mile_delivery()
• Updates API Reference documentation with code examples for most functions

arcgis.geometry

• Updates internal processing on object methods to use the new Rust-powered arcgis-geometry package
  • faster performance
  • more efficient memory management
  • more secure and reliable processing
• Adds deprecation notice that Geometry objects will no longer inherit from the Python dictionary object, so bracket notation will no longer be supported

arcgis.graph

• KnowledgeGraph
  • New Methods:
    • create_replica()
    • get_replica_definition()
    • synchronize_replica()
    • unregister_replicas()
  • New Properties:
    • replicas
  • Beta Helper Functions:
    • _create_graph_from_replica()
    • _update_from_graph_replica()
  • query_streaming()
    • New Parameters:
      • as_df
  • Adds support for Replica-Synchronization:
    • New Reference Documentation:
      • Replica-Synchronization Types
        • Includes New Classes:
          • ReplicaData
        • Additional data models

arcgis.layers

• Working with Map Service Layers
  • Updates reference documentation with explanations, initialization parameter tables and code examples for:
    • MapServiceLayer
    • MapFeatureLayer
    • MapRasterLayer
    • MapImagerLayer
    • MapImageLayerManager
  • EnterpriseMapImageLayer
    • New Methods:
      • Adds support for cache management workflows
        • create_cache_schema()
        • delete_cache()
        • update_tiles()
    • Updates documentation and internal logic for:
      • build_cache()

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
• survey123
  • Survey
    • upgrade_survey()
      • Updates method to support ArcGIS Survey 123 Mobile

arcgis.ai

• Adds note to the reference documentation about current beta status and pricing information for when services transition to General Availability
• Enhances error handling and checks for organization settings and user permissions when using AI Services
• New Functions:
  • image_extract_text()
  • analyze_file()
  • transcribe_audio()
  • generate_speech()
• New Dataclasses:
  • ExtractTextResult
  • TranscribeAudioResult
  • GenerateSpeechResult

arcgis.learn

• New Models:
  • Pixel Classification Models
    • TinyUNetClassifier
• Adds ViTAdapter support to segmentation models for transformer-based backbones
• Improves performance with internal processing changes when no band data is available for modalities if using models with terramind backbones
• Data Preparation Methods
  • prepare_data()
    • New Keyword argument options:
      • valid_path
      • test_path
• Object Detection Models
  • Adds support for new timm backbones
  • YOLOv3
    • Adds format data/label support for bounding boxes and RGB only
• Pixel Classification Models
  • Adds support for new timm backbones
• Image Translation Models
  • SuperResolution
    • Enhances performance and results with adaptations for translating pixels
• Feature, Tabular, and Timeseries Models
  • MLModel
    • Deprecates the use of TabPFN model types (import tabpfn may fail). Note added to model_type parameter description.

arcgis.datapipelines

• Adds support for using in ArcGIS Enterprise
  • Removes documentation references to product only being supported in ArcGIS Online

Fixes

Module Changes

arcgis.gis

• GIS
  • Updates error messaging if entering a non-existent profile for the profile argument
• Item
  • move
    • Public Repo Issue 2532 Fixes 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
  • delete()
    • Public Repo Issue #2539 Fixes TypeError: 'NoneType' object is not iterable' error when setting dry_run=True for a Code Attachment item
• ContentManager
  • clone_items()
    • ENH-000178319 Updates method to preserve _content_status, delete protection, and migrate categories
  • create_service()
    • BUG-000186870 Fixes AttributeError: 'SharingGroupManager' object has no attribute 'update' error when setting access:shared in the item_properties argument. See new groups parameter for ContentManager.create_service() and Item.update()
• User
  • Fixes issue in Jupyter Lab notebooks where code completion was not available
  • 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
• 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.server

• LogManager
  • query()
    • Fixes incorrect output when setting export=True while also not setting an out_path

arcgis.gis.agonb

• Container
  • shutdown()
    • Updates return value

arcgis.gis.mission

• LogManager
  • query()
    • Fixes incorrect output when setting export=True while also not setting an out_path

arcgis.gis.nb

• LogManager
  • query()
    • Fixes incorrect output when setting export=True while also not setting an out_path

arcgis.features

• Feature
  • from_dict()
    • Fixes incorrect data type listed for feature argument
• 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 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
  • insert_layer()
    • Public Repo Issue #2357 Fixes IndexError where method fails if any table objects are present in the Feature Service

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
    • create_mission()
      • Fixes error where gis argument was not being read correctly
    • missions
      • Fixes TypeError: string indices must be integers, not 'str'` error when accessing property

arcgis.notebook

• NotebookJob
  • running()
    • Fixes issue on ArcGIS for Kubernetes where a currently running job was returning False
• get_secret()
  • Fixes internal processing for default value when returning Notebook secrets

arcgis.geometry

• Fixes invalid literal ValueError when setting ARCGIS_IO_ENGINE to Shapely
• centroid
  • Fixes issue where incorrect value was returned in ArcPy environments

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()
      • Public Repo Issue #2454 Fixes Invalid Service Definition error when attempting to update properties
  • EnterpriseVectorTileLayerManager
    • edit()
      • Fixes issue where export_tiles_allowed key was not recognized when entered in the service_dictionary argument
  • MapImageLayer
    • export_tiles()
      • Fixes missing parameter on internal processing functions so requests are propertly formatted

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
• survey123
  • Fixes issue in disconnected environments where create() and publish() calls were attempting to access external internet

arcgis.learn

• Fixes transformer-backbone routing regressions that were causing no-data reload failures and DOFA-related shape/channel mismatches
• Fixes performance issues when using PyTorch for training jobs that can start using shared GPU memory after dedicated VRAM is exhausted
• Data Preparation Methods
  • prepare_data()
    • Fixes incorrect method results when using hrs_each_step argument for ClimaX models
• 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
• Object Classification Models
  • FeatureClassifier
    • fit()
      • Fixes failure during the learning rate finder caused by CUDA device mismatch between GPUs
• Pixel Classification Models
  • Fixes issue where internal test time augmentation processing was occurring when not explicitly directed to
  • UnetClassifier
    • Fixes computation burden when using vision transformers
• Image Translation Models
  • Fixes issues with training loss caused by constant band in the input training data
• 3D Models
  • PointCNN
    • show_results()
      • Fixes IndexError when using the sample_point_num keyword argument
  • PTv3Seg
    • fit()
      • Suppresses PyTorch FX tracking warning messages
  • PTv3Det
    • Suppresses NaN/Inf and Block Size vs GPU memory/accuracy warning messages when initializing
    • fit()
      • Fixes NaN/Inf errors on all datasets when using TensorBoard with mixed_precision=True
• Feature, Tabular, and Timeseries Models
  • TimeSeriesModel
    • fit()
      • Fixes AttributeErrorregarding DynamicCache and from_legacy_cache because of change in Transformers in environment
  • MLModel
    • predict()
      • Fixes changes in output when renaming feature columns using the TabPFN classifier
• 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
      • Fixes AcceleratorError for GPU allocation
      • Fixes issue with handling of padding attribute for objects using mistral backbone
    • Inference Only Models
      • QuestionAnswering
        • Fixes Exception when importing model