Time series fields

Time series fields is a type of data series info on the layer used to visualize how a feature attribute changes over time. This style of visualization works best with features whose positions or geographic shapes don't change over time. This requires the data to be structured so that two or more fields contain data values for the same attribute at different points in time. Those fields must be either string or number data types, and their names should clearly indicate the time period represented by the data (e.g. temperature_Jan2020, temperature_Feb2020, etc.). Web map authoring applications can use the information in the time series fields configuration to generate Arcade expressions that reference the fields in the time series, allowing the layer's renderer to reflect an attribute's value relative to the map's current time.

Referenced by: layerDefinition

Properties

Property	Details
fieldTimeMappings[]	The mapping between field names and time values for the time series configuration.
name	The unique identifier for the time series fields configuration. This will likely be generated by client applications and used to reference the time series within the authoringInfo property of the renderer and in labels and popups.
timeExtent	Represents the time extent for the full list of fields used in the time series fields configuration. This is used for setting the bounds of the time slider.
timeInterval	The interval of time between each field in the time series. For example, if the fields in the time series included temperature_Jan2020, temperature_Feb2020, temperature_Mar2020, etc., the time interval would be 1 and the time interval units would be months.
timeIntervalUnits	Temporal unit of measure for timeInterval. For example, if the fields in the time series included temperature_Jan2020, temperature_Jan2021, temperature_Jan2022, etc., the time interval would be 1 and the time interval units would be years. Valid values: centuries, days, decades, hours, minutes, months, seconds, weeks, years
timeValueUnits	Temporal unit of measure for timeValue (specified in fieldTimeMappings). For example, if the fields in the time series included 'temperature_Jan2020', 'temperature_Jan2021', 'temperature_Jan2022', etc. the time value unit would be 'month' to reflect each field's relevance over a singular month. Valid values: days, hours, minutes, months, seconds, years
title	The title of the time series fields configuration. This is a user-friendly name that can be used in the UI of client applications to refer to the specific time series.
type	Specifies the type of data series info. This is used by client applications to determine how to use the data series info configuration to generate expressions for renderers, labels, popups, charts, or other representations of the data for display in the web map. For time series fields, the value of this property must be time-series-fields. Valid value of this property time-series-fields

time series fields Example

{
  "type": "time-series-fields",
  "name": "ts0",
  "title": "U.S. National Park Annual Visitation Numbers (10 year increments, 1910-2020)",
  "fieldTimeMappings": [
    {
      "fieldName": "F1910",
      "timeValue": "1910"
    },
    {
      "fieldName": "F1920",
      "timeValue": "1920"
    },
    {
      "fieldName": "F1930",
      "timeValue": "1930"
    },
    {
      "fieldName": "F1940",
      "timeValue": "1940"
    },
    {
      "fieldName": "F1950",
      "timeValue": "1950"
    },
    {
      "fieldName": "F1960",
      "timeValue": "1960"
    },
    {
      "fieldName": "F1970",
      "timeValue": "1970"
    },
    {
      "fieldName": "F1980",
      "timeValue": "1980"
    },
    {
      "fieldName": "F1990",
      "timeValue": "1990"
    },
    {
      "fieldName": "F2000",
      "timeValue": "2000"
    },
    {
      "fieldName": "F2010",
      "timeValue": "2010"
    },
    {
      "fieldName": "F2020",
      "timeValue": "2020"
    }
  ],
  "timeInterval": 10,
  "timeValueUnits": "years",
  "timeIntervalUnits": "decades",
  "timeExtent": [
    -1893427200000,
    1577865600000
  ]
}