API and agentsAPI reference
Layer
object
editRevisionstringpattern^[0-9a-f]{32}$Opaque durable revision paired with this document state. Camera and derived writes do not change it.
lastChangedAtstringor nullformatdate-timeTime of the last accepted covered change, independent of camera and cache clocks.
lastChangedByA named actor has display and fixed SQL names. { deleted: true } explicitly identifies a deleted actor and carries no names or profile fields. Null explicitly means unknown. Never inferred from ownership.
One of:
object
namestringrequiredsqlNamestringrequired
No other keys.
object
deletedbooleanalwaystruerequired
No other keys.
or null
idstringmapIdstringnamestringsqlstringOnly one read-only SELECT over named datasets is accepted. File readers, file-relation shorthand and engine path or definition discovery are refused before binding with sql_rejected, including nested SQL and computed targets. File-referencing PROJ coordinate definitions are also refused before native projection use, including computed or per-row values; EPSG identifiers and inline definitions without files remain supported. Unknown tables receive the same sql_error whether hidden or nonexistent, without catalogue suggestions. Engine errors do not expose filesystem paths or internal statements; input positions are retained when available. Existing saved SQL is retained unchanged; affected saved and published queries fail.
styleStylevisiblebooleantooltiparray of stringor nullFields shown in the hover tooltip; null = automatic.
popuparray of stringor nullFields shown in the click pop-up; null = automatic.
publishedFieldsarray of stringor nullThe author's explicit published-field list; null = the derived minimal projection (style, label, tooltip/pop-up, live-filter, timeline and published-widget fields). Published responses carry exactly the effective set; fields the published map needs to render are always published, whatever this lists.
inLegendbooleanWhether the layer contributes to the legend.
vizVizfiltersarray of LayerFilterRefinements applied before aggregation; the SQL stays the source of truth and [] restores it exactly.
legendTitlestringor nullLegend title override; null = the layer name.
legendLabelsarray of string or nullor nullPer-entry legend label overrides; null entries (and null itself) keep the automatic labels.
legendAttrsobjector nullPer-channel legend attribute-name overrides, keyed by channel (fill, stroke, radius, width). Three states per channel: a missing key (and null itself) keeps the automatic attribute name, a string overrides it, and a null value hides that channel's attribute line. An override drops automatically when its channel's driving attribute changes.
ordinalinteger
All of:
object
editRevisionstringrequiredpattern^[0-9a-f]{32}$Opaque durable revision paired with this document state. Camera and derived writes do not change it.
lastChangedAtstringor nullrequiredformatdate-timeTime of the last accepted covered change, independent of camera and cache clocks.
lastChangedByrequiredA named actor has display and fixed SQL names. { deleted: true } explicitly identifies a deleted actor and carries no names or profile fields. Null explicitly means unknown. Never inferred from ownership.
One of:
object
namestringrequiredsqlNamestringrequired
No other keys.
object
deletedbooleanalwaystruerequired
No other keys.
or null
7439201b