ArcGIS location service endpoints

ArcGIS location servicesArcGIS Location Services, also referred to as Location Services, are services hosted by Esri that provide geospatial functionality for developing mapping applications. They include the ArcGIS Basemap Styles service, ArcGIS Static Basemap Tiles service, ArcGIS Places service, ArcGIS Geocoding service, ArcGIS Routing service, ArcGIS GeoEnrichment service, and ArcGIS Elevation service. An ArcGIS Location Platform or ArcGIS Online account is required to use the services.Learn more support different URL endpoints. The endpoint you use to build applications depends on the service functionality required, security certification level desired, and the geographic region the application will run in.

This section provides information about the different types of endpoints, their capabilities, and when to use them.

Types of endpoints

ArcGIS location servicesArcGIS Location Services, also referred to as Location Services, are services hosted by Esri that provide geospatial functionality for developing mapping applications. They include the ArcGIS Basemap Styles service, ArcGIS Static Basemap Tiles service, ArcGIS Places service, ArcGIS Geocoding service, ArcGIS Routing service, ArcGIS GeoEnrichment service, and ArcGIS Elevation service. An ArcGIS Location Platform or ArcGIS Online account is required to use the services.Learn more provide standard endpoints and enhanced endpoints. The base URLs are unique for each, but the input parameters and output values are the same. Therefore, you use the services the same way in your applications.

1. Standard endpoint

Standard endpoints are hosted in a global cloud infrastructure, including the United States. The services are high-performance and optimized to use cloud resources closest to your geographic region.

The following services support standard endpoints:

1
https://basemaps-api.arcgis.com/arcgis/rest/services/<request>&token=<ACCESS_TOKEN>

1
https://ibasemaps-api.arcgis.com/arcgis/rest/services/Ocean/World_Ocean_Base/MapServer/tile/{z}/{y}/{x}?token=<ACCESS_TOKEN>

1
https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer/<request>?<parameters>&f=json&token=<ACCESS_TOKEN>

2. Enhanced endpoint

Enhanced endpoints are hosted in a cloud infrastructure in the United States. The services are high performance and provide more functionality than standard services and offer specific regulatory compliance.

Some enhanced endpoints also support long server-side transactions known as job requestsA job request is an HTTPS request to a service that starts a server-side operation (or job) with a long duration.Learn more. This provides the ability to execute and easily manage the processing of large amounts of data and computationally intensive operations. Some examples include batch geocoding, fleet routing, and location-allocation.

Enhanced services also support different levels of regulatory compliance such as Federal Information Security Management Act (FISMA) and Federal Risk and Authorization Management Program (FedRAMP). The geocoding service is also Health Insurance Portability and Accountability Act HIPAA compliant when geocoding against addresses in the United States. For full list of services and compliance levels, see Regulatory compliance.

Learn more about security, privacy, and compliance information at ArcGIS Trust Center.

The following services support enhanced endpoints:

1
https://<host>/<uniqueID>/ArcGIS/rest/services/<serviceName>/FeatureServer/<request>?<parameters>&token=<ACCESS_TOKEN>

1
https://<host>/arcgis/rest/services/<serviceName>/MapServer/<request>?<parameters>&token=<ACCESS_TOKEN>

1
https://<host>/<uniqueID>/arcgis/rest/services/<serviceName>/VectorTileServer/<request>?<parameters>&token=<ACCESS_TOKEN>

1
https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/<request>?<parameters>&f=json&token=<ACCESS_TOKEN>

1
https://route.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World/solve?<parameters>&token=<ACCESS_TOKEN>

1
https://route-api.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World/solve?<parameters>&token=<ACCESS_TOKEN>

1
https://logistics.arcgis.com/arcgis/rest/services/<request>/submitJob?<parameters>&token=<ACCESS_TOKEN>

1
https://geoenrich.arcgis.com/arcgis/rest/services/<request>?<parameters>&token=<ACCESS_TOKEN>

1
https://www.arcgis.com/sharing/rest/<request>?<parameters>&token=<ACCESS_TOKEN>

1
https://<analysisServer>.arcgis.com/arcgis/rest/services/tasks/GPServer/<request>?<parameters>&token=<ACCESS_TOKEN>

1
https://utility.arcgisonline.com/ArcGIS/rest/services/Geometry/GeometryServer/<request>?<parameters>&token=<ACCESS_TOKEN>

1
https://elevation.arcgis.com/arcgis/rest/services/Tools/Elevation/GPServer/<request>?<parameters>&token=<ACCESS_TOKEN>

