Find answers and key resources for successfully building apps with OpenLayers and ArcGIS.
General
This guide is for:
- New developers interested in building mapping applications using ArcGIS and OpenLayers.
- ArcGIS developers who want to use an open-source library like OpenLayers to display maps in web applications.
- OpenLayers developers who want to integrate ArcGIS services in their applications.
Go to Open Source Mapping Libraries on Esri Community.
The ol-mapbox-style library, provided by the OpenLayers developers, allows you to create a map from Mapbox Style Specification objects in an OpenLayers application. You use the library to display default and custom ArcGIS basemap layer styles.
To learn how to use ol-mapbox-style to add an ArcGIS basemap styles, go to Migration.
ArcGIS services
OpenLayers has built in functionality to access the following ArcGIS services:
- ArcGIS Basemap Styles service
The ArcGIS Basemap Styles service, also referred to as the Basemap Styles service, is a location service that provides basemap styles and data for the world. It returns styles as Mapbox styles and web maps, and data as vector tiles and/or map tiles. It supports all of the styles in the ArcGIS Basemap style and Open Basemap style family. An ArcGIS Location Platform or ArcGIS Online account is required to use the service. (using theol-mapbox-stylelibrary) -
ArcGIS Static Basemap Tiles service
The ArcGIS Static Basemap Tiles service, also known as the Static Basemap Tiles service, is a location service that provides basemap data as pre-rendered and pre-styled map tiles for the world. It supports key styles in the ArcGIS Basemap style family. An ArcGIS Location Platform account is required to use the services. - Feature service
A feature service is a data service that provides access to spatial and non-spatial data in feature layers, feature layer views, and tables. (via GeoJSON) -
Vector tile service
A vector tile service is a data service that provides access to vector tile data and a style definition. -
Map tile service
A 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.
You can also access other services such as the ArcGIS Geocoding service
You need either an ArcGIS Location Platform account or ArcGIS Online account to access ArcGIS Location Services. This will give you the ability to access the portal, create developer credentials, and manage your data.
You can not use an ArcGIS Enterprise account to access ArcGIS Location Services.
The table below shows the account types you can use to access each service:
ArcGIS Location Services
Yes, you need to provide an API key or implement another type of authentication to access ArcGIS Location Services
ArcGIS Enterprise services
For services that are private, yes, you need to provide authentication to access ArcGIS Enterprise services. You typically implement OAuth 2.0 to do so. Public services do not require authentication.
To learn more about the different types of authentication, go to Types of authentication.
To learn more about ArcGIS Location Services and capabilities, go to the Mapping and location services guide.
To learn more about ArcGIS Enterprise services and capabilities, go to the REST API documentation.
Data services
Data services
-
Feature services
A feature service is a data service that provides access to spatial and non-spatial data in feature layers, feature layer views, and tables. -
Vector tile services
A vector tile service is a data service that provides access to vector tile data and a style definition. -
Map tile services
A 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. -
Image services
An image service is a data service that can store, process, analyze, and share raster data.
Data services are typically created by importing data with the data management tools
The type of data service you use depends on the product you have, the format of your existing data, storage and output data format requirements, the size and complexity of the data, and the service functionality required.
Below is an overview of the main services and the data type each supports.
| Data service | Data type | Data output | Use cases |
|---|---|---|---|
| Feature service | Feature (geometry and/or attributes) | JSON, PBF, GeoJSON | Display, visualization, editing, updating, accessing geometry, accessing attributes |
| Vector tile service | Vector tile | PBF | Display, styling, accessing attributes |
| Map tile service | Map tile | PNG32 | Display |
| Image service | Static and dynamic tiles | JPEG, PNG, LERC | Display, visualization, anlaysis, mosaicking images |
Yes, Esri offers data hosting through ArcGIS Location Platform
ArcGIS Location Platform
With ArcGIS Enterprise
You can import and host many different types of geographic data as data services
To learn more about supported data types, go to Portal and data services > Data services.
OpenLayers can display data from ArcGIS services by loading them as any other map or feature source.
- Feature services and vector tile services can be requested as vector data (often in GeoJSON format, parsed with
ol.format.) and displayed withGeo JSON ol.layer..Vector - Map tile services can be added as tiled map layers using
ol.layer..Tile
No, your data is your data. You retain complete ownership of your content.
Service usage and billing
- ArcGIS Online: As an organization administrator, use the ArcGIS portal
ArcGIS 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. to generate reports on basemap usage. - ArcGIS Location Platform: Use your ArcGIS Location Platform dashboard to view basemap session and tile usage. To learn more, see Basemap usage .
The cost to access ArcGIS location services
-
If you have an ArcGIS Location Platform account
An ArcGIS Location Platform account, formerly known as an ArcGIS Developer account, is an identity associated with an ArcGIS Location Platform subscription. , you are billed in US dollars. To determine the cost of accessing different services, go to Pricing. A free tier of access is available for some services. -
If you have an ArcGIS Online account
An 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. , you are billed in creditsCredits are the currency used by ArcGIS Online Organization accounts to account for data storage and location service consumption. Credits are consumed for specific transactions, such as accessing location services, and types of storage, such as storing features, performing analytics, and using premium content. . To determine the cost of accessing different services, go to Understanding credits.
If you have ArcGIS Enterprise, there is no cost for accessing your own ArcGIS services.
To find the Esri Terms of Use, go to Terms of use.