Tutorial: Add a layer from a portal item | ArcGIS API for Python v2.3

Learn how to use an itemAn item, also known as a content item, is a resource stored in a portal such as a web map, hosted layer, style, script tool, file, or notebook.Learn more to access and display a feature layerA feature layer (client-side) is a data layer that can access and display features from a feature service that has the same type of geometry and attribute fields.Learn more in a mapA map is a collection of layers that are displayed in 2D. It is typically composed of a basemap layer and data layers.Learn more.

You can host a variety of geographic data and other resources using ArcGIS OnlineArcGIS Online is a GIS mapping, analytics, data hosting, and content management software as a service (SaaS) product. It includes applications, tools, APIs, and location services for users and developers. It is subscription-based and requires an ArcGIS Online account.Learn more. These items can also define how the data is presented. A web mapA web map is a map stored as a JSON object that defines properties such as the basemap layer, data layers, layer styles, and pop-up styles. Its JSON structure is defined by the web map specification.Learn more or web sceneA web scene is a scene stored as a JSON object that defines properties such as the basemap layer, data layers, layer styles, and pop-up styles. Its JSON structure is defined by the web scene specification.Learn more, for example, not only defines the layers for a map or scene, but also how layers are symbolized, the minimum and/or maximum scales at which they display, and several other properties. Likewise, a hosted feature layer contains the data for the layer and also defines the symbols and other display properties for how it is presented. When you add a map, scene, or layer from a portal item to your app, everything that has been saved with the item is applied in your application. Adding items to your application rather than creating them programmatically saves you from writing a lot of code, and can provide consistency across applications that use the same data.

In this tutorial, you will add a hosted feature layer to display trailheads in the Santa Monica Mountains of Southern California. The hosted layer defines the trailhead locations (points) as well as the symbols used to display them.

Prerequisites

The ArcGIS API for Python tutorials use Jupyter Notebooks to execute Python code. If you are new to this environment, please see the guide to install the API and use notebooks locally.

Steps

Import modules and log in

Import the arcgis.gis module. This module is the entry point into the GIS and provides the functionality to manage GIS contentContent is a collection of items in a portal that belong to a user, group, or organization.Learn more, users, and groups.
Use dark colors for code blocks
```
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
from arcgis.gis import GIS
```
Log in anonymously to access publicly shared content. The data used in this tutorial is public so you do not need credentials to access it. If it were private data, you would be required to provide authentication.
Use dark colors for code blocks
```
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
from arcgis.gis import GIS


gis = GIS()
```

Access the item by ID

Create a variable to hold the item IDAn item ID is a unique identifier representing a single item stored, managed, and accessed in a portal, such as a web map, hosted layer, or file.Learn more of the public dataset. An item hosted in ArcGIS has a unique item ID attribute that can be referenced. For example, the item ID for this feature layer is:
Use dark colors for code blocks
```
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
gis = GIS()

trailheads_id = "2e4b3df6ba4b44969a3bc9827de746b3"
```

Use the content property on the GIS class, passing in the trailheads_id variable to return an item object.

Use dark colors for code blocks
trailheads_id = "2e4b3df6ba4b44969a3bc9827de746b3"

trailheads_item = gis.content.get(trailheads_id)
trailheads_item

Display the item on a map

Create a map widget instance by calling the map method. Pass the item object to the add_layer method to display the layer.

Use dark colors for code blocks
trailheads_item = gis.content.get(trailheads_id)
trailheads_item

m = gis.map()
m.add_layer(trailheads_item)
m

Use the center and zoom methods to set the display extent of the map.

Use dark colors for code blocks
m = gis.map()
m.add_layer(trailheads_item)
m

m.center = [34.09042, -118.71511]  # [latitude, longitude]
m.zoom = 11

Your map should display the locations of trailheads in the Santa Monica Mountains.

Create a standalone HTML page that can be shared and rendered in a web browser.

Use dark colors for code blocks
from os import path, getcwd

export_dir = path.join(getcwd(), "home")
if not path.isdir(export_dir):
    os.mkdir(export_dir)

export_path = path.join(export_dir, "add-a-layer-from-an-item.html")

m.export_to_html(export_path, title="Add a layer from an item")

What's next?

Learn how to use additional functionality in these tutorials:

Display a web map

Search ArcGIS Online for an existing web map and display it.

Query a feature layer (spatial)

Learn how to execute a spatial query to access polygon features from feature services.

Query a feature layer (SQL)

Learn how to execute a SQL query to access polygon features from feature services.