Hide Table of Contents
esri
esri/arcgis
esri/dijit
esri/dijit/analysis
esri/dijit/geoenrichment
esri/dijit/geoenrichment/ReportPlayer
esri/geometry
esri/layers
esri/renderers
esri/symbols
esri/tasks
esri/tasks/datareviewer
esri/tasks/geoenrichment
esri/tasks/locationproviders
Class: ServiceAreaTask
[ AMD Module Require | Legacy Module Require ]
require(["esri/tasks/ServiceAreaTask"], function(ServiceAreaTask) { /* code goes here */ });
Description
(Added at v2.0)
Helps you find service areas around any location on a network. A network service area is a region that encompasses all accessible streets that is, streets that are within a specified impedance. For instance, the 5-minute service area for a point includes all the streets that can be reached within five minutes from that point.
Note: ServiceAreaTask, and other service area related classes, requires ArcGIS Server 10.0 or above and a service area layer. A service area layer is a layer of type esriNAServerServiceAreaLayer.
See also
Service area analysis ArcGIS Desktop help topic.
Samples
Search for samples that use this class.Constructors
| Name | Summary |
|---|---|
| new ServiceAreaTask(url) | Creates a new ServiceAreaTask object. |
Methods
| Name | Return type | Summary |
|---|---|---|
| getServiceDescription() | Object | Returns an object describing a Service Area service endpoint (URL of the endpoint is specified in the constructor). |
| solve(params, callback?, errback?) | Deferred | Solve the service area. |
Events
[ On Style Events | Connect Style Event ]
All On Style event listeners receive a single event object. Additionally, the event object also contains a 'target' property whose value is the object which fired the event.
Events
| Name | Event Object | Summary |
|---|---|---|
| solve-complete | {
result: < | Fires when ServiceAreaTask has completed. |
Constructor Details
Creates a new ServiceAreaTask object.
Parameters:
< |
Required | URL to the ArcGIS Server REST resource that represents a network analysis service. Use the Service Directory to obtain the URL. |
Sample:
require([
"esri/tasks/ServiceAreaTask", ...
], function(ServiceAreaTask, ... ) {
var serviceAreaTask = new ServiceAreaTask("http://sampleserver6.arcgisonline.com/arcgis/rest/services/NetworkAnalysis/SanDiego/NAServer/ServiceArea");
...
});
Method Details
Returns an object describing a Service Area service endpoint (URL of the endpoint is specified in the constructor). The description contains information about the default solver settings, underlying network dataset, available cost and restriction attributes, supported travel modes, etc. If the targeted Network Analyst Server is federated with a Portal or ArcGIS Online, the returned
supportedTravelModes array will include user-specific travel modes. If the Network Analyst Server works in a standalone configuration, the supportedTravelModes will come from the original Closest Facility service description. A few properties returned in this object include:
(Added at v3.14)attributeParameterValues, impedance, restrictUTurns, restrictions, supportedTravelModes, travelDirection, and useHierarchy.Return type:
ObjectSolve the service area.
Return type:
DeferredParameters:
< |
Required | The ServiceAreaParameters object. |
< |
Optional | The function to call when the method has completed. The arguments in the function are the same as the onSolveComplete event. |
< |
Optional | An error object is returned if an error occurs on the Server during task execution. |
Sample:
serviceAreaTask.solve(params,function(serviceAreaSolveResult){
var result = serviceAreaSolveResult;
//do something with the results here
});
Event Details
[ On Style Events | Connect Style Event ]
Fires when ServiceAreaTask has completed. Should be used in favor of onSolveComplete. (Added at v3.5)
Event Object Properties:
< |
The results from the ServiceAreaTask solve operation. |