Skip To Content ArcGIS for Developers Sign In Dashboard

ExportVectorTilesTask QML Type

A task used to export vector tiles and their style resources. More...

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

Object

Properties

Signals

Methods

Detailed Description

Use this in conjunction with a vector tile service or PortalItem to generate and download vector tile packages.

Vector tiles are exported as a vector tile package (.vtpk) file. A portal item may contain custom style resources overriding the vector tile service's default style and this can be checked with hasStyleResources. The custom style is exported separately as a ItemResourceCache. The export vector tiles task can be instantiated with a service URL to the vector tile service or with portal item referencing a vector tile service. The vector tile service must be enabled for export or the task will fail to load.

A vector tile service URL ends with VectorTileServer. Alternatively, if the URL refers to an item in a portal, then create an instance of a PortalItem and use it to instantiate the ExportVectorTilesTask.

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.

See also Loadable, Cancelable, and RemoteResource.

Property Documentation

createDefaultExportVectorTilesParametersStatus : Enums.TaskStatus

Returns the status of the createDefaultExportVectorTilesParameters 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.


defaultExportVectorTilesParameters : ExportVectorTilesParameters

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

Obtain this property after the createDefaultExportVectorTilesParametersStatusChanged signal is emitted, and the createDefaultExportVectorTilesParametersStatus is Enums.TaskStatusCompleted.


error : Error

Returns the error object (read-only).

See also Loadable and Error.


exportVectorTilesJobs : list<ExportVectorTilesJob>

The list of ExportVectorTilesJob objects. Each job can be tracked using the jobStatus property.

See also ExportVectorTilesJob.


hasStyleResources : bool

Returns whether this task's portal item has any associated style resources that override the default style of the vector tile service.

The portal item's style resources override the default style of the vector tile service and can be exported as an ItemResourceCache.


loadError : Error

Returns the load error (read-only).

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.


[default] portalItem : PortalItem

The portal item to export vector tiles from.

An ExportVectorTilesTask object may be instantiated with a url to a service or a PortalItem, but not with both. This property will be null if this ExportVectorTilesTask was instantiated using a URL.

If the portal item is not of type Enums.PortalItemTypeVectorTileService then the task will fail to load.


requestConfiguration : RequestConfiguration

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


sourceInfo : VectorTileSourceInfo

Returns the VectorTileSourceInfo representing the source metadata for a vector tile service.


url : url

The URL to a vector tile service.

An ExportVectorTilesTask object may be instantiated with a URL to a service or a portalItem, but not with both. This property will be null if this ExportVectorTilesTask was instantiated using a PortalItem.

The vector tile service must be enabled for export or the task will fail to load. A vector tile service URL ends with VectorTileServer.


Signal Documentation

createDefaultExportVectorTilesParametersStatusChanged()

Emitted when the createDefaultExportVectorTilesParametersStatus property changes.


credentialChanged()

Emitted when the credential property changes.


exportVectorTilesJobsChanged()

Emitted when the exportVectorTilesJobs property changes.


hasStyleResourcesChanged()

Emitted when the hasStyleResources property changes.


loadErrorChanged()

Emitted when the loadError property of this task changes.

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.


portalItemChanged()

Emitted when the portalItem property changes.


requestConfigurationChanged()

Emitted when the requestConfiguration property changes.


sourceInfoChanged()

Emitted when the sourceInfo property changes.


urlChanged()

Emitted when the url property of this ExportVectorTilesTask changes.


Method Documentation

bool cancelTask(string taskId)

Cancels the task.

  • taskId - The ID of the task to cancel.

See also Cancelable.


ExportVectorTilesParameters createDefaultExportVectorTilesParameters(Geometry areaOfInterest, double maxScale)

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

It will calculate the levels of detail (LODs) required based on the specified maxScale. Set to 0 to include all levels of detail.

The areaOfInterest represents the geographic area for which vector 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.


ExportVectorTilesJob exportStyleResourceCache(url itemResourcePath)

Returns a job which can be used to download only the custom style from a vector tile layer.

The job will return the item resource cache without a vector tile cache. This is useful when a number of different styles are applied to the same underlying vector tile service. This avoids exporting multiple copies of the same tiles.

The style resource will be downloaded to the location specified in the itemResourcePath.

An ExportVectorTilesJob, representing the progress on the server, is returned. The result of the job will be of type ExportVectorTilesResult, which contains an ItemResourceCache that contains the style.

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.


ExportVectorTilesJob exportVectorTiles(ExportVectorTilesParameters parameters, url vectorTileCachePath)

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

The extent and other characteristics of the output tile package are determined by the supplied parameters. The vector tile package will be downloaded to the location specified in the vectorTileCachePath.

An ExportVectorTilesJob, representing the progress on the server, is returned. The result of the job will be of type ExportVectorTilesResult, which contains a VectorTileCache that can be used to create an ArcGISVectorTiledLayer.

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.


ExportVectorTilesJob exportVectorTilesWithStyleResources(ExportVectorTilesParameters parameters, url vectorTileCachePath, url itemResourcePath)

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

The extent and other characteristics of the output vector tile package are determined by the supplied parameters. The vector tile package and style resource will be downloaded to the location specified in the vectorTileCachePath and itemResourcePath, respectively.

An ExportVectorTilesJob, representing the progress on the server, is returned. The result of the job will be of type ExportVectorTilesResult, which contains a VectorTileCache and ItemResourceCache. These can be used to create an ArcGISVectorTiledLayer with a custom style.

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?