Get started

To start building applications with ArcGIS REST JS and ArcGIS services you need an ArcGIS account. If you have an ArcGIS Developer account or ArcGIS Online account, follow the steps below to authenticate with an API key.

1. Sign in with your ArcGIS account

2. Get an access token

Use an API key or OAuth 2.0 access token from your developer dashboard. Learn more in Security and authentication.

3. Create your first app

Use ArcGIS REST JS and make a geocoding request to the geocoding service.

1. Open the code in CodePen.

2. Replace the apiKey with your API key from the dashboard.

   CDNCDNES ModulesNode JS

   Expand

   Use dark colors for code blocks

                                                       

   Change line

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
       <!-- require ArcGIS REST JS libraries from https://unpkg.com -->
       <script src="https://unpkg.com/@esri/arcgis-rest-request@4.0.0/dist/bundled/request.umd.js"></script>
       <script src="https://unpkg.com/@esri/arcgis-rest-geocoding@4.0.0/dist/bundled/geocoding.umd.js"></script>
   
       <script>
         /* when including ArcGIS REST JS all exports are available
       from the same arcgisRest global */
   
         const apiKey = "YOUR_API_KEY";
   
         const authentication = arcgisRest.ApiKeyManager.fromKey(apiKey);
   
         arcgisRest
           .geocode({
             address: "1600 Pennsylvania Ave",
             postal: 20500,
             countryCode: "USA",
             authentication
           })
           .then((response) => {
             console.log("Candidates:", response.candidates);
             document.getElementById("result").textContent = JSON.stringify(response.candidates, null, 2);
           });
   
       </script>
   

   Expand

   Result

4. Explore the tutorials

Follow step-by-step tutorials to learn more about how to integrate ArcGIS REST JS with other location services.

5. Deploy your application

Learn about general guidelines and the Terms of use before distributing your application.

• Overview

  Learn about ArcGIS REST JS and how to get started.

• Get started

  Get an ArcGIS account and start using ArcGIS REST JS.

• Tutorials

  Follow step-by-step instructions to access different ArcGIS services.