Workflow: Create a map tile service for an app | Documentation

ArcGIS hosted map tile service item page showing Santa Monica elevation contours.

In this workflow, you will learn how to create, manage, and access a map tile serviceA map tile service, formerly known as image tile service, is a data service that provides access to static, pre-rendered mao tiles. The tiles are typical in PNG format. Map tiles are typically retrieved by specifying a specific level, row, and column value.Learn more in your portalArcGIS portal, also known as a portal, is a website with applications and tools that can be used to create, manage, access, and share geospatial content and data. It supports security and authentication, developer credentials, content and data service management, user and group management, and site administration. A portal can be hosted in Esri's infrastructure or your own infrastructure.Learn more. The process involves importing an existing dataset to create a hosted feature layerA feature layer (server-side) is a spatially-enabled table in a feature service. All features in a feature layer share the same geometry type and set of fields.Learn more and a feature service, managing the service, publishing the map tile service, setting the security level, and then displaying the data in an application.

Use cases

In this scenario, you would like to use your portalArcGIS portal, also known as a portal, is a website with applications and tools that can be used to create, manage, access, and share geospatial content and data. It supports security and authentication, developer credentials, content and data service management, user and group management, and site administration. A portal can be hosted in Esri's infrastructure or your own infrastructure.Learn more to host elevation contours so you can easily access, manage, and update the data. The source data is a shapefile of elevation contours for the City of Santa Monica that contains 1498 dense features (polylines with a large number vertices) with a number of attributes. The data needs to be private and only accessible to users of the application. Lastly, you need to write an application to display the contours and support simple attribute queries when a user clicks on features.

Prerequisites

You need an accountAn ArcGIS account is an identity with a user type and set of privileges that can access specific ArcGIS products, tools, APIs, services, and resources. The main account types that can be used for development are an ArcGIS Location Platform account, ArcGIS Online account, and ArcGIS Enterprise account. ArcGIS Location Platform and ArcGIS Online accounts are also associated with a subscription.Learn more for ArcGIS Location PlatformArcGIS Location Platform, formerly known as ArcGIS Platform, is a Platform as a Service (PaaS) product that gives developers access to location services, APIs, and tools to build mapping and spatial analysis applications. It is subscription-based and requires an ArcGIS Location Platform account.Learn more, 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, or ArcGIS EnterpriseArcGIS Enterprise is a GIS mapping, analytics, data hosting, and content management product that can be hosted on-premise or in a cloud infrastructure. It includes software, applications, tools, APIs, and services for users and developers.Learn more to create hosted data services. If you need an account, go to Get started.

The Scripting APIs sections of this tutorial requires you to implement authentication. To learn more about the different types of authentication, go to Security and authentication.

Steps

Download the data

For this workflow, you will use the Santa Monica elevation contours dataset.

In your web browser, go to the Santa Monica elevation contours item.
Click the Download button to download the zip file locally. Do not unzip this file.

Create a feature layer

Before you create a map tile layer, you need to create a feature layer.

To create a feature layerA feature layer (server-side) is a spatially-enabled table in a feature service. All features in a feature layer share the same geometry type and set of fields.Learn more in a feature serviceA feature service is a data service that provides access to spatial and non-spatial data in feature layers, feature layer views, and tables.Learn more, you need to upload data into ArcGIS. You can use data management toolsData management tools are ArcGIS software applications and functionality in portal and ArcGIS Pro that can be used by developers to create, manage, and edit content and data such as web maps, hosted layers, and data services for their applications.Learn more or scripting APIs.

Data management tools

Import the shapefile using a data management toolData management tools are ArcGIS software applications and functionality in portal and ArcGIS Pro that can be used by developers to create, manage, and edit content and data such as web maps, hosted layers, and data services for their applications.Learn more.

