Tutorial: Display a web map

Get an access token

You need an 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 to use the data in this tutorial.

1. Go to the Create an API key tutorial to obtain an 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.
2. Ensure that the following privilegePrivileges are a set of permissions assigned to ArcGIS accounts, developer credentials, and applications that grant access to secure resources and functionality in ArcGIS.Learn more is enabled: Location services > Basemaps > Basemap styles service
3. Copy the key as it will be used in a following step.

To learn more about other ways to get an access token, go to Types of authentication.

Import modules and log in

1. 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
   
   from arcgis.gis import GIS
   
   

2. Log in to the portal and paste the API key you copied earlier.

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   
   from arcgis.gis import GIS
   
   portal = GIS(api_key="<YOUR_ACCESS_TOKEN>")
   
   

Search for the web map

1. Search for a publicly available web map titled LA Parks and Trails Map (styled) owned by esri_devlabs. It contains datasets of Los Angeles, CA parks and trails.

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   
   from arcgis.gis import GIS
   
   portal = GIS(api_key="<YOUR_ACCESS_TOKEN>")
   
   webmap_search = portal.content.search(
     query="LA Parks and Trails Map (styled) tags:tutorial owner:esri_devlabs",
     item_type="Web Map"
   )
   webmap_search
   
   

2. Create a variable from the first item in search results.

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   
   webmap_search = portal.content.search(
     query="LA Parks and Trails Map (styled) tags:tutorial owner:esri_devlabs",
     item_type="Web Map"
   )
   webmap_search
   
   webmap_item = webmap_search[0]
   webmap_item
   
   

Display the web map

1. Pass in web map item to the map widget constructor to display the web map.

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   
   webmap_item = webmap_search[0]
   webmap_item
   
   map = portal.map(webmap_item)
   map