esriVectorTilesDownloadOption

Describes how Esri vector tiled basemap layers will be downloaded. 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 com.arcgismaps.mapping.layers.vectortiles.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 the Vector Tile Style documentation. When you take vector tiled layer offline, these fonts are downloaded as part of the com.arcgismaps.mapping.layers.vectortiles.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 com.arcgismaps.tasks.exportvectortiles.EsriVectorTilesDownloadOption.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 com.arcgismaps.mapping.layers.vectortiles.VectorTileCache but ensures that the offline layer will display the same as the original online data.

If you choose com.arcgismaps.tasks.exportvectortiles.EsriVectorTilesDownloadOption.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 com.arcgismaps.mapping.layers.vectortiles.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 com.arcgismaps.tasks.exportvectortiles.EsriVectorTilesDownloadOption.UseOriginalService.