In your web browser, go to https://location.arcgis.com, and sign in with your ArcGIS Location Platform accountAn ArcGIS Location Platform account, formerly known as an ArcGIS Developer account, is an identity associated with an ArcGIS Location Platform subscription.Learn more. In the ArcGIS Location PlatformArcGIS Location Platform, formerly known as ArcGIS Platform, is a Platform as a Service (PaaS) product that gives developers access to location services, APIs, and tools to build mapping and spatial analysis applications. It is subscription-based and requires an ArcGIS Location Platform account.Learn more dashboard, click My portal to go to your portal.

In the top navigation bar, click Content.
Click New item. To upload the Santa Monica elevation contours Shapefile, you can either:
- Drag and drop the file.
- Or, click Your device and navigate to the file path.
Select Santa_Monica_contours_clipped_export.zip and create a hosted feature layer to publish the file as a hosted feature layerA hosted feature layer is a hosted layer (item) in a portal that is used to manage the properties and settings of a spatially-enabled feature layer in a feature service.Learn more.
In Fields, leave all fields at their default settings and click Next.
In Location settings, leave the default settings and click Next.
Set the following information in the item details pane:
- Title: Santa Monica elevation contours
- Tags: santa, monica, elevation, contours, map tile, service,tutorial
- Summary: City of Santa Monica elevation contours
Click Next to create the new 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 and feature serviceA feature service is a data service that provides access to spatial and non-spatial data in feature layers, feature layer views, and tables.Learn more.

In your web browser, go to ArcGIS.com and sign in to your portalArcGIS portal, also known as a portal, is a website with applications and tools that can be used to create, manage, access, and share geospatial content and data. It supports security and authentication, developer credentials, content and data service management, user and group management, and site administration. A portal can be hosted in Esri's infrastructure or your own infrastructure.Learn more with your ArcGIS Online accountAn ArcGIS Online account, also known as an ArcGIS Organization account, is an identity associated with an ArcGIS Online subscription. It can be used to access ArcGIS tools and develop applications with ArcGIS location services for an organization.Learn more.

In the top navigation bar, click Content.
Click New item. To upload the Santa Monica elevation contours Shapefile, you can either:
- Drag and drop the file.
- Or, click Your device and navigate to the file path.
Select Santa_Monica_contours_clipped_export.zip and create a hosted feature layer to publish the file as a hosted feature layerA hosted feature layer is a hosted layer (item) in a portal that is used to manage the properties and settings of a spatially-enabled feature layer in a feature service.Learn more.
In Fields, leave all fields at their default settings and click Next.
In Location settings, leave the default settings and click Next.
Set the following information in the item details pane:
- Title: Santa Monica elevation contours
- Tags: santa, monica, elevation, contours, map tile, service,tutorial
- Summary: City of Santa Monica elevation contours
Click Next to create the new 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 and feature serviceA feature service is a data service that provides access to spatial and non-spatial data in feature layers, feature layer views, and tables.Learn more.

In your web browser, go to your ArcGIS EnterpriseArcGIS Enterprise is a GIS mapping, analytics, data hosting, and content management product that can be hosted on-premise or in a cloud infrastructure. It includes software, applications, tools, APIs, and services for users and developers.Learn more portal and sign in to your portal with your ArcGIS Enterprise accountAn ArcGIS Enterprise account is an identity for an instance of ArcGIS Enterprise. It can be used to access ArcGIS Enterprise tools, applications, and services, and to develop applications.Learn more.

In the top navigation bar, click Content.
Click New item. To upload the Santa Monica elevation contours Shapefile, you can either:
- Drag and drop the file.
- Or, click Your device and navigate to the file path.
Select Santa_Monica_contours_clipped_export.zip and create a hosted feature layer to publish the file as a hosted feature layerA hosted feature layer is a hosted layer (item) in a portal that is used to manage the properties and settings of a spatially-enabled feature layer in a feature service.Learn more.
In Fields, leave all fields at their default settings and click Next.
In Location settings, leave the default settings and click Next.
Set the following information in the item details pane:
- Title: Santa Monica elevation contours
- Tags: santa, monica, elevation, contours, map tile, service,tutorial
- Summary: City of Santa Monica elevation contours
Click Next to create the new 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 and feature serviceA feature service is a data service that provides access to spatial and non-spatial data in feature layers, feature layer views, and tables.Learn more.

