{"id":1401712,"date":"2021-12-15T15:00:08","date_gmt":"2021-12-15T23:00:08","guid":{"rendered":"https:\/\/www.esri.com\/arcgis-blog\/?post_type=blog&p=1401712"},"modified":"2024-04-12T03:51:31","modified_gmt":"2024-04-12T10:51:31","slug":"open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service","status":"publish","type":"blog","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service","title":{"rendered":"Open source developers: Time to upgrade to the new ArcGIS basemap layer service!"},"author":3791,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":""},"categories":[738191],"tags":[33301,762932,762922,43801,763382],"industry":[],"product":[761642,36601],"class_list":["post-1401712","blog","type-blog","status-publish","format-standard","hentry","category-developers","tag-arcgis-platform","tag-leaflet","tag-location-services","tag-migration","tag-openlayers","product-platform","product-developers"],"acf":{"short_description":"Update Leaflet, Esri Leaflet, OpenLayers, and Mapbox web applications to use the new ArcGIS basemap layer service.","flexible_content":[{"acf_fc_layout":"content","content":"
\n
If you have built a mapping application with an open source client API such as Leaflet<\/a>, Esri Leaflet<\/a>, Openlayers<\/a>, or Mapbox<\/a>, that uses the legacy ArcGIS Online tile services,<\/a> then it’s time to update to the new ArcGIS basemap layer service<\/a>!<\/div>\n
<\/div>\n
The legacy ArcGIS Online tile services<\/a> are in mature status<\/a> and are no longer being updated. So to ensure uninterrupted access and to comply with Esri\u2019s Terms of Use<\/a>, applications need to be updated before April 30, 2022<\/strong><\/a>.<\/div>\n
<\/div>\n
The good news is that updating<\/a> is easy and you can still access basemap services for free<\/a>!<\/div>\n

The new ArcGIS basemap layer service<\/h2>\n
The new ArcGIS basemap layer service<\/a> replaces the legacy ArcGIS Online tile services<\/a>. The new service provides much better performance, especially for applications accessed from different countries around the world, and it also provides higher resolution satellite imagery for new geographic regions.<\/div>\n
<\/div>\n
We also encourage you to use the new vector tile basemap service<\/a>. The service supports the Mapbox Vector Tile Specification<\/a> and is easy to integrate with open source APIs. Vector tiles provide the best overall performance and you can choose from over 25 vector tile styles<\/a> for your applications.<\/div>\n
<\/div>\n
The vector tile service also supports creating your own basemap styles with the Vector Tile Style Editor<\/a>, so you can brand your applications with custom colors, fonts, and glyphs. Learn how to create custom styles in the Create a custom style tutorial<\/a>.<\/div>\n<\/div>\n"},{"acf_fc_layout":"image","image":{"ID":1431452,"id":1431452,"title":"all-basemap-styles","filename":"all-basemap-styles.png","filesize":611388,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/11\/all-basemap-styles.png","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service\/all-basemap-styles","alt":"","author":"3791","description":"","caption":"","name":"all-basemap-styles","status":"inherit","uploaded_to":1401712,"date":"2021-12-09 22:06:20","modified":"2021-12-09 22:06:20","menu_order":0,"mime_type":"image\/png","type":"image","subtype":"png","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":1164,"height":614,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/11\/all-basemap-styles-213x200.png","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/11\/all-basemap-styles.png","medium-width":464,"medium-height":245,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/11\/all-basemap-styles.png","medium_large-width":768,"medium_large-height":405,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/11\/all-basemap-styles.png","large-width":1164,"large-height":614,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/11\/all-basemap-styles.png","1536x1536-width":1164,"1536x1536-height":614,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/11\/all-basemap-styles.png","2048x2048-width":1164,"2048x2048-height":614,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/11\/all-basemap-styles-826x436.png","card_image-width":826,"card_image-height":436,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/11\/all-basemap-styles.png","wide_image-width":1164,"wide_image-height":614}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Steps to update your applications<\/h2>\n

<\/a>Follow these steps to replace the legacy services with the new basemap service:<\/p>\n

1. Identify the legacy basemap services<\/h3>\n

If your application uses any of the URL endpoints below, then you need to update your application.<\/p>\n"},{"acf_fc_layout":"sidebar","content":"

\n

World Street Map<\/strong><\/p>\n

https:\/\/services.arcgisonline.com\/arcgis\/rest\/services\/World_Street_Map\/MapServer<\/a><\/p>\n

World Topo Map<\/strong><\/p>\n

https:\/\/services.arcgisonline.com\/arcgis\/rest\/services\/World_Topo_Map\/MapServer<\/a><\/p>\n

World Light and Dark Gray Canvas<\/strong><\/p>\n

https:\/\/services.arcgisonline.com\/arcgis\/rest\/services\/Canvas\/World_Dark_Gray_Base\/MapServer<\/a><\/p>\n

https:\/\/services.arcgisonline.com\/arcgis\/rest\/services\/Canvas\/World_Dark_Gray_Reference\/MapServer<\/a><\/p>\n

https:\/\/services.arcgisonline.com\/arcgis\/rest\/services\/Canvas\/World_Light_Gray_Base\/MapServer<\/a><\/p>\n

https:\/\/services.arcgisonline.com\/arcgis\/rest\/services\/Canvas\/World_Light_Gray_Reference\/MapServer<\/a><\/p>\n

World Boundaries and Places<\/strong><\/p>\n

https:\/\/services.arcgisonline.com\/arcgis\/rest\/services\/Reference\/World_Boundaries_and_Places_Alternate\/MapServer<\/a><\/p>\n

https:\/\/services.arcgisonline.com\/arcgis\/rest\/services\/Reference\/World_Boundaries_and_Places\/MapServer<\/a><\/p>\n

https:\/\/services.arcgisonline.com\/arcgis\/rest\/services\/Reference\/World_Reference_Overlay\/MapServer<\/a><\/p>\n

World Transportation<\/strong><\/p>\n

https:\/\/services.arcgisonline.com\/arcgis\/rest\/services\/Reference\/World_Transportation\/MapServer<\/a><\/p>\n

World National Geographic<\/strong><\/p>\n

https:\/\/services.arcgisonline.com\/arcgis\/rest\/services\/NatGeo_World_Map\/MapServer<\/a><\/p>\n<\/div>\n","image_reference":false,"layout":"standard","image_reference_figure":"","snippet":"","spotlight_name":"","section_title":"","position":"Center","spotlight_image":false},{"acf_fc_layout":"content","content":"

2. Get an ArcGIS account<\/a><\/h3>\n
To use the new basemap layer service, you need an ArcGIS Developer<\/a> (for individual developers) or ArcGIS Online account<\/a> (for organizations). If you don\u2019t have one, you can sign up<\/a> for free.<\/div>\n
<\/div>\n
NOTE:<\/strong> A developer account gives you access to 2,000,000 basemap tiles for free<\/a> per month.<\/div>\n

3. Get an API key<\/h3>\n

Log in to the developer dashboard<\/a> and get an API key (access token)<\/a>.<\/p>\n

4. Reference the new services<\/h3>\n

Use your API key to access the new basemap layer service<\/a>. Use the URL endpoints below or go to the specific code examples for Leaflet<\/a>, Mapbox<\/a>, and OpenLayers<\/a>.<\/p>\n

Image tiles<\/strong><\/p>\n

\n

To access the new image tiles<\/a> directly for satellite imagery, ocean, or hillshade, use the URL below with {z}<\/code>,{y}<\/code>,and {x}<\/code> values and a token<\/code>.<\/p>\n

https:\/\/ibasemaps-api.arcgis.com\/arcgis\/rest\/services\/{ImageryType}\/MapServer\/tile\/{z}\/{y}\/{x}?token={ACCESS_TOKEN}\r\n<\/code><\/pre>\n<\/div>\n
\n
Examples<\/p>\n
https:\/\/ibasemaps-api.arcgis.com\/arcgis\/rest\/services\/World_Imagery\/MapServer\/tile\/{z}\/{y}\/{x}?token={ACCESS_TOKEN}\r\nhttps:\/\/ibasemaps-api.arcgis.com\/arcgis\/rest\/services\/Ocean\/World_Ocean_Base\/MapServer\/tile\/{z}\/{y}\/{x}?token={ACCESS_TOKEN}\r\nhttps:\/\/ibasemaps-api.arcgis.com\/arcgis\/rest\/services\/Elevation\/World_Hillshade\/MapServer\/tile\/{z}\/{y}\/{x}?token={ACCESS_TOKEN}<\/code><\/pre>\n<\/div>\n
Vector tiles<\/strong><\/p>\n
To access the new vector tile styles<\/a>, use the URL below with the basemapStyle<\/code>, type<\/code>, and token<\/code> (either an API key or OAuth 2.0 token). The type<\/code> should be set to style<\/code>.<\/div>\n
\n
https:\/\/basemaps-api.arcgis.com\/arcgis\/rest\/services\/styles\/{basemapStyle}?type={type}&token={ACCESS_TOKEN}\r\n<\/code><\/pre>\n<\/div>\n
\n
Examples<\/p>\n
https:\/\/basemaps-api.arcgis.com\/arcgis\/rest\/services\/styles\/ArcGIS:Navigation?type={type}&token={ACCESS_TOKEN}\r\nhttps:\/\/basemaps-api.arcgis.com\/arcgis\/rest\/services\/styles\/OSM:Standard?type={type}&token={ACCESS_TOKEN}\r\nhttps:\/\/basemaps-api.arcgis.com\/arcgis\/rest\/services\/styles\/ArcGIS:Streets?type={type}&token={ACCESS_TOKEN}\r\nhttps:\/\/basemaps-api.arcgis.com\/arcgis\/rest\/services\/styles\/ArcGIS:Imagery?type={type}&token={ACCESS_TOKEN}\r\n<\/code><\/pre>\n<\/div>\n"},{"acf_fc_layout":"content","content":"
<\/a>How to update Leaflet and Esri Leaflet apps<\/h3>\n
The easiest way to update Leaflet<\/a> applications is to use the Esri Leaflet plugin<\/a>. You need to load the Esri Leaflet CDN or npm package<\/a> as well as the Esri Leaflet Vector Plugin<\/a>.<\/p>\n
NOTE: If you already use the Esri Leaflet API with the L.Esri.BasemapLayer<\/code> class, you need to use the L.esri.Vector.vectorBasemapLayer<\/code> plugin since the L.Esri.BasemapLayer<\/code> class is deprecated.<\/p>\n
After the libraries are loaded, you can use your API key to access all of the basemap layer styles available.<\/p>\n
Learn more in the Esri Leaflet and location services developer guide<\/a>.<\/p>\n
Example<\/h3>\n"},{"acf_fc_layout":"content","content":"
<script<\/span> src<\/span>=\"https:\/\/unpkg.com\/esri-leaflet@3.0.3\/dist\/esri-leaflet.js\"<\/span>integrity<\/span>=\"sha512-kuYkbOFCV\/SsxrpmaCRMEFmqU08n6vc+TfAVlIKjR1BPVgt75pmtU9nbQll+4M9PN2tmZSAgD1kGUCKL88CscA==\"<\/span>crossorigin<\/span>=\"\"<\/span>><\/span><\/script<\/span>><\/span>\r\n<\/code><\/pre>\n
<script<\/span> src<\/span>=\"https:\/\/unpkg.com\/esri-leaflet-vector@3.1.1\/dist\/esri-leaflet-vector.js\"<\/span>integrity<\/span>=\"sha512-7rLAors9em7cR3\/583gZSvu1mxwPBUjWjdFJ000pc4Wpu+fq84lXF1l4dbG4ShiPQ4pSBUTb4e9xaO6xtMZIlA==\"<\/span>crossorigin<\/span>=\"\"<\/span>><\/span><\/script<\/span>><\/span>\r\n<\/code><\/pre>\n
\r\nconst<\/span> apiKey = \"YOUR_API_KEY\"<\/span>;\r\nconst<\/span> basemapEnum = \"ArcGIS:Navigation\"<\/span>;\r\nconst<\/span> map = L.map('map'<\/span>, {\r\n  minZoom: 2<\/span>\r\n}).setView([25<\/span>,-10<\/span>], 2<\/span>); \/\/Latitude, longitude<\/span>\r\nL.esri.Vector.vectorBasemapLayer(basemapEnum, {\r\n  apiKey: apiKey\r\n}).addTo(map);\r\n<\/code><\/pre>\n"},{"acf_fc_layout":"storymap","title":"","description":"","static":false,"storymap_url":"https:\/\/cdpn.io\/pen\/debug\/eYEawMM\/fa3b038c57237c4797212afc1b9e98bc<\/a>"},{"acf_fc_layout":"content","content":"
<\/div>\n
<\/a>How to update Mapbox GL JS apps<\/h3>\n
If you are using an earlier version of Mapbox GL JS<\/a> (version 1.x), you can access new ArcGIS basemap layer service directly. Replace the old URL endpoints with the new vector tile layer endpoints and include your API key.<\/p>\n
Learn more in the\u00a0 Mapbox GL JS and ArcGIS location services guide<\/a>.<\/p>\n
Example<\/h3>\n"},{"acf_fc_layout":"storymap","title":"","description":"","static":false,"storymap_url":"https:\/\/cdpn.io\/pen\/debug\/xxLNoJm\/a0ce4a0dc1efe67c10332397179846dc<\/a>"},{"acf_fc_layout":"content","content":"
\r\n<script<\/span> src<\/span>=\"https:\/\/api.tiles.mapbox.com\/mapbox-gl-js\/v1.12.0\/mapbox-gl.js\"<\/span>><\/span><\/script<\/span>><\/span>\r\n<link<\/span> href<\/span>=\"https:\/\/api.tiles.mapbox.com\/mapbox-gl-js\/v1.12.0\/mapbox-gl.css\"<\/span> rel<\/span>=\"stylesheet\"<\/span>\/><\/span>\r\n<\/code><\/pre>\n
\r\nconst<\/span> apiKey = <\/span>\"YOUR_API_KEY\"<\/span>;\r\n<\/span>const<\/span> basemapEnum = <\/span>\"ArcGIS:Nova\"<\/span>;  <\/span>\/\/ Basemap layer style<\/span>\r\nconst<\/span> map = <\/span>new<\/span> mapboxgl.Map({\r\n  container: <\/span>\"map\"<\/span>, \r\n  style: \"<\/span>https:\/\/basemaps-api.arcgis.com\/arcgis\/rest\/services\/styles\/\" + basemapEnum+ \"?type=style&token=\" + apiKey;<\/span>\"<\/span><\/span><\/span>,\r\n  zoom: <\/span>1<\/span>,\r\n  center: [-<\/span>5<\/span>, <\/span>30<\/span>] <\/span>\/\/ [longitude, latitude]<\/span>\r\n});\r\n<\/span><\/code><\/pre>\n"},{"acf_fc_layout":"content","content":"
Example<\/h3>\n"},{"acf_fc_layout":"storymap","title":"","description":"","static":false,"storymap_url":"https:\/\/cdpn.io\/pen\/debug\/oNeRrPR\/38aac0cfe1f3b0db23d3e89a97572259<\/a>"},{"acf_fc_layout":"content","content":"
\r\n<link<\/span> rel<\/span>=\"stylesheet\"<\/span> href<\/span>=\"https:\/\/cdn.jsdelivr.net\/gh\/openlayers\/openlayers.github.io@master\/en\/v6.7.0\/css\/ol.css\"<\/span> type<\/span>=\"text\/css\"<\/span> \/><\/span>\r\n<script<\/span> src<\/span>=\"https:\/\/cdn.jsdelivr.net\/gh\/openlayers\/openlayers.github.io@master\/en\/v6.7.0\/build\/ol.js\"<\/span>><\/span><\/script<\/span>><\/span>\r\n<script<\/span> src<\/span>=\"https:\/\/cdn.jsdelivr.net\/npm\/ol-mapbox-style@6.1.4\/dist\/olms.js\"<\/span>><\/span><\/script<\/span>><\/span>\r\n<\/code><\/pre>\n
\r\nconst<\/span> apiKey = \"YOUR_API_KEY\"<\/span>;\r\nconst<\/span> basemapId = \"ArcGIS:Topographic\"<\/span>;\r\nconst<\/span> basemapURL = \"https:\/\/basemaps-api.arcgis.com\/arcgis\/rest\/services\/styles\/\"<\/span> + basemapId + \"?type=style&token=\"<\/span> + apiKey;\r\nolms(map, basemapURL); \/\/OpenLayers Mapbox style<\/span>\r\n<\/code><\/pre>\n"},{"acf_fc_layout":"content","content":"
<\/h3>\n
Summary<\/h3>\n
The legacy ArcGIS Online tile services<\/a> have been in mature status<\/a> for some time now, so to ensure uninterrupted service access, and to comply with Esri\u2019s Terms of Use<\/a>, you need to update to the new ArcGIS basemap layer service<\/a> before April 30, 2022<\/strong><\/a>.<\/p>\n
Also, if you are interested in using other ArcGIS location services such as geocoding or routing with open source APIs, visit the Mapping APIs and location service guide<\/a>.<\/p>\n
Please let us know if you have any questions or concerns.<\/p>\n"}],"authors":[{"ID":3791,"user_firstname":"Allan","user_lastname":"Laframboise","nickname":"Allan Laframboise","user_nicename":"alaframboise","display_name":"Allan Laframboise","user_email":"alaframboise@esri.com","user_url":"","user_registered":"2018-03-02 00:15:25","user_description":"Allan Laframboise is the product engineering lead for documentation for the Developer Experience team.","user_avatar":""},{"ID":290882,"user_firstname":"Anita","user_lastname":"Kemp","nickname":"Anita Kemp","user_nicename":"akemp","display_name":"Anita Kemp","user_email":"akemp@esri.com","user_url":"","user_registered":"2021-10-27 14:50:10","user_description":"Anita Kemp is a product engineer on the Developer Experience team.","user_avatar":""}],"related_articles":"","card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/11\/open-src-blog-image-sm.png","wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/11\/open-src-blog-image-main.png"},"yoast_head":"\nTime to upgrade to the new ArcGIS basemap layer service!<\/title>\n<meta name=\"description\" content=\"Update Leaflet, Esri Leaflet, OpenLayers, and Mapbox web applications to access ArcGIS basemap layer styles .\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Open source developers: Time to upgrade to the new ArcGIS basemap layer service!\" \/>\n<meta property=\"og:description\" content=\"Update Leaflet, Esri Leaflet, OpenLayers, and Mapbox web applications to access ArcGIS basemap layer styles .\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service\" \/>\n<meta property=\"og:site_name\" content=\"ArcGIS Blog\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/esrigis\/\" \/>\n<meta property=\"article:modified_time\" content=\"2024-04-12T10:51:31+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@ESRI\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":[\"Article\",\"BlogPosting\"],\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service\"},\"author\":{\"name\":\"Allan Laframboise\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/75ba757d8916c44e793e6d2a7963fdac\"},\"headline\":\"Open source developers: Time to upgrade to the new ArcGIS basemap layer service!\",\"datePublished\":\"2021-12-15T23:00:08+00:00\",\"dateModified\":\"2024-04-12T10:51:31+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service\"},\"wordCount\":13,\"commentCount\":6,\"publisher\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#organization\"},\"keywords\":[\"ArcGIS Platform\",\"leaflet\",\"location services\",\"migration\",\"openlayers\"],\"articleSection\":[\"Developers\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service\",\"url\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service\",\"name\":\"Time to upgrade to the new ArcGIS basemap layer service!\",\"isPartOf\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#website\"},\"datePublished\":\"2021-12-15T23:00:08+00:00\",\"dateModified\":\"2024-04-12T10:51:31+00:00\",\"description\":\"Update Leaflet, Esri Leaflet, OpenLayers, and Mapbox web applications to access ArcGIS basemap layer styles .\",\"breadcrumb\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.esri.com\/arcgis-blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Open source developers: Time to upgrade to the new ArcGIS basemap layer service!\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#website\",\"url\":\"https:\/\/www.esri.com\/arcgis-blog\/\",\"name\":\"ArcGIS Blog\",\"description\":\"Get insider info from Esri product teams\",\"publisher\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.esri.com\/arcgis-blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#organization\",\"name\":\"Esri\",\"url\":\"https:\/\/www.esri.com\/arcgis-blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/04\/Esri.png\",\"contentUrl\":\"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/04\/Esri.png\",\"width\":400,\"height\":400,\"caption\":\"Esri\"},\"image\":{\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/esrigis\/\",\"https:\/\/x.com\/ESRI\",\"https:\/\/www.linkedin.com\/company\/5311\/\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/75ba757d8916c44e793e6d2a7963fdac\",\"name\":\"Allan Laframboise\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/af35f23e49f7a462c9c1b97ec1033d5804a0a99ee5b8d6ed09394c1208abf8c9?s=96&d=blank&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/af35f23e49f7a462c9c1b97ec1033d5804a0a99ee5b8d6ed09394c1208abf8c9?s=96&d=blank&r=g\",\"caption\":\"Allan Laframboise\"},\"description\":\"Allan Laframboise is the product engineering lead for documentation for the Developer Experience team.\",\"url\":\"https:\/\/www.esri.com\/arcgis-blog\/author\/alaframboise\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Time to upgrade to the new ArcGIS basemap layer service!","description":"Update Leaflet, Esri Leaflet, OpenLayers, and Mapbox web applications to access ArcGIS basemap layer styles .","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service","og_locale":"en_US","og_type":"article","og_title":"Open source developers: Time to upgrade to the new ArcGIS basemap layer service!","og_description":"Update Leaflet, Esri Leaflet, OpenLayers, and Mapbox web applications to access ArcGIS basemap layer styles .","og_url":"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service","og_site_name":"ArcGIS Blog","article_publisher":"https:\/\/www.facebook.com\/esrigis\/","article_modified_time":"2024-04-12T10:51:31+00:00","twitter_card":"summary_large_image","twitter_site":"@ESRI","schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":["Article","BlogPosting"],"@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service#article","isPartOf":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service"},"author":{"name":"Allan Laframboise","@id":"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/75ba757d8916c44e793e6d2a7963fdac"},"headline":"Open source developers: Time to upgrade to the new ArcGIS basemap layer service!","datePublished":"2021-12-15T23:00:08+00:00","dateModified":"2024-04-12T10:51:31+00:00","mainEntityOfPage":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service"},"wordCount":13,"commentCount":6,"publisher":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/#organization"},"keywords":["ArcGIS Platform","leaflet","location services","migration","openlayers"],"articleSection":["Developers"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service","url":"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service","name":"Time to upgrade to the new ArcGIS basemap layer service!","isPartOf":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/#website"},"datePublished":"2021-12-15T23:00:08+00:00","dateModified":"2024-04-12T10:51:31+00:00","description":"Update Leaflet, Esri Leaflet, OpenLayers, and Mapbox web applications to access ArcGIS basemap layer styles .","breadcrumb":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.esri.com\/arcgis-blog\/"},{"@type":"ListItem","position":2,"name":"Open source developers: Time to upgrade to the new ArcGIS basemap layer service!"}]},{"@type":"WebSite","@id":"https:\/\/www.esri.com\/arcgis-blog\/#website","url":"https:\/\/www.esri.com\/arcgis-blog\/","name":"ArcGIS Blog","description":"Get insider info from Esri product teams","publisher":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.esri.com\/arcgis-blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.esri.com\/arcgis-blog\/#organization","name":"Esri","url":"https:\/\/www.esri.com\/arcgis-blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/04\/Esri.png","contentUrl":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2018\/04\/Esri.png","width":400,"height":400,"caption":"Esri"},"image":{"@id":"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/esrigis\/","https:\/\/x.com\/ESRI","https:\/\/www.linkedin.com\/company\/5311\/"]},{"@type":"Person","@id":"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/75ba757d8916c44e793e6d2a7963fdac","name":"Allan Laframboise","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.esri.com\/arcgis-blog\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/af35f23e49f7a462c9c1b97ec1033d5804a0a99ee5b8d6ed09394c1208abf8c9?s=96&d=blank&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/af35f23e49f7a462c9c1b97ec1033d5804a0a99ee5b8d6ed09394c1208abf8c9?s=96&d=blank&r=g","caption":"Allan Laframboise"},"description":"Allan Laframboise is the product engineering lead for documentation for the Developer Experience team.","url":"https:\/\/www.esri.com\/arcgis-blog\/author\/alaframboise"}]}},"text_date":"December 15, 2021","author_name":"Multiple Authors","author_page":"https:\/\/www.esri.com\/arcgis-blog\/products\/developers\/developers\/open-source-developers-time-to-upgrade-to-the-new-arcgis-basemap-layer-service","custom_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2021\/11\/open-src-blog-image-main.png","primary_product":"Developers","tag_data":[{"term_id":33301,"name":"ArcGIS Platform","slug":"arcgis-platform","term_group":0,"term_taxonomy_id":33301,"taxonomy":"post_tag","description":"","parent":0,"count":18,"filter":"raw"},{"term_id":762932,"name":"leaflet","slug":"leaflet","term_group":0,"term_taxonomy_id":762932,"taxonomy":"post_tag","description":"","parent":0,"count":3,"filter":"raw"},{"term_id":762922,"name":"location services","slug":"location-services","term_group":0,"term_taxonomy_id":762922,"taxonomy":"post_tag","description":"","parent":0,"count":9,"filter":"raw"},{"term_id":43801,"name":"migration","slug":"migration","term_group":0,"term_taxonomy_id":43801,"taxonomy":"post_tag","description":"","parent":0,"count":17,"filter":"raw"},{"term_id":763382,"name":"openlayers","slug":"openlayers","term_group":0,"term_taxonomy_id":763382,"taxonomy":"post_tag","description":"","parent":0,"count":3,"filter":"raw"}],"category_data":[{"term_id":738191,"name":"Developers","slug":"developers","term_group":0,"term_taxonomy_id":738191,"taxonomy":"category","description":"","parent":0,"count":426,"filter":"raw"}],"product_data":[{"term_id":761642,"name":"ArcGIS Location Platform","slug":"platform","term_group":0,"term_taxonomy_id":761642,"taxonomy":"product","description":"","parent":36601,"count":215,"filter":"raw"},{"term_id":36601,"name":"Developers","slug":"developers","term_group":0,"term_taxonomy_id":36601,"taxonomy":"product","description":"","parent":0,"count":765,"filter":"raw"}],"primary_product_link":"https:\/\/www.esri.com\/arcgis-blog\/?s=#&products=developers","_links":{"self":[{"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/blog\/1401712","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/blog"}],"about":[{"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/types\/blog"}],"author":[{"embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/users\/3791"}],"replies":[{"embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/comments?post=1401712"}],"version-history":[{"count":0,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/blog\/1401712\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/media?parent=1401712"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/categories?post=1401712"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/tags?post=1401712"},{"taxonomy":"industry","embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/industry?post=1401712"},{"taxonomy":"product","embeddable":true,"href":"https:\/\/www.esri.com\/arcgis-blog\/wp-json\/wp\/v2\/product?post=1401712"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
<\/a>How to update OpenLayers apps<\/h3>\n
If you are using the OpenLayers API with the TileLayer<\/code> class or another plug-in such as the OL-Mapbox-Style<\/a> library, then update to the new URL endpoints to use your API key.<\/p>\n
Learn more in the OpenLayers and ArcGIS location services guide<\/a>.<\/p>\n