Sign up for an ArcGIS account to start making requests with ArcGIS REST JS for your application:
Create an account to access, manage, and monitor the use of location services.
ArcGIS Location Platform
- For individual developers.
- Build public applications that don't require users to sign in with an ArcGIS account.
- Billing: Use free tiers and pay-as-you-go to use location services and host your data.
- Learn more about the product and billing at ArcGIS Location Platform.
ArcGIS Online
- For developers in an organization.
- Build private applications for your organization that requires users to sign in with an ArcGIS account.
- Build public applications that don't require users to sign in.
- Build low-code/no-code applications with app builders.
- Billing: Pay for credits yearly to use location services and host your data.
- Learn more about the product and billing at ArcGIS Online.
Browse the topics to learn what you can build with ArcGIS REST JS.
Data services
Access hosted layers and services to return data, make queries, and edit features.
Geocoding
Find addresses and get suggestions with the geocoding service.
Routing
Find routes and directions and perform analyses with the routing service.
Places
Search for places near a location with the places service.
Data enrichment
Get local facts and demographic data with the GeoEnrichment service.
Spatial analysis
Perform feature analysis with the spatial analysis services.
Create developer credentials so you can get an access token.
API key credentials
- Build public applications that don't require users to sign in with an ArcGIS account.
- Access tokens are long-lived.
- Service usage billed to the developer.
- Learn more in API key authentication.
OAuth 2.0 credentials (for user authentication)
- Build private applications for your organization that requires users to sign in with an ArcGIS account.
- Access tokens are short-lived.
- Service usage is billed to the organization of the user signed into the application.
- Learn more in User authentication.
Use ArcGIS REST JS to make a sample request to the geocoding service.
<!-- require ArcGIS REST JS libraries from https://unpkg.com -->
<script src="https://unpkg.com/@esri/arcgis-rest-request@4/dist/bundled/request.umd.js"></script>
<script
src="https://unpkg.com/@esri/arcgis-rest-geocoding@4/dist/bundled/geocoding.umd.js"></script>
<style>
body {
font-family: monospace;
color: white;
background: #000000;
}
pre {
overflow: auto;
padding: 1rem;
background: #000000;
}
</style>
</head>
<body>
<pre id="result"></pre>
<script>
/* when including ArcGIS REST JS all exports are available
from the same arcgisRest global */
/* Use for API key authentication */
const accessToken = "YOUR_ACCESS_TOKEN";
const authentication = arcgisRest.ApiKeyManager.fromKey(accessToken);
// or
/* Use for user authentication */
// const authentication = await arcgisRest.ArcGISIdentityManager.beginOAuth2({
// clientId: "YOUR_CLIENT_ID", // Your client ID from OAuth credentials
// redirectUri: "YOUR_REDIRECT_URI", // The redirect URL registered in your OAuth credentials
// portal: "https://www.arcgis.com/sharing/rest" // Your portal URL
// })
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>