diff --git a/guide/02-api-overview/deprecation-notices.ipynb b/guide/02-api-overview/deprecation-notices.ipynb index 698e8994d0..8b76f33daf 100644 --- a/guide/02-api-overview/deprecation-notices.ipynb +++ b/guide/02-api-overview/deprecation-notices.ipynb @@ -13,17 +13,25 @@ "\n", "These classes, functions, and modules in the ArcGIS API for Python are deprecated and may cause compatibility issues in future versions:\n", "\n", + "### `arcgis.gis` Module\n", + "\n", + "- `ContentManager.add` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.add` instead.\n", + "- `ContentManager.create_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `gis.content.folders.create` instead.\n", + "- `ContentManager.delete_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.delete()` instead.\n", + "- `ContentManager.rename_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.rename()` instead.\n", + "- `ContentManager.dependency_manager` - deprecated in **2.4.0** will be removed in a future release.\n", + "- `Item.share` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n", + "- `Item.shared_with` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n", + "- `Item.unshare` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n", + "- `arcgis.gis.UserManager.create` - the `level` parameter is deprecated at **2.4.0** and will be removed from the method signature in a future release.\n", + "- `UserManager.create` - the `level` parameter is depreacted at **2.4.0** and will be removed from the method signature in a future release. \n", + "\n", "### `arcgis.apps` Module \n", "\n", - "- `arcgis.apps.dashboard` - entire module deprecated at version **2.1.0**. This sub-module may be removed at a future major release\n", - "- `WebExperience.clone` - deprecated in **2.3.0** will be removed in **2.4.2**. Pass in the Web Experience item to `gis.content.clone_items()` instead.\n", + "- `arcgis.apps.dashboard` - entire module deprecated at version **2.1.0**. This sub-module will be removed at **2.4.3**.\n", "- `StoryMap.get` - deprecated in **2.2.0** will be removed in **2.4.2**. `get` method has been deprecated, use `content_list` property instead.\n", "- `StoryMap.nodes` - deprecated in **2.2.0** removed in **2.4.0**. The `nodes` property has been deprecated, use `content_list` property instead.\n", "- `StoryMap.cover_date` - deprecated in **2.4.0** removed in future major release. Use the `date` property in the Cover class.\n", - "- `StoryMap.cover` - deprecated in **2.4.0** removed in future major release. Use the Cover class.\n", - "- `StoryMap.navigation` - deprecated in **2.4.0** removed in future major release. Use the Navigation class.\n", - "- `Briefing.cover` - deprecated in **2.4.0** removed in future major release. Use the Cover class.\n", - "- `Collection.cover` - deprecated in **2.4.0** removed in future major release. Use the Cover class.\n", "- `Swipe.properties` - deprecated in **2.4.0** removed in future major release. Use the `content` property instead.\n", "- `Swipe.edit` - deprecated in **2.4.0** removed in future major release. Use the `content` property setter instead.\n", "- `MapAction` - deprecated in **2.4.0** removed in future major release. Use the `MediaAction` class instead.\n", @@ -35,34 +43,48 @@ "- `UtilityNetworkManager.trace` - deprecated the \"result_type\" parameter at **2.4.1**. Please use \"result_types\" instead.\n", "\n", "### `arcgis.learn` Module\n", - "\n", "- `categorize_features` - deprecated in **1.7.1** and will be removed in a future major release (For example: 2.x to 3.x). Please use `arcgis.learn.classify_objects` instead.\n", - "- `tensorflow` - deprecated in **2.4.1** and will be removed from a future release of the *arcgis* package\n", - "\n", - "### `arcgis.gis.agonb` Module \n", "\n", + "### `arcgis.gis.nb` Module \n", "- `Container.terminate` - deprecated in **2.3.0** will be removed in **2.4.0**. Use `Container.shutdown` instead.\n", + "- `NotebookDataAccess.create_folder` - deprecated in **2.4.2**. Removed in future release. Use `NotebookFolder.create_folder()` instead.\n", + "- `NotebookDataAccess.files` - deprecated in **2.4.2**. Removed in future release. Use `NotebookFolder.files` instead.\n", + "- `NotebookDataAccess.upload` - deprecated in **2.4.2**. Removed in future release. Use `NotebookFile.upload()` instead.\n", + "- `NotebookFile.erase` - deprecated in **2.4.2**. Removed in future release. Use `NotebookFile.delete()` instead.\n", "\n", - "### `arcgis.gis.nb` Module \n", + "### `arcgis.layers` Module\n", + "- `BasemapServices` - deprecated in **2.4.2**, removed in future release. Use `arcgis.map.BasemapStylesService` instead\n", + "- `BasemapService` - deprecated in **2.4.2**, removed in future release. Use `arcgis.map.BasemapStyle` instead.\n", "\n", - "- `Container.terminate` - deprecated in **2.3.0** will be removed in **2.4.0**. Use `Container.shutdown` instead.\n", + "## Deprecation Removals\n", "\n", - "### `arcgis.gis` Module\n", + "Several classes, functions, and methods have been completely removed from the ArcGIS API for Python. This means your code relying on them will no longer function properly. For a smooth transition, consult the API documentation to find alternative approaches and update your code accordingly.\n", "\n", - "- `ContentManager.add` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.add` instead.\n", - "- `ContentManager.create_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `gis.content.folders.create` instead.\n", - "- `ContentManager.delete_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.delete()` instead.\n", - "- `ContentManager.rename_folder` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Folder.rename()` instead.\n", - "- `ContentManager.dependency_manager` - deprecated in **2.4.0** will be removed in a future release.\n", - "- `Item.share` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n", - "- `Item.shared_with` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n", - "- `Item.unshare` - deprecated in **2.3.0** will be removed in a future major release (example: 2.x to 3.x). Use `Item.sharing` instead.\n", - "- `arcgis.gis.UserManager.create` - the `level` parameter is deprecated at **2.4.0** and will be removed from the method signature in a future release.\n", - "- `overwrite` item_property on `Folder.add` is deprecated and will be removed at **2.4.2**. Use `item.update` to update the source file for an `Item` instead.\n", + "### `arcgis.geoanalytics` Module \n", + "\n", + "**The entire geoanalytics module has been deprecated on ArcGIS Enterprise and removed at ArcGIS Enterprise 11.4. If you need the geoanalytics modules, please use version 2.3.x or prior.**\n", + "\n", + "See [ArcGIS GeoAnalytics for Server Deprecation Notice](https://www.esri.com/arcgis-blog/products/geoanalytics-server/announcements/deprecation-notice-for-arcgis-geoanalytics-server/) for further details. Support for the arcgis.geoanalytics module will continue to be provided through the built-in Python API included with ArcGIS Enterprise 11.3 and earlier installations.\n", " \n", + "- `analyze_patterns` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n", + "- `data_enrichment` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n", + "- `find_locations` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n", + "- `manage_data` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n", + "- `summarize_data` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n", + "- `use_proximity` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n", + "- `arcgis.geoanalytics.get_datastores` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n", + "- `arcgis.geoanalytics.define_output_datastore` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n", + "- `arcgis.geoanalytics.is_supported` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n", + "\n", "\n", "### `arcgis.mapping` Module\n", + "The entire module was deprecated in **2.4.0** and has been removed in **2.4.2**. Install the `arcgis-mapping` package and use the `arcgis.map` module instead.\n", "\n", + "- `WebMap` - removed in **2.4.0**. Use `arcgis.map.Map` instead.\n", + "- `WebScene` - removed in **2.4.0**. Use `arcgis.map.Scene` instead.\n", + "- `forms` - removed in **2.4.0**. Use dataclasses found in `arcgis.map.forms` module instead.\n", + "- `renderer` - removed in **2.4.0**. Use dataclasses found in `arcgis.map.renderers` and methods in `arcgis.map.SmartMappingManager`.\n", + "- `OfflineMapAreaManager` - removed in **2.4.0**. Use the `arcgis.map.OfflineMapAreaManager`.\n", "- `MapImageLayer` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.MapImageLayer` class instead.\n", "- `MapImageLayerManager` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.MapImageLayerManager` class instead.\n", "- `EnterpriseMapImageLayerManager` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.EnterpriseMapImageLayerManager` class instead.\n", @@ -91,35 +113,6 @@ "- `OGCCollection` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.OGCCollection` class instead.\n", "- `OGCFeatureService` - deprecated in **2.4.0** removed in **2.4.2**. Use the `arcgis.layers.OGCFeatureService` class instead.\n", "\n", - "## Deprecation Removals\n", - "\n", - "Several classes, functions, and methods have been completely removed from the ArcGIS API for Python. This means your code relying on them will no longer function properly. For a smooth transition, consult the API documentation to find alternative approaches and update your code accordingly.\n", - "\n", - "### `arcgis.geoanalytics` Module \n", - "\n", - "**The entire geoanalytics module has been deprecated on ArcGIS Enterprise and removed at ArcGIS Enterprise 11.4. If you need the geoanalytics modules, please use version 2.3.x or prior.**\n", - "\n", - "See [ArcGIS GeoAnalytics for Server Deprecation Notice](https://www.esri.com/arcgis-blog/products/geoanalytics-server/announcements/deprecation-notice-for-arcgis-geoanalytics-server/) for further details. Support for the arcgis.geoanalytics module will continue to be provided through the built-in Python API included with ArcGIS Enterprise 11.3 and earlier installations.\n", - " \n", - "- `analyze_patterns` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n", - "- `data_enrichment` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n", - "- `find_locations` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n", - "- `manage_data` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n", - "- `summarize_data` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n", - "- `use_proximity` module removed in **2.4.0**. All functions within this module have been removed. Use version 2.3.x if this functionality is still needed.\n", - "- `arcgis.geoanalytics.get_datastores` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n", - "- `arcgis.geoanalytics.define_output_datastore` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n", - "- `arcgis.geoanalytics.is_supported` was removed in **2.4.0**. Use version 2.3.x if this functionality is still needed.\n", - "\n", - "\n", - "### `arcgis.mapping` Module\n", - "- `WebMap` - removed in **2.4.0**. Use `arcgis.map.Map` instead.\n", - "- `WebScene` - removed in **2.4.0**. Use `arcgis.map.Scene` instead.\n", - "- `forms` - removed in **2.4.0**. Use dataclasses found in `arcgis.map.forms` module instead.\n", - "- `renderer` - removed in **2.4.0**. Use dataclasses found in `arcgis.map.renderers` and methods in `arcgis.map.SmartMappingManager`.\n", - "- `OfflineMapAreaManager` - removed in **2.4.0**. Use the `arcgis.map.OfflineMapAreaManager`.\n", - "\n", - "\n", "### `arcgis.geocoding` Module\n", "- `suggest` - The **distance** parameter is deprecated and removed at **2.4.0**. The parameter is no longer supported. Please use the `search_extent` parameter instead to control the search area.\n", "\n", @@ -127,7 +120,6 @@ "- `MapView` - removed in **2.4.0**. Use either `arcgis.map.Map` or `arcgis.map.Scene` instead.\n", "\n", "### `arcgis.gis.server` Module\n", - "\n", "- `Mode.update` - deprecated in **1.7.1** removed in **2.4.0**. Use `Mode.update_mode` instead.\n", "\n", "### `arcgis.gis.admin` Module\n", @@ -140,9 +132,11 @@ "- `UX.default_basemap` - deprecated in **2.1.0** removed in **2.4.0**. This applies to the getter and setter of the property. \n", "- `UX.vector_basemap` - deprecated in **2.1.0** removed in **2.4.0**. This applies to the getter and setter of the property. \n", "\n", + "### `arcgis.gis.agonb` Module \n", + "- `Container.terminate` - deprecated in **2.3.0**. Removed in **2.4.0**. Use `Container.shutdown` instead.\n", + "\n", "### `arcgis.raster` Module\n", "\n", - "- `calculate_distance` - deprecated in **1.8.1** removed in **2.4.0**. Please use arcgis.raster.functions.gbl.distance_accumulation (or arcgis.raster.functions.gbl.distance_allocation for allocation output) instead.\n", "- `calculate_travel_cost` - deprecated in **1.8.1** removed in **2.4.0**. Please use arcgis.raster.functions.gbl.distance_accumulation (or arcgis.raster.functions.gbl.distance_allocation for allocation output), instead.\n", "- `cost_allocation` - deprecated in **1.8.1** removed in **2.4.0**. Please use arcgis.raster.functions.gbl.distance_accumulation instead.\n", "- `cost_backlink` - deprecated in **1.8.1** removed in **2.4.0**. Please use arcgis.raster.functions.gbl.distance_accumulation with value specified for output_back_direction_raster_name, instead.\n", @@ -172,7 +166,27 @@ "\n", "### `arcgis.gis` Module\n", "\n", - "- `Group.invite_by_email` - deprecated in **1.5.1** removed in **2.4.0**. Use `Group.invite` instead." + "- `Group.invite_by_email` - deprecated in **1.5.1** removed in **2.4.0**. Use `Group.invite` instead.\n", + "- `Folder.add()` - `overwrite` item_property is removed at **2.4.2**. Use `item.update` to update the source file for an `Item` instead.\n", + "- `ContentManager.dependency_manager` - removed in **2.4.2**.\n", + "- `arcgis.gis.sharing` Submodule\n", + " - `DependencyManager` removed in **2.4.2**. \n", + "\n", + "### `arcgis.apps` Module\n", + "- `arcgis.apps.storymap` Submodule\n", + " - `StoryMap.get()` removed at **2.4.2.**\n", + " - `StoryMap.cover` - deprecated in **2.4.0** removed in **2.4.2**. Use the Cover class.\n", + " - `StoryMap.navigation` - deprecated in **2.4.0** removed in **2.4.2**. Use the Navigation class.\n", + " - `Briefing.cover` - deprecated in **2.4.0** removed in **2.4.2**. Use the Cover class.\n", + " - `Collection.cover` - deprecated in **2.4.0** removed in **2.4.2**. Use the Cover class.\n", + "- `arcgis.apps.expbuilder` Submodule\n", + " - - `WebExperience.clone` - Removed in **2.4.2**. Pass in the Web Experience item to `gis.content.clone_items()` instead. \n", + "\n", + "### `arcgis.learn` Module\n", + "- `TensorFlow` - removed as dependency in **2.4.2**.\n", + "\n", + "## Dependencies\n", + "- `fiona` removed as a dependency in **2.4.2**." ] } ],