You can use ArcGIS ProArcGIS Pro is a professional desktop GIS application that can explore, visualize, analyze, and manage 2D and 3D data.Learn more to import Santa Monica elevation contours data.

Unzip the Santa_Monica_contours_clipped_export zip file.
- The zip file contains the OverlayedFeatures.shp file.
Launch ArcGIS Pro.
- Create a new map project.
- A map with World Topographic Map and World Hillshade basemap layers will be created.
In the Map ribbon, click on Add Data > Data and select OverlayedFeatures.shp file.

The OverlayedFeatures.shp file is added as a feature layer to the map.

Scripting APIs

You can also import the shapefile with the ArcGIS API for Python or ArcGIS REST JS. The general steps are as follows:

Import the required libraries.
Implement authentication.
Create and publish a portal item.
Handle the results.

Expand

Use dark colors for code blocks

Copy

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# local path to shapefile zip file
input_file_path = str(
    Path(__file__).parent / "Santa_Monica_contours_clipped_export.zip"
)

# add the zip file as an item to portal
shp_item = portal.content.add(
    {"title": "Santa Monica elevation contours", "description": "City of Santa Monica elevation contours", "tags": "santa, monica, elevation, contours, map tile, service, tutorial",
     "type": "Shapefile", }, input_file_path, )

# publish the item to create a hosted feature service
shp_service = shp_item.publish(None)

print(f"New item id : {shp_service.id,}, url: {shp_service.layers[0].url}")

Go to API reference

Expand

Use dark colors for code blocks

Copy

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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
  // create item
  const zipItem = await createItem({
    authentication: auth,
    item: {
      title: "Santa Monica elevation contours",
      description: "City of Santa Monica elevation contours",
      tags: "santa, monica, elevation, contours, map tile, service, tutorial",
      type: "Shapefile",
    },
    file: f,
  })

  // execute publish operation
  const publishedService = await request(publishURL, {
    authentication: auth,
    params: {
      itemid: zipItem.id,
      filetype: "shapefile",
      publishParameters: publishParams,
    },
  })

  // handle results
  console.log("New service created: ")
  publishedService.services.forEach(s => {
    console.log(`\tid: ${s.serviceItemId} \n\turl:${s.serviceurl}`)
  })

Expand

Go to API reference

Manage service settings

The layer has polyline features with large numbers of vertices per feature. To improve performance, enable drawing optimization and CDN caching. Caching will decrease network latency and increase responsiveness.

In the item page, use the Settings tab to configure service settings such as cache and drawing optimization.

Enable the following settings:

Optimize layer drawing
- In the item page, go to the Settings > Optimize Layer Drawing. Click Optimize layers and select the layer to optimize > Update.
Cache control
- In the item page, go to the Settings tab > Cache control. Set the time you want users to wait before seeing updates to the layer.

Set the feature styles

Use data management toolsData management tools are ArcGIS software applications and functionality in portal and ArcGIS Pro that can be used by developers to create, manage, and edit content and data such as web maps, hosted layers, and data services for their applications.Learn more to set the style for a feature layerA feature layer (server-side) is a spatially-enabled table in a feature service. All features in a feature layer share the same geometry type and set of fields.Learn more.

In ArcGIS portal, use the Visualization tab to set the feature styles.

