Current release

Release Notes (2.3.0) : Released 6th March 2024

• The worldview query parameter is no longer in beta - see API reference. This parameter allows you to control the display of disputed borders and labels for specific countries, for key ArcGIS styles. To learn more, see this page.
• The places query parameter is no longer in beta - see API reference. This option allows you to control the display of places, or points of interest, on arcgis/navigation and arcgis/navigation-dark styles. With the attributed option, you can also fetch additional details about a place or point of interest. To learn more about this workflow, see this page.
• Using a style with places=attributed is now rendered correctly with MapLibre.
• The self describing endpoints now include details of supported places and worldview options for a given style.
• Duplicate query parameters are now rejected to avoid ambiguity of requests.

---

Release Notes (2.2.0) : Released 10th November 2023

Includes the following new features:

Beta

• A places query parameter that allows you to display places with arcgis/navigation and arcgis/navigation-dark styles.
• A worldview query parameter that allows you to display worldview borders and labels for specific countries using some ArcGIS styles.

NOTE: These are beta features with some limitations. To ask questions or provide feedback, please go to the Early Adopter Community.

Release

• The basemap styles service will now enforce that your token or API key has the user:premiun:basemaps scope (available for all keys by default).

• Added OpenAPI Specification endpoints. This gives developers access to the yaml description of the API.

• Added new endpoints that describe the service capabilities in JSON, which allows the user to build dynamic UI apps such as a basemap picker.

  • arcgis/rest/services/styles/v2/self
  • arcgis/rest/services/styles/v2/webmaps/self
  • arcgis/rest/services/styles/v2/styles/self

• Addressed problem with Access-Control-Headers when making a preflight header request.

• Fixed issue with the display of Arabic labels for osm/light-gray and osm/dark-dray styles.

• Improved language code fallback for unsupported languages - for example using fr-CA will now result in fr.

• Return more informative response messages when a given item id does not correspond to a style.

• HTTP response headers now contain cache control values. These allow clients to keep their cached responses for a sensible amount of time.

---

Release Notes (2.1.0) : Released August 2023

The basemap styles service (v2) includes several improvements to the basemap styles service (v1).

This includes the following:

• New service URL endpoints to return map styles according to the Mapbox Style Specification or the Esri Web Map Specification.

• New ArcGIS and OSM map styles:

  • Outdoor
  • Human geography
  • OSM blueprint
  • OSM hybrid
  • OSM navigation
  • OSM navigation (night)

• Extended language support for place labels and local language support options.

• API key support and HTTP header authentication.

• Open API specification compliant.

• Error response that use standard HTTP status codes (e.g. 400 or 401) rather than 200.