KML Layer (KML)

Keyhole Markup Language (KML) is an XML-based format for storing geographic data and associated content and is an official Open Geospatial Consortium (OGC) standard. KML is a common format for sharing geographic data with non-GIS users as it can be easily delivered on the Internet.


Property Details
id A unique identifying string for the layer.
itemId A string containing the item ID of the service if it's registered on ArcGIS Online or your organization's portal.
layerType String indicating the layer type.
Value of this property must be KML
maxScale A number representing the maximum scale at which the layer will be visible. The number is the scale's denominator.
minScale A number representing the minimum scale at which the layer will be visible. The number is the scale's denominator.
opacity The degree of transparency applied to the layer on the client side, where 0 is full transparency and 1 is no transparency.
refreshInterval Refresh interval of the layer in minutes. Non-zero value indicates automatic layer refresh at the specified interval. Value of 0 indicates auto refresh is not enabled.
showLegend Indicates whether to allow map authors the ability to control what layers should be shown in a client's legend.
title A user-friendly string title for the layer that can be used in a table of contents.
type Deprecated. Use layerType instead.
url The URL to the layer.
visibility Boolean property determining whether the layer is initially visible in the web map.
visibleFolders Array of numeric IDs of folders that will be made visible.


Live sample web maps showing the KML layer as an operationalLayer

  "operationalLayers": [
      "id": "kml_9012",
      "url": "",
      "visibility": true,
      "opacity": 1,
      "title": "ActiveFirePerimeters",
      "type": "KML",
      "layerType": "KML",
      "visibleFolders": [

Feedback on this topic?