Class: VectorLayer

new VectorLayer(id, geometriesopt, optionsopt) [source]

Parameter Type Default Description

id String | Number layer's id

geometries opt Geometry | Array.<Geometry> null geometries to add

options opt

Object

null

construct options

Properties

Parameter	Type	Default	Description
`style` opt	Object	null	vectorlayer's style
`*` opt	*	null	options defined in VectorLayer

Extends:

OverlayLayer

Fires:

setstyle
removestyle
addgeo
removegeo
clear
idchange
setzindex
setopacity
show
hide
renderercreate
visiblechange
resourceload
canvascreate
renderstart
renderend

Members

(constant) options

Properties:

Name Type Description

options

Object

VectorLayer's options

Properties

Name	Type	Default	Description
`debug`	Boolean	false	whether the geometries on the layer is in debug mode.
`enableSimplify`	Boolean	true	whether to simplify geometries before rendering.
`cursor`	String	default	the cursor style of the layer
`geometryEvents`	Boolean	true	enable/disable firing geometry events, disable it to improve performance.
`defaultIconSize`	Boolean	[20,20	default size of a marker's icon
`enableAltitude` opt	Boolean	false	whether to enable render geometry with altitude, false by default
`altitudeProperty` opt	Boolean	altitude	geometry's altitude property name, if enableAltitude is true, "altitude" by default
`drawAltitude` opt	Boolean	false	whether to draw altitude: a vertical line for marker, a vertical polygon for line
`sortByDistanceToCamera` opt	Boolean	false	markers Sort by camera distance
`roundPoint` opt	Boolean	false	round point before painting to improve performance, but will cause geometry shaking in animation
`altitude` opt	Number	0	layer altitude
`collision` opt	Boolean	false	whether collision
`collisionBufferSize` opt	Number	2	collision buffer size
`collisionDelay` opt	Number	250	collision delay time when map Interacting
`collisionScope` opt	String	layer	Collision range:layer or map
`progressiveRender` opt	Boolean	false	progressive Render
`progressiveRenderCount` opt	Number	1000	progressive Render page size
`progressiveRenderDebug` opt	Boolean	false	progressive Render debug
`drawImmediate` opt	Boolean	false	(Only for layer rendered with CanvasRenderer) In default, for performance reason, layer will be drawn in a frame requested by RAF(RequestAnimationFrame). Set drawImmediate to true to draw immediately. This is necessary when layer's drawing is wrapped with another frame requested by RAF.
`geometryEventTolerance` opt	Boolean	1	tolerance for geometry events
`attribution` opt	String	null	the attribution of this layer, you can specify company or other information of this layer.
`minZoom` opt	Number	null	the minimum zoom to display the layer, set to -1 to unlimit it.
`maxZoom` opt	Number	null	the maximum zoom to display the layer, set to -1 to unlimit it.
`visible` opt	Boolean	true	whether to display the layer.
`opacity` opt	Number	1	opacity of the layer, from 0 to 1.
`zIndex` opt	Number		z index of the layer
`hitDetect` opt	Boolean	true	Whether to enable hit detection for layers for cursor styles on this map, disable it to improve performance.
`renderer` opt	String	canvas	renderer type, "canvas" in default.
`globalCompositeOperation` opt	String	null	(Only for layer rendered with CanvasRenderer) globalCompositeOperation of layer's canvas 2d context.
`debugOutline` opt	String	'#0f0'	debug outline's color.
`cssFilter` opt	String	null	css filter apply to canvas context's filter
`forceRenderOnMoving` opt	Boolean	false	force to render layer when map is moving
`forceRenderOnZooming` opt	Boolean	false	force to render layer when map is zooming
`forceRenderOnRotating` opt	Boolean	false	force to render layer when map is Rotating

Overrides:

OverlayLayer#options

Source:

layer/VectorLayer.js, line 38

Methods

identify(coordinate, optionsopt) [source]

Identify the geometries on the given coordinate

Parameter Type Default Description

coordinate maptalks.Coordinate coordinate to identify

options opt

Object

null

options

Properties

Parameter	Type	Default	Description
`tolerance` opt	Object	0	identify tolerance in pixel
`count` opt	Object	null	result count

Returns:

Array.<Geometry>: geometries identified

identifyAtPoint(point, optionsopt) [source]

Identify the geometries on the given container point

Parameter Type Default Description

point maptalks.Point container point to identify

options opt

Object

null

options

Properties

Parameter	Type	Default	Description
`tolerance` opt	Object	0	identify tolerance in pixel
`count` opt	Object	null	result count

Returns:

Array.<Geometry>: geometries identified

toJSON(optionsopt) [source]

Export the VectorLayer's JSON.

Parameter Type Default Description

options opt

Object

null

export options

Properties

Parameter	Type	Default	Description
`geometries` opt	Object	null	If not null and the layer is a OverlayerLayer, the layer's geometries will be exported with the given "options.geometries" as a parameter of geometry's toJSON.
`clipExtent` opt	Extent	null	if set, only the geometries intersectes with the extent will be exported.

Returns:

Object: layer's JSON

(inherited) getGeometryById(id) [source]

Get a geometry by its id

Parameter	Type	Description
`id`	String \| Number	id of the geometry

Returns:

Geometry:

(inherited) getGeometries(filteropt, contextopt) [source]

Get all the geometries or the ones filtered if a filter function is provided.

Parameter	Type	Description
`filter` opt	function	a function to filter the geometries
`context` opt	Object	context of the filter function, value to use as this when executing filter.

Returns:

Array.<Geometry>:

(inherited) getFirstGeometry() [source]

Get the first geometry, the geometry at the bottom.

Returns:

Geometry: first geometry

(inherited) getLastGeometry() [source]

Get the last geometry, the geometry on the top

Returns:

Geometry: last geometry

(inherited) getCount() [source]

Get count of the geometries

Returns:

Number: count

(inherited) getExtent() [source]

Get extent of all the geometries in the layer, return null if the layer is empty.

Returns:

Extent: - extent of the layer

(inherited) forEach(fn, contextopt) [source]

Executes the provided callback once for each geometry present in the layer in order.

Parameter	Type	Description
`fn`	function	a callback function
`context` opt	*	callback's context, value to use as this when executing callback.

Returns:

OverlayLayer: this

(inherited) filter(fn, contextopt) [source]

Creates a GeometryCollection with all the geometries that pass the test implemented by the provided function.

Parameter	Type	Description
`fn`	function	Function to test each geometry
`context` opt	*	Function's context, value to use as this when executing function.

Returns:

GeometryCollection: A GeometryCollection with all the geometries that pass the test

(inherited) isEmpty() [source]

Whether the layer is empty.

Returns:

Boolean:

(inherited) addGeometry(geometries, fitViewopt) [source]

Adds one or more geometries to the layer

Parameter Type Default Description

geometries Geometry | Array.<Geometry> one or more geometries

fitView opt

Boolean | Object

false

automatically set the map to a fit center and zoom for the geometries

Properties

Parameter	Type	Default	Description
`easing` opt	String	out	default animation type
`duration` opt	Number	map.options.zoomAnimationDuration	default animation time
`step` opt	function	null	step function during animation, animation frame as the parameter

Returns:

OverlayLayer: this

(inherited) getGeoMinZIndex() [source]

Get minimum zindex of geometries

(inherited) getGeoMaxZIndex() [source]

Get maximum zindex of geometries

(inherited) removeGeometry(geometries) [source]

Removes one or more geometries from the layer

Parameter	Type	Description
`geometries`	String \| Array.<String> \| Geometry \| Array.<Geometry>	geometry ids or geometries to remove

Returns:

OverlayLayer: this

(inherited) clear() [source]

Clear all geometries in this layer

Returns:

OverlayLayer: this

(protected) (inherited) onRemoveGeometry(geometry) [source]

Called when geometry is being removed to clear the context concerned.

Parameter	Type	Description
`geometry`	Geometry	the geometry instance to remove

(inherited) getStyle() [source]

Gets layer's style.

Returns:

Object|Array.<Object>: layer's style

(inherited) setStyle(style) [source]

Sets style to the layer, styling the geometries satisfying the condition with style's symbol.
Based on filter type in [mapbox-gl-js's style specification]{https://www.mapbox.com/mapbox-gl-js/style-spec/#types-filter}.

layer.setStyle([
        {
          'filter': ['==', 'count', 100],
          'symbol': {'markerFile' : 'foo1.png'}
        },
        {
          'filter': ['==', 'count', 200],
          'symbol': {'markerFile' : 'foo2.png'}
        }
      ]);

Parameter	Type	Description
`style`	Object \| Array.<Object>	layer's style

Fires:

setstyle

Returns:

VectorLayer: this

(inherited) removeStyle() [source]

Removes layers' style

Fires:

removestyle

Returns:

VectorLayer: this

(inherited) load() [source]

load the tile layer, can't be overrided by sub-classes

(inherited) getId() [source]

Get the layer id

Returns:

String: id

(inherited) setId(id) [source]

Set a new id to the layer

Parameter	Type	Description
`id`	String	new layer id

Fires:

idchange

Returns:

Layer: this

(inherited) addTo(map) [source]

Adds itself to a map.

Parameter	Type	Description
`map`	Map	map added to

Returns:

Layer: this

(inherited) setZIndex(zIndex) [source]

Set a z-index to the layer

Parameter	Type	Description
`zIndex`	Number	layer's z-index

Returns:

Layer: this

(inherited) getZIndex() [source]

Get the layer's z-index

Returns:

Number:

(inherited) getMinZoom() [source]

Get Layer's minZoom to display

Returns:

Number:

(inherited) getMaxZoom() [source]

Get Layer's maxZoom to display

Returns:

Number:

(inherited) getOpacity() [source]

Get layer's opacity

Returns:

Number:

(inherited) setOpacity(opacity) [source]

Set opacity to the layer

Parameter	Type	Description
`opacity`	Number	layer's opacity

Returns:

Layer: this

(protected) (inherited) isCanvasRender() [source]

If the layer is rendered by HTML5 Canvas.

Returns:

Boolean:

(inherited) getMap() [source]

Get the map that the layer added to

Returns:

Map:

(inherited) getProjection() [source]

Get projection of layer's map

Returns:

Object:

(inherited) bringToFront() [source]

Brings the layer to the top of all the layers

Returns:

Layer: this

(inherited) bringToBack() [source]

Brings the layer under the bottom of all the layers

Returns:

Layer: this

(inherited) show() [source]

Show the layer

Returns:

Layer: this

(inherited) hide() [source]

Hide the layer

Returns:

Layer: this

(inherited) isVisible() [source]

Whether the layer is visible now.

Returns:

Boolean:

(inherited) remove() [source]

Remove itself from the map added to.

Returns:

Layer: this

(inherited) getMask() [source]

Get the mask geometry of the layer

Returns:

Geometry:

(inherited) setMask(mask) [source]

Set a mask geometry on the layer, only the area in the mask will be displayed.

Parameter	Type	Description
`mask`	Geometry	mask geometry, can only be a Marker with vector symbol, a Polygon or a MultiPolygon

Returns:

Layer: this

(inherited) removeMask() [source]

Remove the mask

Returns:

Layer: this

(protected) (inherited) onLoad() [source]

Prepare Layer's loading, this is a method intended to be overrided by subclasses.

Returns:

Boolean: true to continue loading, false to cease.

(inherited) isLoaded() [source]

Whether the layer is loaded

Returns:

Boolean:

(inherited) getCollisionIndex() [source]

Get layer's collision index

Returns:

CollisionIndex:

(inherited) clearCollisionIndex() [source]

Clear layer's collision index. Will ignore if collisionScope is not layer

(inherited) on(eventsOn, handler, contextopt) [source]

foo.on('mousedown mousemove mouseup', onMouseEvent, foo);

Parameter	Type	Default	Description
`eventsOn`	String		event types to register, seperated by space if more than one.
`handler`	function		handler function to be called
`context` opt	Object	null	the context of the handler

Mixes From:

Eventable.on

Returns:

Any: this

(inherited) addEventListener(eventTypes, handler, contextopt) [source]

Alias for on

Parameter	Type	Default	Description
`eventTypes`	String		event types to register, seperated by space if more than one.
`handler`	function		handler function to be called
`context` opt	Object	null	the context of the handler

Mixes From:

Eventable.addEventListener

Returns:

: this

(inherited) once(eventTypes, handler, contextopt) [source]

Same as on, except the listener will only get fired once and then removed.

foo.once('mousedown mousemove mouseup', onMouseEvent, foo);

Parameter	Type	Default	Description
`eventTypes`	String		event types to register, seperated by space if more than one.
`handler`	function		listener handler
`context` opt	Object	null	the context of the handler

Mixes From:

Eventable.once

Returns:

: this

(inherited) off(eventsOff, handler, contextopt) [source]

Unregister the event handler for the specified event types.

foo.off('mousedown mousemove mouseup', onMouseEvent, foo);

Parameter	Type	Default	Description
`eventsOff`	String		event types to unregister, seperated by space if more than one.
`handler`	function		listener handler
`context` opt	Object	null	the context of the handler

Mixes From:

Eventable.off

Returns:

: this

(inherited) removeEventListener(eventTypes, handler, contextopt) [source]

Alias for off

Parameter	Type	Default	Description
`eventTypes`	String		event types to unregister, seperated by space if more than one.
`handler`	function		listener handler
`context` opt	Object	null	the context of the handler

Mixes From:

Eventable.removeEventListener

Returns:

: this

(inherited) listens(eventType, hanlderopt, contextopt) [source]

Returns listener's count registered for the event type.

Parameter	Type	Default	Description
`eventType`	String		an event type
`hanlder` opt	function	null	listener function
`context` opt	Object	null	the context of the handler

Mixes From:

Eventable.listens

Returns:

Number:

(inherited) getListeningEvents() [source]

Get all the listening event types

Mixes From:

Eventable.getListeningEvents

Returns:

Array.<String>: events

(inherited) copyEventListeners(target) [source]

Copy all the event listener to the target object

Parameter	Type	Description
`target`	Object	target object to copy to.

Mixes From:

Eventable.copyEventListeners

Returns:

: this

(inherited) fire(eventType, param) [source]

Fire an event, causing all handlers for that event name to run.

Parameter	Type	Description
`eventType`	String	an event type to fire
`param`	Object	parameters for the listener function.

Mixes From:

Eventable.fire

Returns:

: this

(inherited) registerJSONType(type) [source]

It is a static method.
Register layer for JSON serialization and assign a JSON type.

Parameter	Type	Description
`type`	String	JSON type

Mixes From:

JSONAble.registerJSONType

(inherited) getJSONClass(type) [source]

It is a static method.
Get class of input JSON type

Parameter	Type	Description
`type`	String	JSON type

Mixes From:

JSONAble.getJSONClass

Returns:

Class: Class

(inherited) getJSONType() [source]

Get object's JSON Type

Mixes From:

JSONAble.getJSONType

Returns:

String:

(inherited) registerRenderer(name, clazz) [source]

Parameter	Type	Description
`name`	String	renderer's register key
`clazz`	function	renderer's class, a function (not necessarily a Class).

Mixes From:

Renderable.registerRenderer

Returns:

*: this

(inherited) getRendererClass(name) [source]

Get the registered renderer class by the given name

Parameter	Type	Description
`name`	String	renderer's register key

Mixes From:

Renderable.getRendererClass

Returns:

function: renderer's class

(inherited) callInitHooks() [source]

Visit and call all the init hooks defined on Class and its parents.

Returns:

Class: this

(inherited) setOptions(options) [source]

Merges options with the default options of the object.

Parameter	Type	Description
`options`	Object	options to set

Returns:

Class: this

(inherited) config(conf) [source]

1. Return object's options if no parameter is provided.
2. update an option and enable/disable the handler if a handler with the same name existed.

// Get marker's options;
var options = marker.config();
// Set map's option "draggable" to false and disable map's draggable handler.
map.config('draggable', false);
// You can update more than one options like this:
map.config({
    'scrollWheelZoom' : false,
    'doubleClickZoom' : false
});