Skip To Content ArcGIS for Developers Sign In Dashboard

ExportTileCacheTask QML Type

A task to export and download tile packages from tiled map services and image services. More...

Import Statement: import Esri.ArcGISRuntime 100.6
Since: Esri.ArcGISRuntime 100.0
Inherits:

Object

Properties

Signals

Methods

Detailed Description

This task can be used to download tiles (as a tile package, .tpk file) from supporting tiled ArcGIS map or image services. To check if the service supports this, check the list of supported operations on the service's REST endpoint for "EstimateExportTilesSize" and "ExportTiles". If these are not present, they need to be enabled from the server side before you can export tiles from the service. The service could be hosted in the cloud on ArcGIS Online or on-premises with ArcGIS Server.

This QML type supports the following default properties. A default property may be declared inside another declared object without being assigned explicitly to a property.

TypeDefault Property
Credentialcredential
RequestConfigurationrequestConfiguration (since Esri.ArcGISRuntime 100.1)

See also Loadable, Cancelable, and RemoteResource.

Property Documentation

createDefaultExportTileCacheParametersStatus : Enums.TaskStatus

Returns the status of the createDefaultExportTileCacheParameters task.

See also Enums.TaskStatus.


[default] credential : Credential

The Credential for authenticating against a secured service.

This is only applicable if using a service that is secured.


defaultExportTileCacheParameters : ExportTileCacheParameters

Returns the parameters created from createDefaultExportTileCacheParameters() (read-only).

Obtain this property after the createDefaultExportTileCacheParametersStatusChanged signal emits, and the createDefaultExportTileCacheParametersStatus is Enums.TaskStatusCompleted.


error : Error

Returns the error object (read-only).

See also Loadable and Error.


estimateTileCacheSizeJobs : list<EstimateTileCacheSizeJob>

The list of EstimateTileCacheSizeJob objects. Each job can be tracked using the EstimateTileCacheSizeJob::JobStatus property.

See also EstimateTileCacheSizeJob.


exportTileCacheJobs : list<ExportTileCacheJob>

The list of ExportTileCacheJob objects. Each job can be tracked using the ExportTileCacheJob::JobStatus property.

See also ExportTileCacheJob.


loadError : Error

Returns the load error (read-only).

Note: load errors are also reported on the error property and emit the errorChanged signal.

See also Loadable.


loadStatus : Enums.LoadStatus

Returns the load status code of this Loadable object (read-only).

See also Enums.LoadStatus and Loadable.


mapServiceInfo : ArcGISMapServiceInfo

The metadata about the tiled ArcGIS Map service that the task is using. This property is populated after the task loads.


[default] requestConfiguration : RequestConfiguration

The configuration parameters used for network requests sent by this task.

This QML property was introduced in Esri.ArcGISRuntime 100.1.


url : url

The URL to a tiled ArcGIS Map service.


Signal Documentation

createDefaultExportTileCacheParametersStatusChanged()

Emitted when the createDefaultExportTileCacheParametersStatus property changes.


credentialChanged()

Emitted when the credential property changes.


estimateTileCacheSizeJobsChanged()

Emitted when the estimateTileCacheSizeJobs property of this ExportTileCacheTask changes.


exportTileCacheJobsChanged()

Emitted when the exportTileCacheJobs property of this ExportTileCacheTask changes.


loadErrorChanged()

Emitted when the loadError property of this ExportTileCacheTask changes.

Note: load errors are also reported on the error property and emit the errorChanged signal.

See also Loadable and Object.


loadStatusChanged()

Emitted when the loadStatus property changes.

See also Loadable.


mapServiceInfoChanged()

Emitted when the mapServiceInfo property of this ExportTileCacheTask changes.


requestConfigurationChanged()

Emitted when the requestConfiguration property changes.

This QML signal was introduced in Esri.ArcGISRuntime 100.1.


urlChanged()

Emitted when the url property of this ExportTileCacheTask changes.


Method Documentation

bool cancelTask(string taskId)

Cancels a ExportTileCacheTask.

  • taskId - The ID of the task to cancel.

See also Cancelable.


ExportTileCacheParameters createDefaultExportTileCacheParameters(Geometry areaOfInterest, double minScale, double maxScale)

A convenience method to get properly initialized parameters for exporting tiles.

It will calculate the levels of detail (LODs) required based on the specified minScale and maxScale and the tiling scheme of the service. The areaOfInterest represents the geographic area for which tiles are needed.

The supported geometry types for the area of interest are Envelope and Polygon. The area of interest must have a spatial reference. Where a Polygon is supplied, tiles will be filtered according to the polygon geometry, which can help reduce the size of the resulting tile package. Note that the filtered set of tiles may vary, depending on the underlying service.


EstimateTileCacheSizeJob estimateTileCacheSize(ExportTileCacheParameters parameters)

Returns a job which can be used to get a size estimate of the tile package contaning tiles specified by the parameters.

An EstimateTileCacheSizeJob, representing the progress on the server, is returned. The result of the job will be of type ExportTileCacheSizeEstimate, which will describe the estimated size and number of tiles.

Note: The job is initially in the Enums.JobStatusNotStarted state. It can be started by calling Job::start(). The job should be deleted after completion.

See also Job.


ExportTileCacheJob exportTileCache(ExportTileCacheParameters parameters, url downloadFileUrl)

Returns a job which can be used to download a tile package from an ArcGIS map or image service.

The extent, image compression, and other characteristics of the output tile package are determined by the supplied parameters. The tile package will be downloaded to the location specified in the downloadFileUrl.

A ExportTileCacheJob, representing the progress on the server, is returned. The result of the job will be of type TileCache, which can be used to create an ArcGISTiledLayer.

Note: The job is initially in the Enums.JobStatusNotStarted state. It can be started by calling Job::start(). The job should be deleted after completion.

See also Job.



Feedback on this topic?