Add Tiled Dataset

Studio allows you to access tiled data from a range of tiled and raster formats, including Vector tiles, Cloud Optimized GeoTIFF, and other common formats.

Note: Your tiled data sources must be available via URL to use them in Studio.

Add a New Tiled Dataset to Studio

Follow the steps below to add a new tiled dataset to Studio:

1. Click the Add Data button, then navigate to the Tilesets tab.

Navigating to the Tilesets tab in the Add Data to Map window.

2. Under Tileset Type, select either Vector Tile or Raster Tile.

Vector Tiles: paste the tiled dataset URL in the Tileset URL field. Studio will automatically fetch the metadata file, then generate a name for the tileset and a preview of the JSON file.

Raster Tiles: paste the tiled dataset metadata URL in the Tileset metadata field. Studio will generate a name for the tileset and a preview of the JSON file.

Note: Raster tile data must reference a Cloud-Optimized GeoTIFF (COG), which requires standardized Spatio-Temporal Asset Catalog (STAC) metadata.

Top: Example Vector Tile input; Bottom: Example Raster Tile input.

3. Click on Add Data button to add the new dataset.

A new tiled layer will be automatically generated and displayed on your map. You may need to zoom in to display the tiles, as your tileset may have a minimum zoom level greater than the default zoom level.

To learn how to configure this layer, visit the Vector and Raster layer reference pages.

Top: A Raster tileset representing Antarctic Ice Sheets;
Bottom: A Vector tileset showing census areas.

Custom COG Requirements

Raster layers can reference user-provided, custom Cloud-Optimized GeoTIFFs (COG) by providing standardized Spatio-Temporal Asset Catalog (STAC) metadata.

STAC metadata requirements

  • The metadata file must be a valid STAC Item, version 1.0.0 or higher. STAC Collections and Catalogs are not currently supported.
  • Raster data referenced in STAC assets should be Cloud-Optimized GeoTIFFs and need to be publicly accessible via HTTPS.
  • STAC item must have Electro-Optical and Raster extensions, and at least one asset must have both eo:bands and raster:bands information. common_name must be provided in eo:bands and data_type must be provided in raster:bands.

Example Raster Tilesets

You can test raster tiles using resources from our public GitHub repository.

Sign In