Vector Tile Layers

This describes how to register VectorTile Layers with the GeoPlatform using the GeoPlatform Object Editor application.

Requirements

A GeoPlatform account and a working web-accessible VectorTile layer based upon MapBox Vector Tile Specifications. For example, these tiles must be web-accessible through a URL based upon the following pattern:

    //subdomain.domain.tld/path/{z}/{x}/{y}.pbf

Recommended

It is recommended that you provide a JSON document defining styles for the layer according to MapBox Style Specifications, either as an uploadable file or as a web-accessible resource.

It should be noted that not all style specification support is provided by GeoPlatform. For example, styles that rely upon fill patterns are not supported and will default to the fallback styling for the appropriate geometry type.

Steps
  1. Log into your GeoPlatform account in Object Editor
  2. Navigate to the editor for a new Layer
  3. Give the Layer a title
  4. Add the MapBox Vector Tile type to the Layer under Resource Types
    1. Note: When this is added, a Layer no longer needs a Service to be associated in order to be saved or rendered on a Map
  5. Give the Layer a layer name (Layer Info tab)
  6. Optionally, associate a style with the Layer
    1. Under Related Resources, add a new resource
    2. Give the resource a title, such as “default style”
    3. Either specify the URL to the style JSON (if hosted externally) or upload a MapBox Style Spec JSON file that defines styles for the features hosted by the Layer
  7. Provide additional information as desired
  8. Generate a URI for the layer on the Details tab
  9. Save the Layer

Esri Vector Tile Layers

Esri REST Tile Services which host vector tiles can be registered with the GeoPlatform using Object Editor. When these services are harvested for layers, a single vector tile layer asset will be automatically created and configured (including its style, see below for details).

A suitable Esri REST Tile Service hosting vector tiles will expose its API via a URL in the following pattern:

    //tiles.arcgis.com/tiles/…/arcgis/rest/services/…/VectorTileServer

The pattern is similar to normal raster tile services except the URL contains “VectorTileServer” instead of “TileServer”.

If you are creating a vector tile layer hosted from an Esri REST Tile Service, follow these steps instead of the ones presented above:

Steps
  1. Navigate to the editor for a new Service
  2. Specify the Service’s Access URL
  3. Select “Esri REST Tile Service” from the Service Type list
  4. Click Get Service Info
  5. Provide additional information as desired
  6. Save the Service
  7. Exit the Service’s edit page by clicking Cancel
  8. Click Update Service Layers in the Service’s viewing page
Style

If the Esri REST Tile Server provides a link to the style description in the service JSON (“defaultStyles”), the style will be automatically registered with the imported service’s layer and used when rendering the vector tile layer.

Importing Layers via Map Viewer / Other

Because of the nature of how vector tile layers must be configured, it is not recommended that you import or create the layer using any other application at this time.

Updated on October 2, 2019
Have Other Questions?
Please check out our FAQ page in case your question has already been addressed. If you still need help or want to report an issue, please send us an email at servicedesk@geoplatform.gov.
For questions about the federal government not related to GeoPlatform, visit USA.gov or call 1-800-FED-INFO (1-800-333-4636), 8am - 8pm ET Monday through Friday.