Go back to the item pageAn item page is a web page in ArcGIS Online or the developer dashboard used to access and manage the properties for an item and the content it references such as a web map, hosted layer, or file.Learn more > Visualization.
In the left panel, click the Layers and select the Santa Monica contours layer. In the right panel, click Styles.
Under Pick a style, click Location (single symbol).
For Symbol style, click on the pencil icon to open the Symbol style pane.
Set each of the following properties:
- Color: #d0774b
- Transparency: 0
- Width: 0.09
- Adjust width automatically: false
Your Symbol style pane should look like this:
Click the X to exit out of Symbol style. Then click Done twice.
Click Save to save the style.
Click on Labels in the right toolbar.
Click Enable labels to toggle on.
Under Label field, select the ContourEle field.
Under Label Style set the following properties:
- Font: Arial Regular
- Size: 13
- Color: #d0774b
- Allow overrun: false
- Repeat label: true
- Label repeat interval: 0
- Halo: true
  - Color: #ffffff
  - Size: 1
Your Label style pane should look like this:
Click X to dismiss the Label style pane.
Under Visible range, set the visible range from Street to Room.

Your Label features pane should look like this:
Click X to dismiss the Label features pane.
Click Save to save the style.

In ArcGIS portal, use the Visualization tab to set the feature styles.

Go back to the item pageAn item page is a web page in ArcGIS Online or the developer dashboard used to access and manage the properties for an item and the content it references such as a web map, hosted layer, or file.Learn more > Visualization.
In the left panel, click the Layers and select the Santa Monica contours layer. In the right panel, click Styles.
Under Pick a style, click Location (single symbol).
For Symbol style, click on the pencil icon to open the Symbol style pane.
Set each of the following properties:
- Color: #d0774b
- Transparency: 0
- Width: 0.09
- Adjust width automatically: false
Your Symbol style pane should look like this:
Click the X to exit out of Symbol style. Then click Done twice.
Click Save to save the style.
Click on Labels in the right toolbar.
Click Enable labels to toggle on.
Under Label field, select the ContourEle field.
Under Label Style set the following properties:
- Font: Arial Regular
- Size: 13
- Color: #d0774b
- Allow overrun: false
- Repeat label: true
- Label repeat interval: 0
- Halo: true
  - Color: #ffffff
  - Size: 1
Your Label style pane should look like this:
Click X to dismiss the Label style pane.
Under Visible range, set the visible range from Street to Room.

Your Label features pane should look like this:
Click X to dismiss the Label features pane.
Click Save to save the style.

In your ArcGIS Enterprise portal, use the Visualization tab to set the feature styles.

Go back to the item pageAn item page is a web page in ArcGIS Online or the developer dashboard used to access and manage the properties for an item and the content it references such as a web map, hosted layer, or file.Learn more > Visualization.
In the left panel, click the Layers and select the Santa Monica contours layer. In the right panel, click Styles.
Under Pick a style, click Location (single symbol).
For Symbol style, click on the pencil icon to open the Symbol style pane.
Set each of the following properties:
- Color: #d0774b
- Transparency: 0
- Width: 0.09
- Adjust width automatically: false
Your Symbol style pane should look like this:
Click the X to exit out of Symbol style. Then click Done twice.
Click Save to save the style.
Click on Labels in the right toolbar.
Click Enable labels to toggle on.
Under Label field, select the ContourEle field.
Under Label Style set the following properties:
- Font: Arial Regular
- Size: 13
- Color: #d0774b
- Allow overrun: false
- Repeat label: true
- Label repeat interval: 0
- Halo: true
  - Color: #ffffff
  - Size: 1
Your Label style pane should look like this:
Click X to dismiss the Label style pane.
Under Visible range, set the visible range from Street to Room.

Your Label features pane should look like this:
Click X to dismiss the Label features pane.
Click Save to save the style.

You can use ArcGIS ProArcGIS Pro is a professional desktop GIS application that can explore, visualize, analyze, and manage 2D and 3D data.Learn more to change the visualization of the Santa Monica contours layer.

Change the contour visualization

In the Content pane, click on the line symbol. This will display the Symbology pane.
In the Symbology pane, click Properties.
In the Appearance section:
- Click the color > Color Properties and set the following properties:
  - HEX #: #d0774b
  - Transparency: 0%
  - Click OK
- Line width: 0.09 pt
- Click Apply.
Click Save Project.

Add labels to the contour

