Managing Map Data Sources

A weather map can display a variety of different weather data sources at once, such as radar, satellite, earthquakes and storm cells. You can complete control over which data sources appear on your weather map and can add or remove them at any time.

Data Source Types

There are three primary data types for a weather map: raster/tile, point and shape:

  • Tile: A raster image or tile layer, such as radar or temperatures.
  • Point: A series of map annotations representing point data, such as earthquakes or storm reports.
  • Shape: Vector polyline and/or polygon data, such as convective outlooks.

Using Layer Codes

The interactive weather map has built-in support for automatically creating and managing the various data sources associated with supported layer codes. These layer codes correspond to those currently offered through the Aeris Maps Platform (AMP).

However, point and shape layers are rendered using data from the Aeris Weather API instead of AMP raster imagery which considerably reduces the number of map units consumed by your weather map. For example, stormcells and stormreports layers will use API data instead of AMP imagery on a weather map.

Adding Layers

To add a layer to your map, just use addLayer():

map.addLayer('radar');

You can also add multiple layers at once using addLayers():

map.addLayers(['satellite','radar','stormreports']);

Layer Options

When adding layers with their code, you can also provide additional configuration options for the layer as the second parameter to addLayer(). This should be an object containing values for one or all of the following options:

Option Type Description
type string Type of content source to use, if supported by the layer. Supports tile, point or shape.
opacity number Opacity to use when rendering tile or raster layers on the map. Not supported for point or shape content sources, which should set their opacity using style providers.
request object Request options for point and shape layers.
request.property object Model property key path options (for text layers only).
request.property.time string Defines the key path of the property to use for a model object’s time value.
request.property.value string Defines the key path of the property to use for a model object’s displayed value.

For instance, if you wanted to show storm cells on the map using raster AMP layers instead of as a point data source, you can specify the type value to override the default source type to use:

map.addLayer('stormcells', {
    type: 'tile'
});

Note that not all layer codes support different content source types.

Removing Layers

Removing layers from the map is similar to adding them. To remove a layer from your map, just use removeLayer():

map. removeLayer('radar');

You can also remove multiple layers at once using removeLayers():

map.removeLayers(['satellite','stormreports']);