LayerManager interface
A manager for the map control's layers. Exposed through the layers property of the atlas.Map class. Cannot be instantiated by the user.
Methods
add(Layer | Layer[], string | Layer) | Adds one or more layers to the map. The map must be ready before a layer can be added. Use the map.events.add method with event type 'ready'. |
clear() | Removes all layers from the map. |
get |
Retrieves a layer with the specified id. |
get |
Retrieves all layers that have been added to the map. |
get |
Retrieve all Shapes and GeoJSON features that are visible on the map that are in a DataSource or VectorTileSource. Shape objects are editable, while Feature objects are not editable and either reside in a VectorTileSource or represent a cluster point. Clusters have the following properties: cluster: `boolean` - Indicates that the point is a cluster. This will be set to true if Point object represents a cluster. All other point objects are unlikely to have this value unless a property with this same name was added to the Point property data from your app. cluster_id: `string` - A unique id for the cluster. point_count: `number` - The number of points inside the cluster. point_count_abbreviated: `string` - An abbreviated string version of the point count. i.e. `"10K"` Features/Shapes that are not visible or who's layer zoom range does not include the current zoom level will not be returned. Symbol features/Shapes that have been hidden due to text or icon collisions are not included. Features/Shapes from all other layers are included even if they have no contribution to the map rendering, e.g. alpha set to zero. The topmost rendered features/shapes appears first in the returned array and subsequent features are sorted in descending z-order. |
move(string | Layer, string | Layer) | Moves a layer to a different z-position. |
remove(string | Layer | Array<string | Layer>) | Removes one or more layers from the map. |
Method Details
add(Layer | Layer[], string | Layer)
Adds one or more layers to the map. The map must be ready before a layer can be added. Use the map.events.add method with event type 'ready'.
function add(layer: Layer | Layer[], before?: string | Layer)
Parameters
- before
-
string | Layer
Optionally specify a layer or layer id to insert the new layer(s) before it.
clear()
Removes all layers from the map.
function clear()
getLayerById(string)
Retrieves a layer with the specified id.
function getLayerById(id: string): Layer
Parameters
- id
-
string
The id of the layer to retrieve.
Returns
getLayers()
getRenderedShapes(Position | Point | BoundingBox, string | Layer | Array<string | Layer>, Expression)
Retrieve all Shapes and GeoJSON features that are visible on the map that are in a DataSource or VectorTileSource. Shape objects are editable, while Feature objects are not editable and either reside in a VectorTileSource or represent a cluster point. Clusters have the following properties:
cluster: `boolean` - Indicates that the point is a cluster. This will be set to true if Point object represents a cluster. All other point objects are unlikely to have this value unless a property with this same name was added to the Point property data from your app.
cluster_id: `string` - A unique id for the cluster.
point_count: `number` - The number of points inside the cluster.
point_count_abbreviated: `string` - An abbreviated string version of the point count. i.e. `"10K"`
Features/Shapes that are not visible or who's layer zoom range does not include the current zoom level will not be returned. Symbol features/Shapes that have been hidden due to text or icon collisions are not included. Features/Shapes from all other layers are included even if they have no contribution to the map rendering, e.g. alpha set to zero. The topmost rendered features/shapes appears first in the returned array and subsequent features are sorted in descending z-order.function getRenderedShapes(geometry?: Position | Point | BoundingBox, layers?: string | Layer | Array<string | Layer>, filter?: Expression): Array<Shape | Feature<atlas.data.Geometry, any>>
Parameters
- geometry
-
Position | Point | BoundingBox
A Position, Point, or BoundingBox that returned features must intersect. If not specified the whole visible world is used.
An array of layers or their ids to limit the query to.
- filter
- Expression
A expression to filter the returned features by.
Returns
move(string | Layer, string | Layer)
Moves a layer to a different z-position.
function move(layer: string | Layer, before?: string | Layer)
Parameters
- layer
-
string | Layer
The layer or id of the layer to move.
- before
-
string | Layer
Optionally specify to move the layer before this.