Property EsriVectorTilesDownloadOption

EsriVectorTilesDownloadOption

Gets or sets a value that describes how Esri vector tiled basemap layers will be downloaded.

Declaration

public EsriVectorTilesDownloadOption EsriVectorTilesDownloadOption { get; set; }

Property Value

Type	Description
EsriVectorTilesDownloadOption	A value that describes how Esri vector tiled basemap layers will be downloaded.

Remarks

This property lets you choose how to download Esri vector tiled basemap layers. This property only applies when taking an Esri vector tile basemap service offline.

When taking an Esri vector tiled basemap service offline (e.g. to create a VectorTileCache on your device), you can choose from different versions of the service depending on your use case.

Primary considerations are the download speed and the size of the resulting .vtpk file. Among other things, file size is influenced by the number of fonts downloaded from the service. Esri vector tiled basemap layers use fonts as part of their style resources - see vector-tile-style documentation. When you take a vector tiled layer offline, these fonts are downloaded as part of the VectorTileCache.

Esri services also offer an alternative version with a reduced font package size. This omits the large Arial Unicode font, which greatly reduces the download size. You can view the set of reduced font vector tile services here.

If you choose UseOriginalService, the full set of resources used by the original online service, including all fonts, will be downloaded. This increases the download size of the VectorTileCache but ensures that the offline layer will display the same as the original online data.

If you choose UseReducedFontsService, the smaller set of fonts used by the alternative, for export, version of the service will be downloaded. This reduces the download size of the VectorTileCache but is not suitable for all locales or when your offline vector tiled layer includes certain language characters. For example, this option will not display Chinese, Japanese, Thai, Korean or Georgian characters. If an alternative, for export version of the service cannot be found, the original service will be used.

The default value is UseOriginalService.

Applies to

Platforms and versions

Target	Versions
.NET Standard 2.0	100.10 - 200.5
.NET	100.13 - 200.5
.NET Windows	100.13 - 200.5
.NET Android	200.0 - 200.5
.NET iOS	200.0 - 200.5
.NET Framework	100.10 - 200.5
Xamarin.Android	100.10 - 100.15
Xamarin.iOS	100.10 - 100.15
UWP	100.10 - 200.5