You will use ArcadeArcade is a lightweight and secure expression language used in ArcGIS products and APIs. Arcade expressions are commonly used to calculate or format field values for data-driven visualizations, labels, and popups. The expressions work against data stored in data services.Learn more to label the Santa_Monica_contours layer.

In the Contents pane, right-click Santa_Monica_contours layer and click Labeling Properties.
In the Label Class pane, set the following information:
- Language: Arcade
- Expression: $feature["ContourEle"]
Click Apply.
Click Save Project.

Values from the ContourEle field are used to label the contour lines in the map.

Scripting APIs

You can also style the elevation contours features using the ArcGIS API for python or ArcGIS REST JS. The general steps are as follows:

Import the required libraries.
Implement authentication.
Retrieve feature layer properties.
Define a new renderer.
Update feature layer properties.
Handle the results.

Expand

Use dark colors for code blocks

Copy

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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
# update the drawing info
feature_layer_props["drawingInfo"] = new_drawing_info

# reset last edit date
feature_layer_props["editingInfo"]["lastEditDate"] = None

# apply changes
results = feature_layer.manager.update_definition(feature_layer_props)

print(results)

Go to API reference

Expand

Use dark colors for code blocks

Copy

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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
  // get layer properties
  const layerAdminInfo = await getServiceAdminInfo(featureLayerURL, auth);

  // update the renderer
  layerAdminInfo.drawingInfo = newDrawingInfo;

  // reset edit date
  layerAdminInfo.editingInfo.lastEditDate = null;

  // updateDefinition endpoint
  const updateURL = `${adminURL}/updateDefinition`;

  // execute updateDefinition operation
  const results = await request(updateURL, {
    authentication: auth,
    params: {
      updateDefinition: layerAdminInfo,
    },
  });

  console.log(results);

Expand

Go to API reference

Publish the map tile service

Use data management toolsData management tools are ArcGIS software applications and functionality in portal and ArcGIS Pro that can be used by developers to create, manage, and edit content and data such as web maps, hosted layers, and data services for their applications.Learn more or scripting APIs to publish a map tile service from the source feature layer.

Data management tools

Use ArcGIS portal to publish the map tile service.

Go back to the item pageAn item page is a web page in ArcGIS Online or the developer dashboard used to access and manage the properties for an item and the content it references such as a web map, hosted layer, or file.Learn more > Overview.
Click Publish > Tile layer.
In the Create a tile layer modal, select Create tiles automatically
Enter a Title and Tags for the new map tile layer. Click OK. You will be directed to the item pageAn item page is a web page in ArcGIS Online or the developer dashboard used to access and manage the properties for an item and the content it references such as a web map, hosted layer, or file.Learn more for the new tile service.

You will create a map tile service from your Santa Monica Contours hosted layer by creating a map tile package in ArcGIS Pro.

Add the hosted layer to the project

Launch ArcGIS ProArcGIS Pro is a professional desktop GIS application that can explore, visualize, analyze, and manage 2D and 3D data.Learn more and create a new map project.
In the Catalog pane, click Project.
Right-click on the OverlayedFeatures.shp and click Add To Current Map to add the shapefile to the map.
Click Save Project to save your project.

Add metadata to the map

Part of the vector tile package creation process is to add metadata to the map. The steps below will outline how metadata can be added to your map project.

Select and right-click on Map > Edit Metadata in the Contents pane.
Set the following information in the metadata pane:
- Title: Santa Monica Contours (map tile)
- Tags: santa, monica, contours, map,tile, service
- Summary: Santa Monica contours map tile package
- Description: Santa Monica contours map tile package
Click New Bounding Box and set the following information:
- West: -118.521
- East: -118.440
- South: 33.992
- North: 34.053

Set the map coordinate System

An additional part of the vector tile creation process is to set the coordinate system of your map.

Select and right-click on Map > Properties.
In the Map Properties window, click Coordinate System.
In the XY Coordinate Systems Available, enter Web Mercator in the search textbox.
Select WGS 1984 Web Mercator (auxiliary sphere)
Click OK
Click Save Project

