Get an item

Items are the contents available in ArcGIS portal, and each item includes an item page with information, options, and settings. You can:

• Browse or search the organization for items.
• Click the item title to get a preview of what each item contains and how to use it.
• Open the item details page to access more information about the item.

The information and options available to you depend on the item type, your privileges, and if you are the item owner or administrator. Only item owners or organization administrators can configure an item's settings.

Accessing an item page

You can access an item page in several ways using the interactive tools such as clicking:

• Options button and selecting View item details from the gallery.
• View details for an item.
• Item name on the Content page.
• Item name when searching for layers in a map viewer.

Item properties

All items contain a common set of properties such as the owner, title, type, tags, thumbnail, and description. These properties are common to all types of items and are set when the item is created. The properties are also used to search for the item.

When an item is created, it is assigned a unique identifier, also known as an item ID. You can use an item ID to find and directly access an item and its content in the portal.

An item's sharing permissions can also be set with its access property, so that it can be accessed by only its owner (private), the members of an organization (org), or everyone (public). Learn more in item sharing.

How to get an item

The general steps of getting an item:

1. Choose a type of authentication

The purpose of an access token in ArcGIS is to provide secure, authorized access to content items, services, and functionality for both applications and users. You need to implement a type of authentication in your app to get an access token and access secure ArcGIS resources. The type of authentication you implement will determine the access privileges and billing method of your app.

The following types of authentication can be used to get an access token:

• API key authentication
• User authentication
• App authentication

2. Get an access token

To get an access token, you need to implement a type of authentication in your application. Different types of authentication result in access tokens with different privileges. Learn how to implement the types of authentication workflows below:

• API key authentication.
• User authentication.
• App authentication.

3. Get the item

Once you have an access token, you can access an item and its properties by the item ID. The response contains the item properties.

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
    const item = new PortalItem({
      id: "5a5147abe878444cbac68dea9f2f64e7",
      portal: "https://www.arcgis.com/sharing/rest"
    });
    item.load().then((response)=>{
      console.log(response);
    });

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
    const portal = new Portal({
      url: "https://www.arcgis.com/",
      authMode: "immediate"
    });

    // OR
    esriConfig.apiKey = "YOUR_ACCESS_TOKEN" // Scoped to access item below

    const portalItem = new PortalItem({
      portal: portal,
      id: "ITEM_ID"
    });
    portalItem.load().then((response)=>{
      console.log(response);
    });

1
2
3
4
5
6
7
8
9
10
## Public

curl https://www.arcgis.com/sharing/rest/content/items/5a5147abe878444cbac68dea9f2f64e7 \
-d 'f=pjson'

## Private

curl https://www.arcgis.com/sharing/rest/content/items/<ITEM_ID> \
-d 'f=pjson' \
-d 'token=<ACCESS_TOKEN>'

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
// Public

{
  "id": "5a5147abe878444cbac68dea9f2f64e7",
  "owner": "esri_devlabs",
  "orgId": "GVgbJbqm8hXASVYi",
  "created": 1569537110000,
  "modified": 1569537111000,
  "guid": null,
  "name": null,
  "title": "Seven Natural Wonders of the World Map",
  "type": "Web Map"
}

// Private

{
  "id": "ITEM_ID",
  "owner": "OWNER",
  "orgId": "ORG_ID",
  "created": "DATE_CREATED",
  "modified": "DATE_MODIFIED",
  "guid": null,
  "name": null,
  "title": "ITEM_TITLE",
  "type": "ITEM_TYPE"
}

Code examples

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
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
      portal.load().then(function() {
        var portalItem = new PortalItem({
          portal: portal,
          id: "YOUR_ITEM_ID_HERE"
        });
        portalItem.load().then(function(item) {
          var sharingLevel = item.access.toLowerCase();
          console.log(sharingLevel);
        });
      });

Tutorials

Import data to create a feature layer

Use data management tools to import files and create a feature layer in a feature service.

ArcGIS portal

Define a new feature layer

Use data management tools to define and create a new empty feature layer in a feature service.

ArcGIS portalPython APIREST JS

Manage a feature layer

Use a hosted feature layer item to set the properties and settings of a feature layer in a feature service.

ArcGIS portal

Create a vector tile service

Use data management tools to create a new vector tile service from a feature service.

ArcGIS portalPython APIREST JS

Create a map tile service

Use ArcGIS Online or scripting APIs to publish a map tile service.

ArcGIS portalPython APIREST JS

Services

API support

Use data management tools or Client APIs to create, manage, and access data services. The table below outlines the level of support for each API.

Tools