---
title: /solveServiceArea
uid: serviceArea-service-direct
description: "Find directions using the global route service available with ArcGIS Location Services."
context:
requestType: "direct"
---
import Token from "../../../shared/routing/snippets/request-parameters/_Token.mdx"
import SAServiceDesc from "../../../shared/routing/snippets/_serviceArea-service.mdx"
import Facilities from "../../../shared/routing/snippets/request-parameters/_SA-facilities.mdx"
import SplitPolygonsAtBreaks from "../../../shared/routing/snippets/request-parameters/_SA-splitPolygonsAtBreaks.mdx"
import OverlapPolygons from "../../../shared/routing/snippets/request-parameters/_SA-overlapPolygons.mdx"
import MergeSimilar from "../../../shared/routing/snippets/request-parameters/_SA-mergeSimilarPolygonRanges.mdx"
import TrimOuterPolygons from "../../../shared/routing/snippets/request-parameters/_SA-trimOuterPolygons.mdx"
import TrimPolygonDist from "../../../shared/routing/snippets/request-parameters/_SA-trimPolygonDistance.mdx"
import TrimPolygonDistUnits from "../../../shared/routing/snippets/request-parameters/_SA-trimPolygonDistanceUnits.mdx"
import OutputLines from "../../../shared/routing/snippets/request-parameters/_SA-outputLines.mdx"
import SplitLines from "../../../shared/routing/snippets/request-parameters/_SA-splitLinesAtBreaks.mdx"
import OverlapLines from "../../../shared/routing/snippets/request-parameters/_SA-overlapLines.mdx"
import ReturnFacilities from "../../../shared/routing/snippets/request-parameters/_SA-returnFacilities.mdx"
import Impedance from "../../../shared/routing/snippets/request-parameters/_Impedance-JDR-OnE.mdx"
import DefaultBreaks from "../../../shared/routing/snippets/request-parameters/_SA-DefaultBreaks.mdx"
import TravelDirection from "../../../shared/routing/snippets/request-parameters/_SA-TravelDirection.mdx"
import AttributeParameterValues from "../../../shared/routing/snippets/request-parameters/_AttributeParameterValues-JDR-OnE.mdx"
import TravelModes from "../../../shared/routing/snippets/request-parameters/_TravelMode.mdx"
import AnalysisRegion from "../../../shared/routing/snippets/request-parameters/_AnalysisRegion-JR-OnE.mdx"
import Context from "../../../shared/routing/snippets/request-parameters/_Context.mdx"
import LineBarriers from "../../../shared/routing/snippets/request-parameters/_LineBarriers.mdx"
import LocateSettings from "../../../shared/routing/snippets/request-parameters/_LocateSettings.mdx"
import PointBarriers from "../../../shared/routing/snippets/request-parameters/_PointBarriers.mdx"
import PolygonBarriers from "../../../shared/routing/snippets/request-parameters/_PolygonBarriers.mdx"
import UTurnAtJunctions from "../../../shared/routing/snippets/request-parameters/_UTurnAtJunctions.mdx"
import UseHierarchy from "../../../shared/routing/snippets/request-parameters/_SA-UseHierarchy.mdx"
import Restrictions from "../../../shared/routing/snippets/request-parameters/_Restrictions-JDR-OnE.mdx"
import Overrides from "../../../shared/routing/snippets/request-parameters/_Overrides-JDR-OnE.mdx"
import IgnoreInvalidLocations from "../../../shared/routing/snippets/request-parameters/_IgnoreInvalidLocations-JDR-OnE.mdx"
import TimeOfDay from "../../../shared/routing/snippets/request-parameters/_Direct-timeOfDay.mdx"
import TimeOfDayUTC from "../../../shared/routing/snippets/request-parameters/_Direct-timeOfDayIsUTC.mdx"
import LineBarrier from "../../../shared/routing/snippets/request-parameters/_LineBarriers.mdx"
import PolygonBarrier from "../../../shared/routing/snippets/request-parameters/_PolygonBarriers.mdx"
import PointBarrier from "../../../shared/routing/snippets/request-parameters/_PointBarriers.mdx"
import AccumulateAttrNames from "../../../shared/routing/snippets/request-parameters/_AccumulateAttributeNames-DR-OnE.mdx"
import DirectionsOutputType from "../../../shared/routing/snippets/request-parameters/_DirectionsOutputType.mdx"
import ImpedanceAttrName from "../../../shared/routing/snippets/request-parameters/_Impedance-JDR-OnE.mdx"
import ReturnBarriers from "../../../shared/routing/snippets/request-parameters/_returnBarriers.mdx"
import ReturnPolygonBarriers from "../../../shared/routing/snippets/request-parameters/_returnPolygonBarriers.mdx"
import ReturnPolylineBarriers from "../../../shared/routing/snippets/request-parameters/_returnPolylineBarriers.mdx"
import ReturnTraversedEdges from "../../../shared/routing/snippets/request-parameters/_returnTraversedEdges.mdx"
import ReturnTraversedJunctions from "../../../shared/routing/snippets/request-parameters/_returnTraversedJunctions.mdx"
import ReturnTraversedTurns from "../../../shared/routing/snippets/request-parameters/_returnTraversedTurns.mdx"
import ReturnZ from "../../../shared/routing/snippets/request-parameters/_returnZ.mdx"
import OutputGeometryPrecision from "../../../shared/routing/snippets/request-parameters/_RouteLineSimplificationTolerance-JR-OnE.mdx"
import OutputGeometryPrecisionUnits from "../../../shared/routing/snippets/request-parameters/_OutputGeometryPrecisionUnits.mdx"
import GeometryPrecision from "../../../shared/routing/snippets/request-parameters/_GeometryPrecision.mdx"
import GeometryPrecisionM from "../../../shared/routing/snippets/request-parameters/_GeometryPrecisionM.mdx"
import GeometryPrecisionZ from "../../../shared/routing/snippets/request-parameters/_GeometryPrecisionZ.mdx"
import PreserveObjectID from "../../../shared/routing/snippets/request-parameters/_PreserveObjectID.mdx"
import ReturnEmptyResults from "../../../shared/routing/snippets/request-parameters/_ReturnEmptyResults.mdx"
import LocateSetting from "../../../shared/routing/snippets/request-parameters/_LocateSettings.mdx"
import Contxt from "../../../shared/routing/snippets/request-parameters/_Context.mdx"
import RestrictUTurns from "../../../shared/routing/snippets/request-parameters/_UTurnAtJunctions.mdx"
import PolygonDetail from "../../../shared/routing/snippets/request-parameters/_SA-PolygonDetail.mdx"
import ConfigureLimits from "../../../shared/routing/snippets/request-parameters/_configureLimits.mdx"
import SAOutputFacility from "../../../shared/routing/snippets/output-parameters/_SA-outputFacilities.mdx"
import SaPolygons from "../../../shared/routing/snippets/output-parameters/_SA-saPolygons.mdx"
import SaPolylines from "../../../shared/routing/snippets/output-parameters/_SA-saPolylines.mdx"
import OutputBarriers from "../../../shared/routing/snippets/output-parameters/_barriers.mdx"
import OutputPolylineBarriers from "../../../shared/routing/snippets/output-parameters/_polylineBarriers.mdx"
import OutputPolygonBarriers from "../../../shared/routing/snippets/output-parameters/_polygonBarriers.mdx"
import SAUsageLimits from "../../../shared/routing/snippets/request-parameters/_SA-UsageLimits.mdx"
import SharedContent from "../../../shared/content/_required-params.mdx"
import ParamMetadata from "../../../shared/components/param-metatdata"
Publish using publish routing services
Publish using ArcGIS Pro
If you publish routing services using [configure routing services](https://enterprise.arcgis.com/en/portal/latest/administer/windows/configure-routing-services.htm) dialog box from ArcGIS Enterprise portal website, or publish using [publish routing services](https://enterprise.arcgis.com/en/server/latest/develop/windows/publishing-routing-services.htm) command line utility, use the following endpoint to access the /solveServiceArea direct request. The `{{folderName}}` represents the folder in which the services are being published.
{`GET https://{{machineName}}/{{serverWebAdaptorName}}/rest/services/{{folderName}}/NetworkAnalysis/NAServer/ServiceArea/solveServiceArea`}
{`POST https://{{machineName}}/{{serverWebAdaptorName}}/rest/services/{{folderName}}/NetworkAnalysis/NAServer/ServiceArea/solveServiceArea`}
If you publish routing services using [ArcGIS Pro](https://pro.arcgis.com/en/pro-app/latest/help/analysis/networks/publish-standard-routing-services.htm), use the following endpoint to access the /solveServiceArea direct request. The `{{serviceName}}` represents the name of the routing services published from ArcGIS Pro. The `{{layerName}}` is the service area layer's name in the map used to publish the routing service.
{`GET https://{{machineName}}/{{serverWebAdaptorName}}/rest/services/{{serviceName}}/NAServer/{{layerName}}/solveServiceArea`}
{`POST https://{{machineName}}/{{serverWebAdaptorName}}/rest/services/{{serviceName}}/NAServer/{{layerName}}/solveServiceArea`}
## Parameters
[f](#f)
string
The request response format, either `json` or `pjson`
[token](#token)
string
An access token with the [required privileges](#token).
[facilities](#facilities)
locations | feature | layer
Input locations around which service areas are generated.
[travelMode](#travelmode)
object
The mode of transportation for the analysis provided as a JSON object.
[defaultBreaks](#defaultbreaks)
string
`Minutes`
The size and number of service areas to generate for each facility.
[travelDirection](#traveldirection)
string
`esriNATravelDirectionToFacility`
Search for the closest facility as measured from the incident to the facility or from the facility to the incident.
[timeOfDay](#timeofday)
string
The time and date to depart from or arrive at facilities.
[timeOfDayIsUTC](#timeofdayisutc)
boolean
`false`
The time zone or zones of the `timeOfDay` parameter.
[outputPolygons](#outputpolygons)
string
`esriNAOutputPolygonSimplified`
The level of detail for the output service area polygons.
[splitPolygonsAtBreaks](#splitpolygonsatbreaks)
boolean
`true`
Specify whether multiple service areas around a facility are created as disks or rings.
[overlapPolygons](#overlappolygons)
boolean
`true`
Service areas from different facilities can overlap each other.
[mergeSimilarPolygonRanges](#mergesimilarpolygonranges)
boolean
`false`
Service areas from different facilities that have the same break value will be joined together or split at break values.
[trimOuterPolygons](#trimouterpolygons)
boolean
`true`
Service areas are trimmed.
[trimPolygonDistance](#trimpolygondistance)
integer
`100`
The distance within which the service area polygon will extend.
[trimPolygonDistanceUnits](#trimpolygondistanceunits)
string
`esriMeters`
Units of the value specified in the `trimPolygonDistance` parameter.
[restrictUTurns](#restrictuturns)
string
`esriNFSBAllowBacktrack`
Restricts or allows a route to make U-turns at junctions.
[useHierarchy](#usehierarchy)
boolean
`true`
Hierarchy used when generating service areas.
[impedanceAttributeName](#impedanceattributename)
string
`TravelTime`
The type of impedance, such as `Minutes` or `Miles`.
[accumulateAttributeNames](#accumulateattributenames)
string
`Miles,Kilometers`
Accumulates values other than the value set in the `impedanceAttributeName` parameter.
[restrictionAttributeNames](#restrictionattributenames)
string
The restrictions that should be honored.
[attributeParameterValues](#attributeparametervalues)
[object]
Additional values required by an attribute or restriction.
[barriers](#barriers)
locations | feature | layer
One or more points that act as temporary restrictions, additional time, or distance.
[polylineBarriers](#polylinebarriers)
feature | layer
One ore more lines that prohibit travel anywhere the lines intersect the streets.
[polygonBarriers](#polygonbarriers)
feature | layer
Polygons that either prohibit travel or proportionately scale the time or distance required to travel on the streets.
[splitLinesAtBreaks](#splitlinesatbreaks)
boolean
`true`
Service area lines split at break values.
[outputLines](#outputlines)
string
`esriNAOutputLineNone`
Create service area lines.
[overlapLines](#overlaplines)
boolean
`true`
Service area lines from different facilities overlap each other.
[returnFacilities](#returnfacilities)
boolean
`false`
Returns facilities.
[returnBarriers](#returnbarriers)
boolean
`false`
Returns barriers.
[returnPolylineBarriers](#returnpolylinebarriers)
boolean
`false`
Returns polyline barriers.
[returnPolygonBarriers](#returnpolygonbarriers)
boolean
`false`
Returns polygon barriers.
[returnZ](#returnz)
string
Include the z-values for the returned geometries if supported by the underlying network.
[ignoreInvalidLocations](#ignoreinvalidlocations)
boolean
`true`
Ignores invalid input locations.
[context](#context)
string
Additional settings that affect task operation
[outputGeometryPrecision](#outputgeometryprecision)
number
`10`
Simplifies route geometry.
[outputGeometryPrecisionUnits](#outputgeometryprecisionunits)
string
`esriMeters`
The units for the value in the `outputGeometryPrecision` parameter.
[geometryPrecision](#geometryprecision)
string
The number of decimal places in the response geometries. Applies to x and y values only.
[geometryPrecisionM](#geometryprecisionm)
string
The number of decimal places in the response geometries. Applies to m-values only.
[geometryPrecisionZ](#geometryprecisionz)
string
The number of decimal places in the response geometries. Applies to z-values only.
[overrides](#overrides)
string
For internal use only.
[preserveObjectID](#preserveobjectid)
boolean
`false`
Preserves the object IDs from input locations when the input locations are returned as output.
[returnEmptyResults](#returnemptyresults)
boolean
`false`
Returns empty results instead of the error property when a request fails.
[locateSettings](#locatesettings)
object
Determines how input data are located.
[includeSourceInformationOnLines](#includesourceinformationonlines)
boolean
`true`
Include network source fields on the output `saPolylines`.
[excludeSourcesFromPolygons](#excludesourcesfrompolygons)
object
Array of network dataset edge sources to exclude when generating polygons.
All the default parameter values mentioned above are assuming that the routing service is published with default settings. If you publish routing services using [ArcGIS Pro](https://pro.arcgis.com/en/pro-app/latest/help/analysis/networks/publish-standard-routing-services.htm#ESRI_SECTION1_61BF401948C74301AF09F7D5D0E6FA35), you can change the default on the network analysis layer before publishing the service. If you publish routing services using [configure routing services](https://enterprise.arcgis.com/en/portal/latest/administer/windows/configure-routing-services.htm) dialog box from ArcGIS Enterprise portal website, or publish using [publish routing services](https://enterprise.arcgis.com/en/server/latest/develop/windows/publishing-routing-services.htm) command line utility, the default values can be changed through the publish routing services [configuration file](https://enterprise.arcgis.com/en/portal/latest/administer/windows/configure-routing-service-config-file.htm), and you can apply the configuration file while publishing the routing services.
## Required parameters
### f
### token
### facilities
## Optional parameters
### travelMode
### defaultBreaks
### travelDirection
### timeOfDay
### timeOfDayIsUTC
### outputPolygons
### splitPolygonsAtBreaks
### overlapPolygons
### mergeSimilarPolygonRanges
### trimOuterPolygons
### trimPolygonDistance
### trimPolygonDistanceUnits
### useHierarchy
### restrictUTurns
### impedanceAttributeName
### accumulateAttributeNames
### restrictionAttributeNames
### attributeParameterValues
### barriers
### polylineBarriers
### polygonBarriers
### outputLines
### splitLinesAtBreaks
### overlapLines
### returnFacilities
### returnBarriers
### returnPolylineBarriers
### returnPolygonBarriers
### returnZ
### ignoreInvalidLocations
### outSR
### outputGeometryPrecision
### outputGeometryPrecisionUnits
### geometryPrecision
### geometryPrecisionM
### geometryPrecisionZ
### overrides
### preserveObjectID
### returnEmptyResults
### locateSettings
### includeSourceInformationOnLines
Specify whether the network source fields on the output `saPolylines` will be included.
- `true`—The `saPolylines` property in the JSON response will include network source fields.
- `false`—The `saPolylines` property in the JSON response will not include network source fields.
Setting this parameter has no effect if [`outputLines`](#outputlines) is set to `esriNAOutputLineNone`. You can set this to `false` if you don't need network source fields on [`saPolylines`](#sapolygons) and this will reduce the response size.
### excludeSourcesFromPolygons
Specify the array of network dataset edge sources to exclude when generating polygons. The property is set as an array of strings where each value is the name of the network edge source.
[Learn more about excluding edge sources from service area polygon generation](https://pro.arcgis.com/en/pro-app/latest/help/analysis/networks/service-area-analysis-layer.htm#ESRI_SECTION1_D36A18B15D704F0DBA9B4C766A4A2719)
## Response objects
The JSON response from the service area request is based on the following syntax. The actual properties returned in the response depend on the request parameters. For example, the `facilities` property is returned only if the `returnFacilities` parameter is set to `true` . If a request fails, the JSON response only contains the error property.
For a list of error codes and details, go to [Direct request error codes](/naserver-error-codes)
The examples in the subsequent section illustrate the response returned with specific request parameters.
On successful completion, the request returns the service areas around the facilities. This data type supports the fields described below. In addition to these fields, the data type also includes all the fields from the input feature class used as facilities for the analysis when generating overlapping or non-overlapping polygons.
### saPolygons
### saPolylines
### facilities
### barriers
### polylineBarriers
### polygonBarriers
## Examples
To build client application [see API reference examples](DEVSITE/documentation/mapping-and-location-services/routing-and-directions/service-areas/#direct-find-walk-distance-areas)
Below is an example of the request showing how to calculate drive-time polygons around a store.
If you copy and paste the request URL from the examples into a web browser, you need to replace `` with a valid token. See [Security and authentication](DEVSITE/documentation/security-and-authentication/) to learn more.
### Calculate 5-, 10-, and 15-minute drive-time polygons around store locations
This example shows how to calculate the 5-, 10-, and 15-minute drive-time polygons around a store. The store location is specified as the `facilities` parameter using the longitude and latitude values. The drive-time polygons must be drawn on an ArcGIS Online basemap that uses the Web Mercator spatial reference. Therefore, the `outSR` parameter is specified with a value of `102100` to return polygon geometries in the appropriate spatial reference. The default values for all the other parameters are appropriate for this request and are not specified.
Request
Response
## Service limits