Class ArcGISVectorTiledLayer

java.lang.Object
com.esri.arcgisruntime.layers.Layer
com.esri.arcgisruntime.layers.ArcGISVectorTiledLayer
All Implemented Interfaces:
ApiKeyResource, RemoteResource, LayerContent, Loadable

public final class ArcGISVectorTiledLayer extends Layer implements RemoteResource, ApiKeyResource
A layer that can visualize data from an ArcGIS vector tile source or a local VectorTileCache.

An ArcGIS Vector Tiled Layer is loaded from ArcGIS online, ArcGIS Enterprise, ArcGIS Server, or a local vector tiled layer package file. The tile data format is optimized to reduce network bandwidth and reduce CPU load while rendering the tiles. Vector tiled layers are appropriate for basemap, reference and possibly operational layers. They do not contain any feature data, and do not support identify, search, or editing operations.

Vector tiles are an alternative to raster tile basemap layers, such as ArcGISTiledLayer. Instead of pixels (raster), the cartography is delivered using 2D points. The points describe lines, polygons, or the locations of labels and marker symbols. The file format of tiles is binary and conforms to the Mapbox Vector Tile Specification. This specification allows a more continuous visual experience between levels of detail compared to raster tiles. The vector tile file format also requires less space than raster tiles.

You can create a vector tiled layer using either a URI or a PortalItem. The URI can point to a vector tile source, a vector tile style sheet, or a local vector tile package file. The portal item will contain a URI to a vector tile style sheet. The style sheet describes the appearance of the geometry and must be in the Mapbox GL Style format. The style sheet also contains a URI to a vector tile source. The source must be in the Mapbox TileJSON format. The source info includes a URI to a default style sheet.

More than one vector tile style sheet can use the same source. Both the source info and the style sheet are human readable JSON files.

Vector tile packages can also be downloaded from an ArcGIS Online vector tile service. The vector tile package is a single file (.vptk) that contains all of the tile data files, the source information, a style sheet, and the font and symbol marker resources required to display the map.

Vector tile packages are also distributed inside Mobile Map Packages. The MMPK contains JSON that points to the location of the vector tile style sheet or the root of the vector tile package data.

Since:
100.0.0
See Also:
  • Constructor Details

    • ArcGISVectorTiledLayer

      public ArcGISVectorTiledLayer(String dataSourceUri)
      Creates an ArcGIS Vector Tiled Layer from an ArcGIS Vector Tile Service URL, a Vector Tile Style Sheet URI, or a path to a local vector tile package (.vtpk) file.
      Parameters:
      dataSourceUri - arcGIS Vector Tile Service URL, an ArcGIS Vector Tile Style Sheet URI, or a path to a local vector tile package (.vtpk) file.
      Throws:
      IllegalArgumentException - if dataSourceUri is null or empty
      Since:
      100.0.0
    • ArcGISVectorTiledLayer

      public ArcGISVectorTiledLayer(PortalItem portalItem)
      Creates an ArcGIS Vector Tiled Layer from a PortalItem.
      Parameters:
      portalItem - the PortalItem associated with this ArcGISVectorTiledLayer instance
      Throws:
      IllegalArgumentException - if portalItem is null
      Since:
      100.0.0
    • ArcGISVectorTiledLayer

      public ArcGISVectorTiledLayer(VectorTileCache vectorTileCache)
      Creates an ArcGIS Vector Tiled Layer from a vector tile cache.
      Parameters:
      vectorTileCache - the vector tile cache to use
      Throws:
      IllegalArgumentException - if vectorTileCache is null
      Since:
      100.2.0
    • ArcGISVectorTiledLayer

      public ArcGISVectorTiledLayer(VectorTileCache vectorTileCache, ItemResourceCache itemResourceCache)
      Creates an ArcGIS Vector Tiled Layer from a vector tile cache and an item resource cache containing
      Parameters:
      vectorTileCache - the vector tile cache to use
      itemResourceCache - the item resource cache contains a custom style, may be null
      Throws:
      IllegalArgumentException - if vectorTileCache is null.
      Since:
      100.2.0
  • Method Details