update text and remove broken links

Author: jyaistMap

guide/10-mapping-and-visualization/using-the-map-widget.ipynb

@@ -21,8 +21,8 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "## Using the map widget\n",
-    "The `GIS` object includes a map widget for displaying geographic locations, visualizing GIS content, as well as the results of your analysis. To use the map widget, call `gis.map()` and assign it to a variable, that you can then query to bring up the widget in the notebook:"
+    "## The map widget\n",
+    "The `GIS` object includes a map widget for displaying geographic locations, visualizing GIS content, as well as the results of your analysis. To use the map widget, call `gis.map()` and assign it to a variable that you can then query to bring up the widget in the notebook:"
    ]
   },
   {
@@ -236,6 +236,16 @@
     "To see which basemaps are available for use with the map widget, use the Map's `basemap` property to initialize a BasemapManager, and then use the `basemaps` property to return a list of basemaps currently configured with the organization:"
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": 5,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from arcgis.gis import GIS\n",
+    "gis = GIS(profile=\"your_online_profile\")"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": 32,
@@ -388,16 +398,6 @@
     "See below for an animation preview of some of the basemaps listed above:"
    ]
   },
-  {
-   "cell_type": "code",
-   "execution_count": 5,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "from arcgis.gis import GIS\n",
-    "gis = GIS()"
-   ]
-  },
   {
    "cell_type": "code",
    "execution_count": 6,
@@ -562,15 +562,15 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Read more about 3D mode by reading the [advanced map widget useage](../advanced-map-widget-useage) guide page, or by reading the [API reference](https://developers.arcgis.com/python/api-reference/arcgis.widgets.html#mapview)."
+    "Read more about 3D mode by reading the [advanced map widget useage](../advanced-map-widget-usage) guide page, or by reading the [API reference](https://developers.arcgis.com/python/api-reference/arcgis.map.toc.html#scene)."
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
     "## Adding layers to the map\n",
-    "An important functionality of the map widget is its ability to add and render GIS layers. To a layer call the .content.add()` method and pass the layer object as an argument."
+    "An important functionality of the map widget is its ability to add and render GIS layers. To add a layer call the `.content.add()` method and pass the layer object as an argument."
    ]
   },
   {
@@ -604,7 +604,7 @@
    "metadata": {},
    "source": [
     "### Adding `Item` objects to the map\n",
-    "You can add `Item` objects to a map by passing it to the .content.add()` method."
+    "You can add `Item` objects to a map by passing it to the `.content.add()` method."
    ]
   },
   {
@@ -717,7 +717,7 @@
     }
    ],
    "source": [
-    "fimg_map = gis.map()\n",
+    "img_map = gis.map()\n",
     "img_map"
    ]
   },
@@ -783,7 +783,7 @@
    "metadata": {},
    "source": [
     "## Listing the layers added to the map\n",
-    "You can list the layers added to be map using the `layers` property."
+    "You can list the layers added to the map using the _MapContent_ (accessed from the _content_ property of a map object) object's `layers` property."
    ]
   },
   {
@@ -807,33 +807,31 @@
    ]
   },
   {
-   "cell_type": "code",
-   "execution_count": 180,
+   "cell_type": "markdown",
    "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "[<FeatureLayer url:\"https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/World_Time_Zones/FeatureServer/0\">]"
-      ]
-     },
-     "execution_count": 180,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
    "source": [
-    "usa_map.content.layers"
+    "## Removing layers from the map\n",
+    "To remove one or more layers, call the `remove()` method on the _Map_ object, and pass a layer index value (or list of indexes) of the layer to remove. To get a list of valid layers that can be removed and their index positions, enumerate the _map.content.layers_ output:.\n",
+    "\n",
+    "The code below shows how to remove the timezone layers from the map we drew earlier:"
    ]
   },
   {
-   "cell_type": "markdown",
+   "cell_type": "code",
+   "execution_count": 2,
    "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "0     <FeatureLayer url:\"https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/World_Time_Zones/FeatureServer/0\">\n"
+     ]
+    }
+   ],
    "source": [
-    "## Removing layers from the map\n",
-    "To remove one or more layers, call the `remove_layers()` method and pass a list of layers that you want removed. To get a list of valid layers that can be removed, call the `layers` property as shown in the previous cell.\n",
-    "\n",
-    "The code below shows how to remove the timezone layers from the map we drew earlier:"
+    "for idx,lyr in enumerate(usa_map.content.layers):\n",
+    "    print(f\"{idx:<6}{lyr}\")"
    ]
   },
   {
@@ -943,7 +941,7 @@
    "metadata": {},
    "source": [
     "### Drawing `FeatureSet` objects on the map\n",
-    "In addition to sketches, you can send `FeatureSet` objects to the `draw()` method. This capability comes in handy as you can get a `FeatureSet` object through various different operations using the Python API. For instance, you can get results of a `geocoding` operation as a `FeatureSet`, results of a `query()` operation on a `FeatureLayer` as a `FeatureSet` that can you visualize on the map using the `draw()` method.\n",
+    "In addition to sketches, you can send `FeatureSet` objects to the `draw()` method. This capability comes in handy as you can get a `FeatureSet` object through various different operations using the Python API. For instance, you can get results of a `geocoding` operation as a `FeatureSet` or the results of a `query()` operation on a `FeatureLayer` as a `FeatureSet` that can you visualize on the map using the `draw()` method and a defined symbol.\n",
     "\n",
     "The snippet below geocodes the locations of a few capitol buildings in the USA."
    ]
@@ -999,7 +997,7 @@
    "metadata": {},
    "source": [
     "### Drawing with custom symbols\n",
-    "While drawing a graphic, you can specify a custom symbol. Users of the Python API can make use of a custom [symbol selector web app]() and pick a symbol for point layers. For instance, you can pick a business marker symbol for the capitol buildings as shown below:"
+    "While drawing a graphic, you can specify a custom symbol. For instance, you can pick a business marker symbol from a url for the capitol buildings as shown below:"
    ]
   },
   {