Skip to content

ShapefileCatalogItem

"type": "shp"

ShapefileCatalogItemTraits

Trait Type Default Description
AttributionTraits
attribution string

The attribution to display with the data.

CatalogMemberTraits
name string

The name of the catalog item.

description string

The description of the catalog item. Markdown and HTML may be used.

nameInCatalog string

The name of the item to be displayed in the catalog, if it is different from the one to display in the workbench.

info InfoSectionTraits[]

Human-readable information about this dataset.

infoSectionOrder string[]

An array of section titles definining the display order of info sections. If this property is not defined, {@link DataPreviewSections}'s DEFAULT_SECTION_ORDER is used

isOpenInWorkbench boolean true

Whether the item in the workbench open or collapsed.

shortReport string

A short report to show on the now viewing tab.

shortReportSections ShortReportTraits[]

A list of collapsible sections of the short report

isExperiencingIssues boolean

Whether the catalog item is experiencing issues which may cause its data to be unavailable

hideLegendInWorkbench boolean

Whether the legend is hidden in the workbench for this catalog member.

legends LegendTraits[]

The legends to display on the workbench.

hideSource boolean

Indicates that the source of this data should be hidden from the UI (obviously this isn't super-secure as you can just look at the network requests).

metadataUrls MetadataUrlTraits[]

Metadata URLs to show in data catalog.

dataUrls DataUrlTraits[]

Data URLs to show in data catalog.

dataCustodian string

Gets or sets a description of the custodian of this data item.

modelDimensions DimensionTraits[]

This provides ability to set model JSON through SelectableDimensions (a dropdown).

disableAboutData boolean

Disables the 'About Data' button in the workbench.

ChartTraits
chartType string

Type determines how the data availibility will be plotted on chart. eg: momentLines, momentPoints

chartDisclaimer string

A HTML string to show above the chart as a disclaimer

chartColor string

The color to use when the data set is displayed on the chart. The value can be any html color string, eg: 'cyan' or '#00ffff' or 'rgba(0, 255, 255, 1)' for the color cyan.

chartGlyphStyle string

The glyph style to use for points plotted on the chart. Allowed values include circle, cross, diamond, square, star, triangle, wye. Default is "circle".

DiscretelyTimeVaryingTraits
fromContinuous string nearest

Specifies how a continuous time (e.g. the timeline control) is mapped to a discrete time for this dataset. Valid values are:
* nearest - the nearest available discrete time to the current continuous time is used.
* next - the discrete time equal to or after the current continuous time is used.
* previous - the discrete time equal to or before the current continuous time is used.

showInChartPanel boolean

Whether to plot data availability on a chart.

disableDateTimeSelector boolean

When true, disables the date time selector in the workbench

multiplierDefaultDeltaStep number 2

The multiplierDefaultDeltaStep is used to set the default multiplier (see TimeVaryingTraits.multiplier trait) - it represents the average number of (real-time) seconds between (dataset) time steps. For example, a value of five would set the multiplier so that a new time step (of this dataset) would appear every five seconds (on average) if the timeline is playing. This trait will only take effect if multiplier is not explicitly set.

FeatureInfoTraits
featureInfoTemplate FeatureInfoTemplateTraits

A template object for formatting content in feature info panel

featureInfoUrlTemplate string

A template URL string for fetching feature info. Template values of the form {x} will be replaced with corresponding property values from the picked feature.

showStringIfPropertyValueIsNull string

If the value of a property is null or undefined, show the specified string as the value of the property. Otherwise, the property name will not be listed at all.

GeoJsonTraits
style StyleTraits

Styling rules that follow simplestyle-spec

clampToGround boolean true

Whether the features in this GeoJSON should be clamped to the terrain surface. If forceCesiumPrimitives is false, this will be true

forceCesiumPrimitives boolean

Force rendering GeoJSON features as Cesium primitives. This will be true if you are using perPropertyStyles, timeProperty, heightProperty or czmlTemplate. If undefined, it will look at configParameters.enableGeojsonMvt

perPropertyStyles PerPropertyGeoJsonStyleTraits[]

Override feature styles according to their properties. This is only supported for cesium primitives (see forceCesiumPrimitives)

timeProperty string

The property of each GeoJSON feature that specifies which point in time that feature is associated with. If not specified, it is assumed that the dataset is constant throughout time. This is only supported for cesium primitives (see forceCesiumPrimitives)

heightProperty string

The property of each GeoJSON feature that specifies the height. If defined, polygons will be extruded to this property (in meters) above terrain. This is only supported for cesium primitives (see forceCesiumPrimitives)

czmlTemplate any

CZML template to be used to replace each GeoJSON Point feature. Feature coordinates and properties will automatically be applied to CZML packet, so they can be used as references. If this is defined, clampToGround, style, perPropertyStyles, timeProperty and heightProperty will be ignored.

For example - this will render a cylinder for every point (and use the length and radius feature properties)
  ```json
  {
    cylinder: {
      length: {
        reference: "#properties.length"
      },
      topRadius: {
        reference: "#properties.radius"
      },
      bottomRadius: {
        reference: "#properties.radius"
      },
      material: {
        solidColor: {
          color: {
            rgba: [0, 200, 0, 20]
          }
        }
      }
    }
  }
  ```
MappableTraits
rectangle RectangleTraits

The bounding box rectangle that contains all the data in this catalog item.

disablePreview boolean

Disables the preview on the Add Data panel. This is useful when the preview will be very slow to load.

disableZoomTo boolean

Disables the zoom to (aka 'Ideal Zoom') button in the workbench.

show boolean true

Show or hide a workbench item. When show is false, a mappable item is removed from the map and a chartable item is removed from the chart panel.

initialMessage InitialMessageTraits

A message to show when the user adds the catalog item to the workbench. Useful for showing disclaimers.

TimeVaryingTraits
currentTime string 2021-09-27T08:07:11.6870000Z

The current time at which to show this dataset.

initialTimeSource string now

The initial time to use if Current Time is not specified. Valid values are
* start - the dataset's start time
* stop - the dataset's stop time
* now - the current system time. If the system time is after Stop Time, Stop Time is used. If the system time is before Start Time, Start Time is used.
* none - do not automatically set an initial time
This value is ignored if Current Time is specified.

startTime string

The earliest time for which this dataset is available. This will be the start of the range shown on the timeline control.

stopTime string

The latest time for which this dataset is available. This will be the end of the range shown on the timeline control.

multiplier number

The multiplier to use in progressing time for this dataset. For example, 5.0 means that five seconds of dataset time will pass for each one second of real time.

isPaused boolean true

True if time is currently paused for this dataset, or false if it is progressing.

dateFormat string

A dateformat string (using the dateformat package) used to adjust the presentation of the date in various spots in the UI for a catalog item.
For example, to just show the year set to 'yyyy'. Used in places like the the Workbench Item and Bottom Dock

UrlTraits
url string

The base URL of the file or service.

forceProxy boolean

Force the default proxy to be used for all network requests.

cacheDuration string 1d

The cache duration to use for proxied URLs for this catalog member. If undefined, proxied URLs are effectively cachable forever. The duration is expressed as a Varnish-like duration string, such as '1d' (one day) or '10000s' (ten thousand seconds).

InfoSectionTraits

Trait Type Default Description
name string

The name of the section.

content string

The content of the section, in Markdown and HTML format. Set this property to null to remove this section entirely.

contentAsObject any

The content of the section which is a JSON object. Set this property to null to remove this section entirely.

show boolean true

Indicates if this info section showing (not collapsed).

ShortReportTraits

Trait Type Default Description
name string

The name of the section.

content string

The content of the section.

show boolean true

Indicates if this short report section showing.

LegendTraits

Trait Type Default Description
title string

A title to be displayed above the legend.

url string

The URL of the legend image.

imageScaling number 1

Scaling of the legend. For example, a high DPI legend may have scaling = 0.5, so it will be scaled doown 50%

urlMimeType string

The MIME type of the URL legend image.

items LegendItemTraits[]

LegendItemTraits

Trait Type Default Description
title string

The title to display next to this legend item.

multipleTitles string

Multiple titles to display next to this legend item.

maxMultipleTitlesShowed string 10

Maximum number of multiple titles to display next to this legend item. (Default is 10)

titleAbove string

The title to display above this legend item, i.e. marking the top of a box on the legend.

titleBelow string

The title to display below this legend item, i.e. marking the bottom of a box on the legend.

color string

The CSS color to display for this item. This property is ignored if Legend URL is specified.

outlineColor string

The CSS color with which to outline this item.

multipleColors string[]

Multiple colors to show with this item in a grid arrangement.

imageUrl string

The URL of an image to display with this item.

addSpacingAbove boolean

True to add a bit of extra spacing above this item in order to separate it visually from the rest of the legend.

imageHeight number 20

The height of the legend image.

imageWidth number 20

The width of the legend image.

MetadataUrlTraits

Trait Type Default Description
url string

The metadata URL of the file or service.

title string

Title used for metadata URL button.

DataUrlTraits

Trait Type Default Description
type string

Type of data URL. This value will be used to provide context or instruction on how to use the data URL. For example wcs will provide a link to WCS docs. Current supported values are: - wfs = A Web Feature Service (WFS) base URL - wcs = A Web Coverage Service (WCS) base URL - wfs-complete = A complete, ready-to-use link to download features from a WCS server - wcs-complete = A complete, ready-to-use link to download features from a WFS server - direct = Direct URL to dataset (this is the default if no type is specified) - none = Hide data URL

MetadataUrlTraits
url string

The metadata URL of the file or service.

title string

Title used for metadata URL button.

DimensionTraits

Trait Type Default Description
id string

Dimension ID

name string

Dimension name (human-readable)

options DimensionOptionTraits[]

Dimension options

selectedId string

Selected Option's ID

allowUndefined boolean

Allow dimension to be undefined

disable boolean

Hides dimension

DimensionOptionTraits

Trait Type Default Description
id string

Option ID

name string

Option name (human-readable)

value any

Value (if this is undefined, id will be used)

FeatureInfoTemplateTraits

Trait Type Default Description
name string

A mustache template string for formatting name

template string

A Mustache template string for formatting description

partials any

An object, mapping partial names to a template string. Defines the partials used in Template.

formats any

An object, mapping field names to formatting options.

StyleTraits

Trait Type Default Description
marker-size string

Marker size. Valid values are small, medium, or large. If the value is a number, it is the size in pixels.

marker-color string

Marker color

marker-symbol string

Marker symbol.

marker-opacity number

Marker opacity.

marker-url string

Marker URL.

stroke string

Stroke color.

stroke-opacity number

Stroke opacity.

stroke-width number

Stroke width.

fill string

Fill color.

fill-opacity number

Fill opacity.

PerPropertyGeoJsonStyleTraits

Trait Type Default Description
properties any

If the properties of a feature match these properties, then apply the style to that feature

style StyleTraits

Styling rules to apply, following simplestyle-spec

caseSensitive boolean

True if properties should be matched in a case sensitive fashion

RectangleTraits

Trait Type Default Description
west number

The westernmost longitude in degrees.

south number

The southernmost longitude in degrees.

east number

The easternmost longitude in degrees.

north number

The northernmost longitude in degrees.

InitialMessageTraits

Trait Type Default Description
title string

The title of the message.

content string

The content of the message.

key string

Identifier. If multiple messages with the same key are triggered, only the first will be displayed.

confirmation boolean

Whether the message requires confirmation.

confirmText string

If confirmation is true, the text to put on the confirmation button.

width number

Width of the message.

height number

Height of the message.