title | description | api_reference | slug |
---|---|---|---|
MapLayer API |
API Index | MapLayer |
true |
api_maplayercomponent |
kendo-map-layer
- [
kendo-map
]({% slug api_mapcomponent %})
The attribution for the layer. Accepts valid HTML.
If layers-layer-auto-bind
is set to false
, the layer will not bind to the data source during initialization. In this case, data binding will occur when the change
event of the data source is fired. By default, the Map will bind to the data source specified in the configuration.
The data source of the layer.
The supported values are:
- A JavaScript object which represents any valid data source configuration.
- A JavaScript array.
- An existing
kendo.data.DataSource
instance.
Specifies the extent of the region that is covered by this layer. If the specified area is out of view, the layer will be hidden. Accepts a four-element array which specifies the extent that is covered by this layer—North-West latitude, longitude, South-East latitude, longitude. If layers-layer-extent
is not specified, the layer is always visible.
The API key for the layer. Currently supported only for Bing (tm) tile layers.
The Bing map tile types.
The culture that will be used for the Bing map tiles.
The data item field which contains the marker (symbol) location. The field accepts an array of numbers which contains the latitude and longitude in decimal degrees. Requires you to set the dataSource
option. Only applicable to the marker and bubble layers.
The default marker shape for data-bound markers.
The supported predefined marker shapes are:
pinTarget
pin
Marker shapes are implemented as CSS classes on the marker span.k-marker
element—for example, pinTarget
is rendered as k-marker-pin-target
.
The size (in pixels) of the image tile.
The data item field which contains the marker title. Requires you to set the dataSource
option.
Specifies if the tooltip will be hidden when the mouse leaves the target element.
- If
layer-layer-tooltip-auto-hide
is set tofalse
, the tooltip displays a Close button. - If
layer-layer-tooltip-auto-hide
is set tofalse
,showAfter
is specified, andshowOn
is set tomouseenter
, the Map will display the tooltip after the given timeout even if the element is no longer hovered over.
The effect that will be used on closing the tooltip.
The duration of the animation.
The effects tat will be used on opening the Tooltip.
The duration of the animation.
The text or the function whose results will be displayed within the tooltip. By default, the tooltip will display the content of the title
attribute of the target element.
A URL or request options from where the tooltip will load its content.
The template for rendering the content of the tooltip.
The template supports the following fields:
location
—The marker location (akendo.dataviz.map.Location
instance).marker
—The instance of the marker.
Specifies if the tooltip callout will be displayed.
Explicitly states whether a content iframe will be created.
The height (in pixels) of the tooltip.
The width (in pixels) of the tooltip.
The position that is relative to the target element at which the tooltip will be displayed.
The supported predefined values are:
bottom
top
left
right
center
The delay (in milliseconds) before the tooltip is displayed. If showOn
is set to click
or focus
, layers-layer-tooltip-show-after
is ignored.
The event on which the tooltip will be displayed.
The supported predefined values are:
mouseenter
click
focus
The maximum symbol size for the bubble layer symbols.
The minimum symbol size for the bubble layer symbols.
The maximum zoom level at which this layer will be displayed.
The minimum zoom level at which this layer will be displayed.
The opacity of the layer.
A list of subdomains that will be used for loading tiles. Alternating between different subdomains enables the parallel execution of more requests.
The symbol that will be used for bubble layers.
The supported values are:
-
circle
—A circle. -
square
—A square symbol -
A function—A symbol that is defined by the user.
Has to accept an object with the following fields:
center
—The symbol center on the current layer.size
—The size of the symbol.style
—The style of the symbol.dataItem
—The dataItem for creating the symbol.location
—The location of the data point.
The return value of the function has to be
kendo.drawing.Shape
.
The layer type.
The supported types are:
bing
—A Bing (tm) tile layer.tile
—A generic "slippy map" tile layer.marker
—A data-bound marker layer.shape
—A vector shape layer, that is, bound to GeoJSON data.bubble
—A specialized vector shape layer for bubble maps.
The default fill color for layer shapes. Accepts any valid CSS color string, including hex and rgb.
The default fill opacity (0 to 1) for layer shapes.
The default stroke color for layer shapes. Accepts any valid CSS color string, including hex and rgb.
The default dash type for layer shapes.
The supported dash types are:
dash
—A line that consists of dashes.dashDot
—A line that consists of a repeating dash-dot pattern.dot
—A line that consists of dots.longDash
—A line that consists of a repeating long-dash pattern.longDashDot
—A line that consists of a repeating long-dash-dot pattern.longDashDotDot
—A line that consists of a repeating long-dash-dot-dot.solid
—A solid line.
The default stroke opacity (0 to 1) for layer shapes.
The default stroke width for layer shapes.
The URL template for tile layers.
The template supports the following variables:
x
—The x coordinate of the tile.y
—The y coordinate of the tile.zoom
—The zoom level.subdomain
—The subdomain for this tile.
The value field for bubble layer symbols. The data item field accepts a number.
The zIndex
for this layer. Layers are normally stacked in a declaration order—the last layer is on top.