A task to compute areas that can be serviced (reached) from a given location. More...
| Header | #include <Service |
| Since | Esri |
| Inherits | Esri |
This class was introduced in Esri::ArcGISRuntime 100.1.
Public Functions
| Service | |
| Service | |
| Service | |
| Service | |
| virtual | ~ |
| Esri | create |
| Esri | service |
| Esri | solve |
| Esri | transportation |
Reimplemented Public Functions
| virtual QString | api |
| virtual void | cancel |
| virtual Esri | credential() const override |
| virtual void | load() override |
| virtual Esri | load |
| virtual Esri | load |
| virtual Esri | request |
| virtual void | retry |
| virtual void | set |
| virtual void | set |
| virtual QUrl | url() const override |
Signals
| void | create |
| void | done |
| void | load |
| void | solve |
Detailed Description
A ServiceAreaTask calculates areas that can be serviced (reached) from a given location. A network service area is a region that encompasses all street locations that can be accessed within a given distance or travel time from one or more facilities. For instance, the 10-minute service area for a facility includes all the street locations that can be reached within 10 minutes from that facility.
The service area task works in an online connected scenario by using a transportation network that is published to ArcGIS Server as an online Network Analyst service area service. Esri also provides ready-to-use services, such as the Directions and Routing Services, which require authentication with an ArcGIS organizational account. In connected scenarios, provide a URL to the REST endpoint of the service, along with any necessary credentials.
See also Loadable and Service Area REST API documentation.
Member Function Documentation
ServiceAreaTask::ServiceAreaTask (Esri::ArcGISRuntime::TransportationNetworkDataset *transportationNetworkDataset , QObject *parent = nullptr)
Constructor that takes a transportationNetworkDataset with an optional parent.
This function was introduced in Esri::ArcGISRuntime 100.2.
ServiceAreaTask::ServiceAreaTask (const QUrl &url, QObject *parent = nullptr)
Constructor that takes a url to an NA service endpoint with an optional parent.
ServiceAreaTask::ServiceAreaTask (const QUrl &url, Esri::ArcGISRuntime::Credential *credential, QObject *parent = nullptr)
Constructor that takes a url to a secured NA service endpoint and a credential, with an optional parent.
ServiceAreaTask::ServiceAreaTask (const QString &databasePath , const QString &networkName , QObject *parent = nullptr)
Constructor that takes a databasePath and networkName, with an optional parent.
This function was introduced in Esri::ArcGISRuntime 100.2.
[signal] void ServiceAreaTask::createDefaultParametersCompleted (QUuid taskId , Esri::ArcGISRuntime::ServiceAreaParameters defaultParameters )
Signal emitted after the createDefaultParameters asynchronous method completes.
- taskId - The task ID of the asynchronous task.
- defaultParameters - The generated default ServiceAreaParameters.
[signal] void ServiceAreaTask::doneLoading (Esri::ArcGISRuntime::Error loadError )
Signal emitted when this object is done loading.
- loadError - Details about any error that may have occurred.
Note: If there is a load error it will also be emitted on the errorOccurred signal.
[signal] void ServiceAreaTask::loadStatusChanged (Esri::ArcGISRuntime::LoadStatus loadStatus )
Signal emitted when the load status changes for this object.
- loadStatus - The LoadStatus.
See also Loadable.
[signal] void ServiceAreaTask::solveServiceAreaCompleted (QUuid taskId , Esri::ArcGISRuntime::ServiceAreaResult serviceAreaResult )
Signal emitted after the solveServiceArea asynchronous method completes.
- taskId - The task ID of the asynchronous task.
- serviceAreaResult - The generated ServiceAreaResult.
[override virtual] ServiceAreaTask::~ServiceAreaTask ()
Destructor.
[override virtual] QString ServiceAreaTask::apiKey () const
Reimplements: ApiKeyResource::apiKey() const.
Returns the API key. See ApiKeyResource.
This function was introduced in Esri::ArcGISRuntime 100.10.
See also setApiKey().
[override virtual] void ServiceAreaTask::cancelLoad ()
Reimplements: Loadable::cancelLoad().
See Loadable.
Esri::ArcGISRuntime::TaskWatcher ServiceAreaTask::createDefaultParameters ()
Creates default service area parameters from the service.
The createDefaultParametersCompleted signal emits when the operation is complete, giving access to the resulting ServiceAreaParameters.
[override virtual] Esri::ArcGISRuntime::Credential *ServiceAreaTask::credential() const
Reimplements: RemoteResource::credential() const.
Returns the security credential used to access the service area service.
Only applicable if using an online service that is secured.
[override virtual] void ServiceAreaTask::load()
Reimplements: Loadable::load().
See Loadable.
[override virtual] Esri::ArcGISRuntime::Error ServiceAreaTask::loadError () const
Reimplements: Loadable::loadError() const.
See Loadable.
[override virtual] Esri::ArcGISRuntime::LoadStatus ServiceAreaTask::loadStatus () const
Reimplements: Loadable::loadStatus() const.
See Loadable.
[override virtual] Esri::ArcGISRuntime::RequestConfiguration ServiceAreaTask::requestConfiguration () const
Reimplements: RemoteResource::requestConfiguration() const.
Returns the RequestConfiguration in use by this task.
See also setRequestConfiguration().
[override virtual] void ServiceAreaTask::retryLoad ()
Reimplements: Loadable::retryLoad().
See Loadable.
Esri::ArcGISRuntime::ServiceAreaTaskInfo ServiceAreaTask::serviceAreaTaskInfo () const
Returns the ServiceAreaTaskInfo for this ServiceAreaTask.
Wait until this ServiceAreaTask is finished loading before attempting to obtain the ServiceAreaTaskInfo.
[override virtual] void ServiceAreaTask::setApiKey (const QString &apiKey )
Reimplements: ApiKeyResource::setApiKey(const QString &apiKey).
Sets the API key to apiKey. See ApiKeyResource.
This function was introduced in Esri::ArcGISRuntime 100.10.
See also apiKey().
[override virtual] void ServiceAreaTask::setRequestConfiguration (const Esri::ArcGISRuntime::RequestConfiguration &requestConfiguration )
Reimplements: RemoteResource::setRequestConfiguration(const Esri::ArcGISRuntime::RequestConfiguration &requestConfiguration).
Sets the configuration parameters used for network requests sent by this task to requestConfiguration.
See also requestConfiguration().
Esri::ArcGISRuntime::TaskWatcher ServiceAreaTask::solveServiceArea (const Esri::ArcGISRuntime::ServiceAreaParameters &serviceAreaParameters )
Solves a service area with the given serviceAreaParameters.
The ServiceAreaTask::solveServiceAreaCompleted signal emits when the operation is complete, giving access to the ServiceAreaResult.
Esri::ArcGISRuntime::TransportationNetworkDataset *ServiceAreaTask::transportationNetworkDataset () const
Returns the TransportationNetworkDataset used to construct this ServiceAreaTask.
This function was introduced in Esri::ArcGISRuntime 100.2.
[override virtual] QUrl ServiceAreaTask::url() const
Reimplements: RemoteResource::url() const.
Returns the URL to the online service.
Only applicable to online service area.