1
https://hydro.arcgis.com/arcgis/rest/services/Tools/Hydrology/GPServer/<request>?<parameters>&token=<ACCESS_TOKEN>

Choosing an endpoint

For all application development, it is recommended to use standard endpointsA standard endpoint is a URL for an ArcGIS location service hosted in a global cloud infrastructure. This includes the basemap layer service, and most functionality available in the geocoding service and routing service.Learn more first and then enhanced endpoints An enhanced endpoint is a URL for an ArcGIS location service hosted in a cloud infrastructure in the United States. They support all service functionality and additional levels of security compliance such as Federal Risk and Authorization Management Program (FedRAMP) and Health Insurance Portability and Accountability Act (HIPAA). Some endpoints also support long transactions.Learn more for any additional functionality required or if a higher level of security compliance is required.

To choose the best endpoint to use, consider the following:

1. The functionality required. Standard services are limited to the basemap styles service, geocoding service, and some routing service functionality.
2. The level of regulatory compliance required. For example, FedRAMP compliance.
3. The geographic region (global vs. United States) from which the services will be accessed.

Functionality and availability

The following standardA standard endpoint is a URL for an ArcGIS location service hosted in a global cloud infrastructure. This includes the basemap layer service, and most functionality available in the geocoding service and routing service.Learn more and enhanced endpointsAn enhanced endpoint is a URL for an ArcGIS location service hosted in a cloud infrastructure in the United States. They support all service functionality and additional levels of security compliance such as Federal Risk and Authorization Management Program (FedRAMP) and Health Insurance Portability and Accountability Act (HIPAA). Some endpoints also support long transactions.Learn more are available for ArcGIS location services:

Regulatory compliance

Below is a list of services with enhanced endpointsAn enhanced endpoint is a URL for an ArcGIS location service hosted in a cloud infrastructure in the United States. They support all service functionality and additional levels of security compliance such as Federal Risk and Authorization Management Program (FedRAMP) and Health Insurance Portability and Accountability Act (HIPAA). Some endpoints also support long transactions.Learn more and the level of regulatory compliance supported.

General comparison

Below is a list of the characteristics for each type of endpoint.

Accessing endpoints

To access ArcGIS location service endpoints you need an ArcGIS accountAn ArcGIS account is an identity with a user type and set of privileges that can access specific ArcGIS products, tools, APIs, services, and resources. The main account types that can be used for development are an ArcGIS Location Platform account, ArcGIS Online account, and ArcGIS Enterprise account. ArcGIS Location Platform and ArcGIS Online accounts are also associated with a subscription.Learn more and to authenticate each request.

Accounts

You need an ArcGIS Location Platform accountAn ArcGIS Location Platform account, formerly known as an ArcGIS Developer account, is an identity associated with an ArcGIS Location Platform subscription.Learn more or ArcGIS Online accountAn 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.Learn more to access both standardA standard endpoint is a URL for an ArcGIS location service hosted in a global cloud infrastructure. This includes the basemap layer service, and most functionality available in the geocoding service and routing service.Learn more and enhanced endpointsAn enhanced endpoint is a URL for an ArcGIS location service hosted in a cloud infrastructure in the United States. They support all service functionality and additional levels of security compliance such as Federal Risk and Authorization Management Program (FedRAMP) and Health Insurance Portability and Accountability Act (HIPAA). Some endpoints also support long transactions.Learn more. Both accounts can be used and there are no restrictions. The only difference between using different accounts is how you are billed:

• ArcGIS Location Platform accounts: Service usage billed in US Dollars per transaction
• ArcGIS Online accounts: Service usage billed in credits per transaction

Authentication

To authenticate requests to standardA standard endpoint is a URL for an ArcGIS location service hosted in a global cloud infrastructure. This includes the basemap layer service, and most functionality available in the geocoding service and routing service.Learn more and enhanced endpointsAn enhanced endpoint is a URL for an ArcGIS location service hosted in a cloud infrastructure in the United States. They support all service functionality and additional levels of security compliance such as Federal Risk and Authorization Management Program (FedRAMP) and Health Insurance Portability and Accountability Act (HIPAA). Some endpoints also support long transactions.Learn more, you need an access tokenAn access token is an authorization string that provides access to secure ArcGIS content, data, and services. Its capabilities are determined by the privileges it supports. It is obtained by implementing API key authentication, User authentication, or App authentication.Learn more. You can use an API key or OAuth 2.0. When using an API key, the key must be scoped to access the appropriate location service.