Create the map tile package

In the Analysis ribbon, click Tools. The Geoprocessing pane is displayed.
In the search textbox, enter create map tile package and click the first item to launch the tool.
In the Create Map Tile Package geoprocessing tool, set the following information:
- Input Map: Map
- Click the Browse button. Set SantaMonicaMapTilePackage as the name and path for the Output File
- Tiling Format: PNG 8 bit
- Minimum Level Of Detail: 0 ( 591657527.591555 )
- Maximum Level of Detail: 22 ( 141.062147 )
- Extent: Default
- Package type: tpkx
Click Run.

Publish the map tile package

To share and publish the map tile package, follow these instructions:

In a web browser, go to ArcGIS.com and sign in with your ArcGIS Location Platform accountAn ArcGIS Location Platform account, formerly known as an ArcGIS Developer account, is an identity associated with an ArcGIS Location Platform subscription.Learn more.
In the top navigation bar, click Content.
Click New item. To upload the SantaMonicaMapTilePackage.tpkx file, you can either:
- Drag and drop the file.
- Or, click Your device and navigate to the file path.
Select SantaMonicaMapTilePackage.tpkx and create a hosted layer.
Click Next.
Set the following information:
- Title: Santa Monica (map tile)
- Tags: Santa Monica, map, tile, service
Click Save.

The Santa Monica (map tile) hosted map tile layer is created.

Scripting APIs

You can also publish the elevation data feature layer to create a map tile service using the ArcGIS API for Python or ArcGIS REST JS. The general steps are as follows:

Import the required libraries.
Reference the source feature layer.
Define the publish parameters.
Execute the publish operation.
Handle the results.

Expand

Use dark colors for code blocks

Copy

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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
tile_service = item.publish(
    publish_parameters=tile_params,
    output_type="tiles",
    file_type="featureService",
    build_initial_cache=False,
)

print(f"New item created:\n\tid:{tile_service.id}\n\turl: {tile_service.url}")

Go to API reference

Expand
Use dark colors for code blocksCopy
  // execute publish operation
  const mapTileLayerService = await request(publishURL, {
    authentication: auth,
    params: {
      itemid: '<YOUR ITEM ID>',
      outputType: 'tiles',
      filetype: 'featureService',
      publishParameters: mapTileParams,
    },
  });

  // handle results
  console.log('New service created: ');
  mapTileLayerService.services.forEach((s) => {
    console.log(`\tid: ${s.serviceItemId} \n\turl:${s.serviceurl}`);
  });
Expand
Go to API reference

Get an access token

By default, the sharing level of an item is set to Owner and requires an access token, such as an API key to access it in a client-side application. If you have an ArcGIS Location Platform or ArcGIS Online account, you can scope an API key to access private items. You cannot scope an API key to access private items if you have an ArcGIS Enterprise account. Instead, to access private items, you need to generate a token from an OAuth 2.0 workflow.

Click Content > My Content.
Click the New Item > Developer credentials.
In the Create developer credentials window, select API key credentials. Click Next.
Set an expiration date for your API key. API keys can be valid for up to one year. Then, click Next.
In the Privileges menu, check the following privileges:
- Location services > Basemaps
In the Grant item access menu, click Browse items.
Select the tile layer item you just created. Then, click Next.
Fill out the following properties:
- Title: API key - Data services workflow
- Tags: authentication, data, hosting, workflow, portal
- Summary: API key used to provide authentication for data hosting workflows.
Click Next.
Review your selections and, when you are ready, click Next.
Click Generate the API key and go to item details page. I am ready to copy and save the key.
Click Next.
Copy the API key and store it safely. You will not be able to view it again later. If you lose it, you will have to generate another key.

