SeaSketch Documentation
  • Administrator's Guide
    • Getting Started
    • Basic Settings
    • Activity
    • Users and Groups
    • Overlay Layers
      • Uploading Spatial Data
      • ArcGIS Services
      • Other Service Types
      • Layer Access Control
      • Metadata and Attribution
      • Cartographic Styling
      • Interactivity and Popups
      • Organizing Overlays
      • Layer Z-Ordering
      • Publishing Changes
    • Basemaps (Maps)
    • Sketch Classes
    • Forums
    • Surveys
    • Offline Support
    • Language Support
  • User's Guide
    • Getting Started
    • The Map Viewer
    • Overlay Layers
    • Sketching Tools
      • Reports
    • Discussion Forums
  • Other Information
    • FAQs
    • Is SeaSketch Free?
Powered by GitBook
On this page
  • Uploading a layer
  • Supported data types
  • Managing new versions of a dataset
  • Enabling data download
  • Managing the data hosting quota
  1. Administrator's Guide
  2. Overlay Layers

Uploading Spatial Data

PreviousOverlay LayersNextArcGIS Services

Last updated 5 months ago

SeaSketch supports uploading data in both vector and raster formats. From these files it creates high-performance vector or raster tiles which are served to end-users via a content delivery network (CDN). Layers hosted on SeaSketch are fast, and support our and . We recommend hosting data directly from SeaSketch for the best user experience and offer 10 gigabytes of layer hosting for free with each project.

Uploading a layer

To create a new layer in SeaSketch, navigate to Admin > Data Layers > Overlay Layers and simply drag & drop a to the window. Drag & drop as many files as you like, even all at once! Data files are processed individually on our cloud infrastructure, and can scale to handle as many as needed. You can also choose to browse for files on your computer using the Edit menu.

After choosing one or more files to upload, you will see a Background Task list appear at the bottom of the overlays list. This enables you to track the stages of processing for each upload.

If there are any errors while processing your upload, they will be indicated in the Background Jobs list where you can click the info button for more detail.

Supported data types

Vector Formats

Shapefile special considerations

Shapefiles are very common among GIS users and one of our top recommendations for uploads. They are smaller that GeoJSON due to their binary nature, so are faster to upload. You can also include FGDC or ISO 19139 xml metadata in your upload to automatically populate metadata.

Before uploading a shapefile, make sure:

Raster Formats

SeaSketch supports raster uploads in the following formats:

Currently SeaSketch only supports uploading files with a single data layer. While SeaSketch can recognize 3-band RGB imagery, when encountering other multi-band GeoTiff or multi-layer NetCDF files the system will pick the first band or layer it encounters. We hope to add support for multi-layer raster uploads and vector formats like File geodatabase in the future, but this is a current limitation.

Managing new versions of a dataset

SeaSketch is designed to serve as a long-term steward of your data. This includes handling situations where a dataset is replaced by a new version. SeaSketch can track versions of a dataset, recording who uploaded it, when, and why through user-contributed change-log messages. Once in the system, you can even rollback layers to a previous version.

To view data source versioning information, navigate to the Data Source tab in the layer editor. Here you will see a list of each version, which you can click to see further details.

To create a new version of a layer, drag & drop a new layer to the Data Source tab. You will be prompted to provide a change-log message so that future viewers can understand why the revision was made.

Rolling back changes

SeaSketch tracks older visions of layers in the database. This means you can rollback to an older version if a mistake is made. Rolling back to an older version deletes all later versions of a data source, so confirmation is required.

Enabling data download

SeaSketch retains the original uploaded file in its database. If desired, you can enable your end users to download this file, as well as transform it into their spatial data format of choice. End users can right-click on these layers and choose Download Data when enabled.

Enabling data download for a single layer

From the layer editor, toggle the Enable Data Download switch.

Toggling data download for all layers

From the Overlay Layers toolbar, choose Settings > Data Download to set whether uploaded files are downloadable or private by default. You can also use the Edit > Data Download actions to change settings for all existing layers.

Managing the data hosting quota

SeaSketch provides 10 GB of free storage for each project, which should be more than enough for most. This limit is in place to prevent abuse or misuse of SeaSketch. Some datasets (particularly raster imagery) may consume a disproportionate amount of this capacity. If a project reaches the data hosting limit, spatial data layer uploads will be disabled until storage is freed up. To facilitate this process, the Overlay Layers toolbar can be used to show a summary of how layers are counting against the storage limit. Choose View > Data Hosting Quota to see this visualization.

SeaSketch supports a growing list of vector and raster data formats. Some of these files have special requirements that are important to understand for successful uploads. If a data format you use is not currently supported, please .

Each layer you upload needs to be represented by a single file, but "Shapefiles" are , each representing different concerns like projection information (.prj), geometry (.shp) and column values (.dbf). For this reason, you will need to create a Zipfile archive which contains all these associated files into one archive.

For an example of a .zip file which meets these criteria, download this .

- Including both RGB imagery or single-band data values

- First layer found will be used

By default, SeaSketch retains all older versions of a data source, which count against your . You can set your project to only retain older versions for a specified length of time (e.g. 6 months). To adjust these settings, navigate to the Overlay Layers toolbar and select Settings > Archived Layer Retention.

Use this treemap visualization to identify which layers are consuming the most storage space. Deleting these layers will immediately free up space and enable you to upload layers again. If you project is unable to remain under the data hosting quota, please for assistance.

contact support
Esri Shapefile
GeoJSON
Flatgeobuf
actually many different files
example of the Federated States of Micronesia EEZ
GeoTiff
NetCDF
contact support
data hosting quota
advanced cartography tools
layer versioning features
supported file
From the Overlay Layers toolbar, choose Edit > Add Data > Upload spatial data files
The Background Jobs list will appear when there are uploads being actively processed.
After dropping a new layer revision into the Data Source tab, processing progress can be visualized
SeaSketch has controls for the default downloadability of your uploaded data, as well as bulk actions to change the download setting for current layers.
From the Overlay Layers toolbar, choose Edit > Add Data > Upload spatial data files
Screenshot of background job progress indicator
Screenshot of a layer revision being processed