Install and set up
Accessing the API
There are multiple options for bringing the ArcGIS Maps SDK for JavaScript into your app. Read more about AMD and ES modules in Introduction to Tooling.
AMD modules via ArcGIS CDN
The most common approach for accessing the API is to use the hosted version. Reference the API and CSS from our CDN to start using the API in your app.
ES modules via NPM
The API is also available as ES modules via npm, a JavaScript package manager. You can install the API locally for use with JavaScript frameworks such as React and Angular, and with module bundlers such as webpack or rollup.js.
To install:
Then import modules:
For more information, see these guides:
ES modules via CDN
Note: This approach is currently only recommended for development and prototyping.
AMD modules hosted locally
In some cases, you may need to use a locally hosted version of the AMD modules via ArcGIS CDN. An example of this is when you are working in a restricted network environment with no internet access. You can also download and install the documentation which includes the API Reference, tutorials, and samples. The documentation available for download is a snapshot from the release date of version 4.27 and will not include the latest sample updates, documentation fixes, etc.
To download the ArcGIS Maps SDK for JavaScript and its documentation, navigate to the ArcGIS Maps SDK for JavaScript download page and log-in with your Esri global account.
Web server hosting configuration
The web server hosting configuration where you host the ArcGIS Maps SDK for JavaScript will need the following MIME/type registration.
extension | MIME/type | Description |
---|---|---|
.ttf | application/octet-stream | True Type Fonts |
.wasm | application/wasm | WebAssembly |
.woff | application/font-woff | Web Open Font Format |
.woff2 | application/font-woff2 | WOFF File Format 2.0 |
.wsv | application/octet-stream | Supports Scene 's stars visualization |
.pbf | application/x-protobuf | Fonts for MapView labeling for some layers |
Note that a web server supporting HTTPS
requires the web server to use an SSL web server certificate.