Click Content > My Content.
Click the New Item > Developer credentials.
In the Create developer credentials window, select API key credentials. Click Next.
Set an expiration date for your API key. API keys can be valid for up to one year. Then, click Next.
In the Privileges menu, check the following privileges:
- Location services > Basemaps
In the Grant item access menu, click Browse items.
Select the tile layer item you just created. Then, click Next.
Fill out the following properties:
- Title: API key - Data services workflow
- Tags: authentication, data, hosting, workflow, portal
- Summary: API key used to provide authentication for data hosting workflows.
Click Next.
Review your selections and, when you are ready, click Next.
Click Generate the API key and go to item details page. I am ready to copy and save the key.
Click Next.
Copy the API key and store it safely. You will not be able to view it again later. If you lose it, you will have to generate another key.

Click Content > My Content.
Click the New Item > Application.
Under Application Type, select Other application. Click Next.
Fill out the following properties:
- Title: Data hosting workflow - Application Id
- Tags: authentication,appid, data, hosting, workflow
- Summary: AppId used to provide authentication for data hosting workflows
Click Save. Once saved, you will be redirected to the item page.
Click the Overview tab.
Under Credentials, Temporary Token click Copy to clipboard to copy the access tokenAn access token is an authorization string that provides access to secure ArcGIS content, data, and services. Its capabilities are determined by the privileges it supports. It is obtained by implementing API key authentication, User authentication, or App authentication.Learn more.

Find the service URL and item ID

To access a hosted layer from an application, you need to be able to identify its 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 and URL. If a layer is public, you use the URL or item ID to access it directly with your web browser or any application. If the layer is private, you need to provide an access token.

If you are using ArcGIS Maps SDKs:

In the item page, click View to access the service. Locate the Service ItemId, which will look something like this:
- Service ItemID: 5fd812155876416997c1a03e841e8821

If you are using open source libraries:

In the item page, scroll down to the bottom of the page to find the URL. For example:
- URL: https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Santa_Monica_contours_(map_tiles)/MapServer

If you are using ArcGIS Maps SDKs:

In the item page, click View to access the service. Locate the Service ItemId, which will look something like this:
- Service ItemID: 5fd812155876416997c1a03e841e8821

If you are using open source libraries:

In the item page, scroll down to the bottom of the page to find the URL. For example:
- URL: https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Santa_Monica_contours_(map_tiles)/MapServer

If you are using ArcGIS Maps SDKs:

In the item page, click View to access the service. Locate the Service ItemId, which will look something like this:
- Service ItemID: 5fd812155876416997c1a03e841e8821

If you are using open source libraries:

In the item page, scroll down to the bottom of the page to find the URL. For example:
- URL: https://{host}/{webadaptor}/rest/services/Hosted/{serviceName}/MapServer

Display tiles

To display map tiles from the Santa Monica elevation contours map tile service, you need to use a client-side mapping API such as an ArcGIS Maps SDKArcGIS Maps SDKs are developer products for building mapping and spatial analysis applications for web browsers, native devices, and game engines.Learn more or open source library. Typically, you use a client-side tile layer class and set the service URL and layer index to access the feature layer.

Select an ArcGIS Maps SDK or open source library.
In the layer item page, find the service URL and layer index or the item ID.
In the code, set the service URL to the client-side URL parameter or the item ID to the portal item parameter.
Add the layer to the map.

ArcGIS Maps SDK for JavaScript

ArcGIS Maps SDK for .NET

ArcGIS Maps SDK for Qt

ArcGIS Maps SDK for Flutter

ArcGIS Maps SDK for Kotlin

ArcGIS Maps SDK for Swift

Leaflet

MapLibre GL JS

OpenLayers

Expand

Use dark colors for code blocks

Copy

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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

      const portal = new Portal({
        url: "https://www.arcgis.com/",
        authMode: "immediate",
      });

      // OR
      esriConfig.apiKey = "YOUR_ACCESS_TOKEN";

      const imageLayer = new TileLayer({
        portalItem: {
          id: "5fd812155876416997c1a03e841e8821",
        },
      });

      const map = new Map({
        basemap: "arcgis/light-gray",
        layers: [imageLayer],
      });