Class: GeoJSONLayer

GeoJSONLayer

A sub class of VectorLayer supports GeoJSON.

new GeoJSONLayer(id, json, optionsopt) [source]

Parameter Type Default Description
id String | Number layer's id
json Object GeoJSON objects
options opt Object null construct options defined in GeoJSONLayer
Extends:
Fires:

Members

  • (constant) options

    • Inherited From:
    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
    defaultIconSize Boolean [20, 20] - default size of a marker's icon
    cacheVectorOnCanvas opt Boolean true whether to cache vector markers on a canvas, this will improve performance.\
    minZoom opt Number -1 the minimum zoom to display the layer, set to -1 to unlimit it.
    maxZoom opt Number -1 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.
    renderer opt String canvas renderer type. Don't change it if you are not sure about it. About renderer, see TODO.
    Inherited From:
    Source:

    Methods

  • addData(json) [source]

    • Add geojson data to the layer
    Parameter Type Description
    json Object | Array.<Object> GeoJSON data
    Returns:
    GeoJSONLayer: this

  • toJSON(optionsopt) [source]

    • Export the GeoJSONLayer's profile 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 profile JSON

  • (inherited) getStyle() [source]

    • Gets layer's style.
    Inherited From:
    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 
    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
    Inherited From:
    Fires:
    Returns:
    VectorLayer: this

  • (inherited) removeStyle() [source]

    • Removes layers' style
    Inherited From:
    Fires:
    Returns:
    VectorLayer: this

  • (inherited) getGeometryById(id) [source]

    • Get a geometry by its id
    Parameter Type Description
    id String | Number id of the geometry
    Inherited From:
    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.
    Inherited From:
    Returns:
    Array.<Geometry>:

  • (inherited) getFirstGeometry() [source]

    • Get the first geometry, the geometry at the bottom.
    Inherited From:
    Returns:
    Geometry: first geometry

  • (inherited) getLastGeometry() [source]

    • Get the last geometry, the geometry on the top
    Inherited From:
    Returns:
    Geometry: last geometry

  • (inherited) getCount() [source]

    • Get count of the geometries
    Inherited From:
    Returns:
    Number: count

  • (inherited) getExtent() [source]

    • Get extent of all the geometries in the layer, return null if the layer is empty.
    Inherited From:
    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.
    Inherited From:
    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.
    Inherited From:
    Returns:
    GeometryCollection: A GeometryCollection with all the geometries that pass the test

  • (inherited) isEmpty() [source]

    • Whether the layer is empty.
    Inherited From:
    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 false automatically set the map to a fit center and zoom for the geometries
    Inherited From:
    Returns:
    OverlayLayer: this

  • (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
    Inherited From:
    Returns:
    OverlayLayer: this

  • (inherited) clear() [source]

    • Clear all geometries in this layer
    Inherited From:
    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 From:

  • (inherited) 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
    count opt Object null result count
    Inherited From:
    Returns:
    Array.<Geometry>: geometries identified

  • (inherited) load() [source]

    • load the tile layer, can't be overrided by sub-classes
    Inherited From:

  • (inherited) getId() [source]

    • Get the layer id
    Inherited From:
    Returns:
    String: id

  • (inherited) setId(id) [source]

    • Set a new id to the layer
    Parameter Type Description
    id String new layer id
    Inherited From:
    Fires:
    Returns:
    Layer: this

  • (inherited) addTo(map) [source]

    • Adds itself to a map.
    Parameter Type Description
    map Map map added to
    Inherited From:
    Returns:
    Layer: this

  • (inherited) setZIndex(zIndex) [source]

    • Set a z-index to the layer
    Parameter Type Description
    zIndex Number layer's z-index
    Inherited From:
    Returns:
    Layer: this

  • (inherited) getZIndex() [source]

    • Get the layer's z-index
    Inherited From:
    Returns:
    Number:

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

    • If the layer is rendered by HTML5 Canvas 2d.
    Inherited From:
    Returns:
    Boolean:

  • (inherited) getMap() [source]

    • Get the map that the layer added to
    Inherited From:
    Returns:
    Map:

  • (inherited) bringToFront() [source]

    • Brings the layer to the top of all the layers
    Inherited From:
    Returns:
    Layer: this

  • (inherited) bringToBack() [source]

    • Brings the layer under the bottom of all the layers
    Inherited From:
    Returns:
    Layer: this

  • (inherited) show() [source]

    • Show the layer
    Inherited From:
    Returns:
    Layer: this

  • (inherited) hide() [source]

    • Hide the layer
    Inherited From:
    Returns:
    Layer: this

  • (inherited) isVisible() [source]

    • Whether the layer is visible now.
    Inherited From:
    Returns:
    Boolean:

  • (inherited) remove() [source]

    • Remove itself from the map added to.
    Inherited From:
    Returns:
    Layer: this

  • (inherited) getMask() [source]

    • Get the mask geometry of the layer
    Inherited From:
    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
    Inherited From:
    Returns:
    Layer: this

  • (inherited) removeMask() [source]

    • Remove the mask
    Inherited From:
    Returns:
    Layer: this

  • (protected) (inherited) onAdd() [source]

    • Prepare Layer's loading, this is a method intended to be overrided by subclasses.
    Inherited From:
    Returns:
    Boolean: true to continue loading, false to cease.

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

    • Register a handler function to be called whenever this event is fired. 
    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:
    Inherited From:
    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:
    Inherited From:
    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:
    Inherited From:
    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:
    Inherited From:
    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:
    Inherited From:
    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:
    Inherited From:
    Returns:
    Number:

  • (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:
    Inherited From:
    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:
    Inherited From:
    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:
    Inherited From:

  • (inherited) getClass(type) [source]

    • It is a static method.
    Get class of input JSON type
    Parameter Type Description
    type String JSON type
    Mixes From:
    Inherited From:
    Returns:
    Class: Class

  • (inherited) getJSONType() [source]

    • Get object's JSON Type
    Mixes From:
    Inherited From:
    Returns:
    String:

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

    • Register a renderer class with the given name.
    Parameter Type Description
    name String renderer's register key
    clazz function renderer's class, a function (not necessarily a Class).
    Mixes From:
    Inherited From:
    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:
    Inherited From:
    Returns:
    function: renderer's class

  • (inherited) callInitHooks() [source]

    • Visit and call all the init hooks defined on Class and its parents.
    Inherited From:
    Returns:
    Class: this

  • (inherited) setOptions(options) [source]

    • Merges options with the default options of the object.
    Parameter Type Description
    options Object options to set
    Inherited From:
    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
});
    Parameter Type Description
    conf Object config to update
    Inherited From:
    Returns:
    Class: this

    Events

  • (inherited) setstyle [source]

    • setstyle event.
    Inherited From:
    Properties:
    Name Type Description
    type String setstyle
    target VectorLayer layer
    style Object | Array.<Object> style to set
    Inherited From:
    Source:

  • (inherited) removestyle [source]

    • removestyle event.
    Inherited From:
    Properties:
    Name Type Description
    type String removestyle
    target VectorLayer layer
    Inherited From:
    Source:

  • (inherited) addgeo [source]

    • addgeo event.
    Inherited From:
    Properties:
    Name Type Description
    type String addgeo
    target OverlayLayer layer
    geometries Array.<Geometry> the geometries to add
    Inherited From:
    Source:

  • (inherited) removegeo [source]

    • removegeo event.
    Inherited From:
    Properties:
    Name Type Description
    type String removegeo
    target OverlayLayer layer
    geometries Array.<Geometry> the geometries to remove
    Inherited From:
    Source:

  • (inherited) clear [source]

    • clear event.
    Inherited From:
    Properties:
    Name Type Description
    type String clear
    target OverlayLayer layer
    Inherited From:
    Source:

  • (inherited) idchange [source]

    • idchange event.
    Inherited From:
    Properties:
    Name Type Description
    type String idchange
    target Layer the layer fires the event
    old String value of the old id
    new String value of the new id
    Inherited From:
    Source:

  • (inherited) resourceload [source]

    • resourceload event, fired when external resources of the layer complete loading.
    Inherited From:
    Properties:
    Name Type Description
    type String resourceload
    target Layer layer
    Inherited From:
    Source:

  • (inherited) renderstart [source]

    • renderstart event, fired when layer starts to render.
    Inherited From:
    Properties:
    Name Type Description
    type String renderstart
    target Layer layer
    context CanvasRenderingContext2D canvas's context
    Inherited From:
    Source:

  • (inherited) renderend [source]

    • renderend event, fired when layer ends rendering.
    Inherited From:
    Properties:
    Name Type Description
    type String renderend
    target Layer layer
    context CanvasRenderingContext2D canvas's context
    Inherited From:
    Source:

  • (inherited) layerload [source]

    • layerload event, fired when layer is loaded.
    Inherited From:
    Properties:
    Name Type Description
    type String layerload
    target Layer layer
    Inherited From:
    Source: