Enum Class EsriVectorTilesDownloadOption

java.lang.Object
java.lang.Enum<EsriVectorTilesDownloadOption>
com.esri.arcgisruntime.tasks.vectortilecache.EsriVectorTilesDownloadOption
All Implemented Interfaces:
Serializable, Comparable<EsriVectorTilesDownloadOption>, Constable

public enum EsriVectorTilesDownloadOption extends Enum<EsriVectorTilesDownloadOption>
Enumerates options for downloading an Esri vector tiled basemap service.

When taking an Esri vector tiled basemap service offline (for example 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 amount of fonts downloaded from the service. Esri vector tiled basemap layers make use of fonts as part of their style resources - see the 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 which will reduce the download size of a vtpk by around 80 Mb. You can view a set of vector tile styles which use the reduced font services here. If you are creating a web map that is only intended for taking maps offline and not for online-viewing, these "for export" versions of the services are recommended.

This enumeration describes options for controlling which set of fonts are downloaded. Note that these options only apply to Esri vector tile basemap services.

Since:
100.10.0
  • Enum Constant Details

    • USE_ORIGINAL_SERVICE

      public static final EsriVectorTilesDownloadOption USE_ORIGINAL_SERVICE
      The complete set of vector tile resources for the original service, including the full set of fonts, will be downloaded.

      Downloading all font resources increases the download size of a .vtpk. However, this option ensures that the offline vector tile layer displays the same as the original online service.

      Since:
      100.10.0
    • USE_REDUCED_FONTS_SERVICE

      public static final EsriVectorTilesDownloadOption USE_REDUCED_FONTS_SERVICE
      An alternative service that uses a reduced set of font resources, supporting a limited set of language characters, will be downloaded.

      Downloading the smaller set of font resources reduces the download size of a .vtpk by around 80 Mb. This omits the large Arial Unicode font, that is used to support many characters for the full world basemap. This makes this option unsuitable for some locales or when your offline vector tiled layer includes certain character sets. For example, this option will not display Chinese, Japanese, Thai, Korean or Georgian characters. You should confirm that this option is suitable for your specific use-case.

      You can view a set of vector tile styles which use the reduced font services here. This option is not recommended for Esri basemap services that do not have an equivalent "for export" version.

      Since:
      100.10.0
  • Method Details

    • values

      public static EsriVectorTilesDownloadOption[] values()
      Returns an array containing the constants of this enum class, in the order they are declared.
      Returns:
      an array containing the constants of this enum class, in the order they are declared
    • valueOf

      public static EsriVectorTilesDownloadOption valueOf(String name)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum class has no constant with the specified name
      NullPointerException - if the argument is null