|
5 | 5 | "id": "17574565-b2a1-4a25-96d0-6a2d2f56f684",
|
6 | 6 | "metadata": {},
|
7 | 7 | "source": [
|
8 |
| - "## SUMMARY\n", |
| 8 | + "## Summary\n", |
9 | 9 | "\n",
|
10 |
| - "The 2.4 Release contains many new changes that improve the performance and experience of using the Python API. The Python API incorporates the Jupyter Lab 4.0 and Notebook 7.0 architecture to align with Python processing within these applications. The backend architecture changes necessitated a complete overhaul of fundamental structures within the Python API which required both the removal of some modules and classes and transfer of functionality into new modules, classes, and accompanying properties and methods. \n", |
| 10 | + "The 2.4 Release contains many new changes that improve the performance and experience of using the Python API. The Python API incorporates the Jupyter Lab 4.0 and Notebook 7.0 architecture to align with how these applications process Python code. The backend architecture changes necessitated a complete overhaul of fundamental structures within the Python API which required both the removal of some modules and classes and transfer of functionality into new modules, classes, and accompanying properties and methods. \n", |
11 | 11 | "\n",
|
12 | 12 | "These modifications change how some familiar functionality is accessed, and provides some new ways to work with your Web GIS organization. Let's take a look at some of these new updates."
|
13 | 13 | ]
|
|
42 | 42 | "metadata": {},
|
43 | 43 | "source": [
|
44 | 44 | "**Working with 2D Maps:**\n",
|
45 |
| - " * classes for working with Web Map items and packaging offline map areas \n", |
| 45 | + "Classes for working with Web Map items and packaging offline map areas \n", |
46 | 46 | "\n",
|
47 |
| - "The _OfflineMapAreaManager_ and _PackagingJob_ have been refactored into the _arcgis.map_ module. " |
| 47 | + "* The _WebMap_ class has been deprecated. The functionality for working with web maps has been refactored to the new [_Map_](/python/api-reference/arcgis.map.toc.html#map) class in the [`arcgis.map`](/python/api-reference/arcgis.map.toc.html) module. See [WebMap class](#webmap-class).\n", |
| 48 | + "* The _OfflineMapAreaManager_ and _PackagingJob_ have been refactored into the _arcgis.map_ module. The [_offline_areas_](/python/api-reference/arcgis.map.toc.html#arcgis.map.Map.offline_areas) property of the new _Map_ class accesses the [OfflineMapAreaManager](/python/api-reference/arcgis.map.toc.html#offlinemapareamanager) similarly to the same property on the previous _WebMap_." |
48 | 49 | ]
|
49 | 50 | },
|
50 | 51 | {
|
|
53 | 54 | "metadata": {},
|
54 | 55 | "source": [
|
55 | 56 | "**Working with 3D Maps:**\n",
|
56 |
| - " * classes for working the Web Scenes and the data types displayed through scene layers\n", |
| 57 | + "Classes for working the Web Scenes and the data types displayed through scene layers\n", |
57 | 58 | "\n",
|
58 |
| - "All classes except _WebScene_ have been refactored into the `arcgis.layers` module and documented under the _Working with 3D Maps_ section in the new module. The _WebScene_ class has been removed and its functionality refactored into the _Scene_ class in the `arcgis.map` module." |
| 59 | + "* The _WebScene_ class has been deprecated and its functionality refactored into the [_Scene_ ](/python/api-reference/arcgis.map.toc.html#scene) class in the `arcgis.map` module.\n", |
| 60 | + "* All other classes except have been refactored into the [`arcgis.layers`](/python/api-reference/arcgis.layers.toc.html) module and documented under the [_Working with 3D Maps_](/python/api-reference/arcgis.layers.toc.html#working-with-3d-maps) section in the new module. " |
59 | 61 | ]
|
60 | 62 | },
|
61 | 63 | {
|
|
64 | 66 | "metadata": {},
|
65 | 67 | "source": [
|
66 | 68 | "**Working with Map Service Layers:**\n",
|
67 |
| - " * classes for working with Map Services and the associated layers within them\n", |
| 69 | + "Classes for working with Map Services and the associated layers within them\n", |
68 | 70 | "\n",
|
69 |
| - "The classes have been refactored into the `arcgis.layers` module documented under the _Working with Map Service Layers_ subsection." |
| 71 | + "The classes have been refactored into the `arcgis.layers` module documented under the [_Working with Map Service Layers_](/python/arcgis.layers.toc.html#working-with-map-service-layers) subsection." |
70 | 72 | ]
|
71 | 73 | },
|
72 | 74 | {
|
|
75 | 77 | "metadata": {},
|
76 | 78 | "source": [
|
77 | 79 | "**Working with OGC layers:**\n",
|
78 |
| - " * a submodule with classes for working with services compliant with OGC service specifications\n", |
| 80 | + "Classes for working with services compliant with [OGC standards](https://opengeospatial.github.io/e-learning/ogc-standards/text/services-ogc.html)\n", |
79 | 81 | " \n",
|
80 |
| - "The `arcgis.mapping.ogc` submodule classes have all been refactored into the `arcgis.layers` module documented into the _Working with OGC layers_." |
| 82 | + "The `arcgis.mapping.ogc` submodule classes have all been refactored into the `arcgis.layers` module documented in the [_Working with OGC layers_](/python/api-reference/arcgis.layers.toc.html#working-with-ogc-layers) subsection." |
81 | 83 | ]
|
82 | 84 | },
|
83 | 85 | {
|
|
86 | 88 | "metadata": {},
|
87 | 89 | "source": [
|
88 | 90 | "**Working with Map Forms:**\n",
|
89 |
| - " * a submodule for working with components to control behavior for data collecting and editing in applications like Map Viewer or ArcGIS Field Maps\n", |
| 91 | + "Components to control behavior for data collecting and editing in applications like Map Viewer or ArcGIS Field Maps\n", |
90 | 92 | "\n",
|
91 |
| - "The functionality of the `arcgis.mapping.forms` submodule have been refactored into the `PopupManager` class of the `arcgis.map` module." |
| 93 | + "The functionality of the `arcgis.mapping.forms` submodule has been refactored into the `arcgis.map` module and accessed using the [_form()_](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.MapContent.form) method of the [_MapContent_](/python/api-reference/arcgis.map.toc.html#arcgis.map.map_widget.MapContent) class. Full reference documentation is provided in [_Forms_](/python/api-reference/arcgis.map.toc.html#forms) documentation." |
92 | 94 | ]
|
93 | 95 | },
|
94 | 96 | {
|
|
97 | 99 | "metadata": {},
|
98 | 100 | "source": [
|
99 | 101 | "**Utility Functions for Mapping:**\n",
|
100 |
| - " * a class and functions for working with symbology and rendering in the map widget\n", |
| 102 | + "Class and functions for working with symbology and rendering in the map widget.\n", |
101 | 103 | "\n",
|
102 |
| - "The functionality of the _Symbology_ class and _export_map_ function have been refactored into the `arcgis.layers` module documented under the _Utility Functions for Mapping_ subsection. The functionality of the rendering classes have been refactored into the _RendererManager_, _SmartMappingManager_, and _LayerVisibility_ classes of the `arcgis.map` module." |
| 104 | + "* The functionality of the _Symbology_ class has been refactored into the [`Symbols`](/python/api-reference/arcgis.map.toc.html#symbols) module.\n", |
| 105 | + "* The functionality for generating renderers has been refactored into the [_SmartMappingManager_](/python/api-reference/arcgis.map.toc.html#arcgis.map.SmartMappingManager) and [_RendererManager_](/python/api-reference/arcgis.map.toc.html#arcgis.map.renderers.RendererManager) classes.\n", |
| 106 | + "* The functionality for exporting and printing has been refactored into the [print()](/python//api-reference/arcgis.map.toc.html#arcgis.map.Map.print) method of the _Map_ class." |
103 | 107 | ]
|
104 | 108 | },
|
105 | 109 | {
|
106 | 110 | "cell_type": "markdown",
|
107 | 111 | "id": "500a26a0-d8aa-498e-9ec3-0a4473994b9f",
|
108 | 112 | "metadata": {},
|
109 | 113 | "source": [
|
110 |
| - "### `WebMap` class" |
| 114 | + "## `WebMap` class" |
111 | 115 | ]
|
112 | 116 | },
|
113 | 117 | {
|
|
117 | 121 | "metadata": {},
|
118 | 122 | "outputs": [],
|
119 | 123 | "source": [
|
120 |
| - "# Initialize in 2.3.x and prior\n", |
| 124 | + "# Initialize in 2.4.x and after\n", |
121 | 125 | "from arcgis.map import Map\n",
|
122 | 126 | "wm = Map(\n",
|
123 | 127 | " item= item\n",
|
|
131 | 135 | "metadata": {},
|
132 | 136 | "outputs": [],
|
133 | 137 | "source": [
|
134 |
| - "# Initialize in 2.4.x and after\n", |
| 138 | + "# Initialize in 2.3.x and prior\n", |
135 | 139 | "from arcgis.mapping import WebMap\n",
|
136 | 140 | "wm = WebMap(\n",
|
137 | 141 | " webmapitem= item\n",
|
|
140 | 144 | },
|
141 | 145 | {
|
142 | 146 | "cell_type": "code",
|
143 |
| - "execution_count": 28, |
144 |
| - "id": "f59ae17f-c78c-4a34-a31a-92cff553882c", |
| 147 | + "execution_count": 29, |
| 148 | + "id": "d38f0969-97e5-483e-af03-d9408cc481ca", |
145 | 149 | "metadata": {},
|
146 |
| - "outputs": [ |
147 |
| - { |
148 |
| - "data": { |
149 |
| - "text/html": [ |
150 |
| - "<style>\n", |
151 |
| - "table {float:left; width:100%;}\n", |
152 |
| - "tr {float:center; width:100;}\n", |
153 |
| - "</style>\n" |
154 |
| - ], |
155 |
| - "text/plain": [ |
156 |
| - "<IPython.core.display.HTML object>" |
157 |
| - ] |
158 |
| - }, |
159 |
| - "metadata": {}, |
160 |
| - "output_type": "display_data" |
161 |
| - } |
162 |
| - ], |
| 150 | + "outputs": [], |
163 | 151 | "source": [
|
164 |
| - "%%html\n", |
165 |
| - "<style>\n", |
166 |
| - "table {float:left; width:100%;}\n", |
167 |
| - "tr {float:center; width:100;}\n", |
168 |
| - "</style>" |
| 152 | + "from arcgis.geocoding import geocode, Geocoder" |
169 | 153 | ]
|
170 | 154 | },
|
171 | 155 | {
|
172 | 156 | "cell_type": "code",
|
173 |
| - "execution_count": 29, |
174 |
| - "id": "d38f0969-97e5-483e-af03-d9408cc481ca", |
| 157 | + "execution_count": null, |
| 158 | + "id": "1e6dad58-4e6c-4fe8-989a-884ea3520b59", |
175 | 159 | "metadata": {},
|
176 | 160 | "outputs": [],
|
177 |
| - "source": [ |
178 |
| - "from arcgis.geocoding import geocode, Geocoder" |
179 |
| - ] |
| 161 | + "source": [] |
180 | 162 | },
|
181 | 163 | {
|
182 | 164 | "cell_type": "markdown",
|
183 | 165 | "id": "6d0ad020-53e3-4710-80d5-d20beb724730",
|
184 | 166 | "metadata": {},
|
185 | 167 | "source": [
|
186 |
| - "The _WebMap_ class has been deprecated and its functionality has been refactored into the new classes within the new [Map](/python/api-reference/arcgis.map.toc.html#map) in the `arcgis.map` module. Initializing a new map object with an existing Web Map item as the *item* argument will provide access to properties and methods for interating with the Web Map.\n", |
| 168 | + "The _WebMap_ class has been deprecated and its functionality has been refactored into the new class within `arcgis.map` module, [_Map_](/python/api-reference/arcgis.map.toc.html#map). Initialize a new map object with an existing Web Map item by entering it as the *item* argument.\n", |
187 | 169 | "\n",
|
188 | 170 | "Methods:\n",
|
189 | 171 | "\n",
|
190 |
| - "|WebMap member |Map member |Return|\n", |
| 172 | + "|WebMap operation |Map operation |Notes|\n", |
191 | 173 | "|:- |:- |:- |\n",
|
192 |
| - "|wm.add_layer()|wm.content.add()|\n", |
193 |
| - "|wm.add_table()]()|wm.content.add()\n", |
194 |
| - "|wm.basemap_title()|wm.basemap.basemap.title|\n", |
195 |
| - "|wm.configure_pop_ups]()|\n", |
196 |
| - "* [get_layer()]\n", |
197 |
| - "* [height]()\n", |
198 |
| - "* [move_from_basemap()]\n", |
199 |
| - "* [move_to_basemap()]\n", |
200 |
| - "* [scale_bar]()\n", |
201 |
| - "* [save()]()\n", |
202 |
| - "* [update()]()\n", |
203 |
| - "* [update_drawing_info()]()\n", |
204 |
| - "* [update_layer()]()\n", |
| 174 | + "|wm.add_layer()|m.content.add()|method on new MapContent class\n", |
| 175 | + "|wm.add_table()]()|m.content.add()|method on MapContent class\n", |
| 176 | + "|wm.basemap_title()|m.basemap.title|get/set on new BasemapManager class\n", |
| 177 | + "|wm.configure_pop_ups()|m.content.popup(layer_index)|\n", |
| 178 | + "|wm.get_layer()|||\n", |
| 179 | + "|wm.get_table()|||\n", |
| 180 | + "|wm.move_from_basemap()|m.basemap.move_from_basemap()|\n", |
| 181 | + "|wm.move_to_basemap()]|m.content.move_to_basemap(layer_index)|\n", |
| 182 | + "|wm.print()|\n", |
| 183 | + "|wm.remove_layer()|\n", |
| 184 | + "|wm.remove_table()|\n", |
| 185 | + "|wm.save()|\n", |
| 186 | + "|wm.update()|\n", |
| 187 | + "|wm.update_drawing_info()|\n", |
| 188 | + "|wu.update_layer()|\n", |
205 | 189 | "\n",
|
206 | 190 | "Properties\n",
|
| 191 | + "\n", |
207 | 192 | "|WebMap member |Map member |Return|\n",
|
208 | 193 | "|:- |:- |:- |\n",
|
| 194 | + "|wm.basemap|m.basemap.basemap|new BasemapManager class|\n", |
209 | 195 | "|wm.basemap_switcher|NA||\n",
|
210 |
| - "* [basemap_title]()\n", |
211 |
| - "* [bookmarks]()\n", |
212 |
| - "* [events]()\n", |
213 |
| - "* [forms]()\n", |
214 |
| - "|wm.gallery_basemaps|wm.basemap.basemap_gallery|List|\n", |
215 |
| - "* [get_table()]()\n", |
216 |
| - "* [layer_visibility]()\n", |
217 |
| - "* [layers]()\n", |
218 |
| - "* [legend]()\n", |
219 |
| - "* [navigation]()\n", |
220 |
| - "* [offline_areas]()\n", |
221 |
| - "* [pop_ups]()\n", |
222 |
| - "* [print()]()\n", |
223 |
| - "* [remove_layer()]()\n", |
224 |
| - "* [remove_table()]()\n", |
225 |
| - "* [search]()\n", |
226 |
| - "* [tables]()\n", |
227 |
| - "* [view_bookmarks]()\n", |
228 |
| - "* [width]()\n", |
229 |
| - "* [zoom]()" |
| 196 | + "|wm.basemaps|wm.basemap.basemap_gallery|List|\n", |
| 197 | + "|wm.basemaps|m.basemap.basemaps|property on new BasemapManager class\n", |
| 198 | + "|wm.bookmarks|m.bookmarks|new \n", |
| 199 | + "|wm.events|\n", |
| 200 | + "|wm.forms|\n", |
| 201 | + "|wm.gallery_basemaps|||\n", |
| 202 | + "|wm.height|||\n", |
| 203 | + "|wm.layer_visibility|\n", |
| 204 | + "|wm.layers|\n", |
| 205 | + "|wm.legend|\n", |
| 206 | + "|wm.navigation|\n", |
| 207 | + "|wm.offline_areas|\n", |
| 208 | + "|wm.pop_ups|\n", |
| 209 | + "|wm.scale_bar|\n", |
| 210 | + "|wm.search|\n", |
| 211 | + "|wm.tables|\n", |
| 212 | + "|wm.view_bookmarks|\n", |
| 213 | + "|wm.width|\n", |
| 214 | + "|wm.zoom|" |
230 | 215 | ]
|
231 | 216 | },
|
232 | 217 | {
|
|
0 commit comments