Layers basically help draw data on a map. FlexMap includes three map layers to draw data on a map, which are described as follows:

• GeoMapLayer: Represents a map layer with geographical data.
• ScatterMapLayer: Represents a map layer with a collection of points in geographical coordinates.
• GeoGridLayer:  Represents a map layer with grid.

FlexMap allows you to set the map layers collection using Layers property of the FlexMap class and then add layers to the collection.

The data drawn on the map is fetched from the data source of map layers which can be specified in two ways, either by setting the ItemsSource property to a data collection or by providing a path to data using the Url property. When the data source is specified as a Url, the map fetches the data and sets it to the ItemsSource.

Let us now discuss about the map layers in detail along with the programmatic approach of adding them to the FlexMap control.

GeoMap Layer

The GeoMap layer displays data in GeoJSON format. GeoJSON is a JSON-based format that describes various geographical features (e.g. countries, provinces, cities, etc.) and can include other non-spatial data related to these features.

FlexMap allows you to add the GeoMapLayer to the map using the AddGeoMapLayer method. Then, you can set the data source for the layer using either the Url or ItemsSource property. Along with the data source, you can also set the color scale and style to the layer.

The following image shows FlexMap with two GeoMap layers.

The following code demonstrates how you can add multiple GeoMapLayers to the map using the AddGeoMapLayer method.

@using System.Drawing

@(Html.C1().FlexMap().Id("flexMap")
                .Header("MVC Map")
                .Height(500)
                .Layers(ls =>
                {
                ls.AddGeoMapLayer()
                    .Url("/Content/data/land.json");

                ls.AddGeoMapLayer()
                    .Url("/Content/data/europe.json");
    })
)

Back to Top

ScatterMap Layer

Scatter maps are used to show points of interest at specific coordinates on a map. The scatter map can be created in FlexMap using the ScatterMap layer. In FlexMap, the ScatterMap layer displays an array of points defined by geographical coordinates (latitude and longitude). You can add a ScatterMapLayer to the FlexMap using the AddScatterMapLayer method and set the data source for the layer using either the Url or ItemsSource property. In addition, you can SymbolSize property of the ScatterMapLayer class.

FlexMap can also be used to create bubble map, a variation of the scatter map. Bubble maps also show points of interest on maps, but they ascribe values to the point. The size of the bubbles depends on the value of the data (larger value = larger bubble). When you add the ScatterMapLayer to the map to create a bubble map, you can define the minimum and maximum size for the bubble plot using SymbolMinSize and SymbolMaxSize properties of the ScatterMapLayer class, respectively.

The following image shows airports on the world map using the combination of ScatterMapLayer with GeoMapLayer through bubble map.

The following code creates a combination of the GeoMapLayer that represents land on the map and the ScatterMapLayer displaying airports as dots.

@using System.Drawing
@{
    string[] palette = new string[]
    {
        "#fbb258", "#90cd97", "#f6aac9", "#bfa554", "#bc99c7",
        "#eddd46", "#f07e6e", "#88bde6", "#8c8c8c" };
}
<script>
    function scatterMapItemsSourceChanged(layer, a) {
        const bb = new wijmo.Rect(-200, -10, 500, 80);
        var map = wijmo.Control.getControl("#flexMap");
        map.zoomTo(bb);

        var features = layer.itemsSource;
        features.forEach(function (f) {
            var v = f.coordinates.split(",");
            f.x = v[0];
            f.y = v[1];
            f.flow = 100000 + Math.random() * 100000000;
        });
    }
    function colorScale(v) {
        return 1 - v;
    }
    function colorScaleBindingLand(o) {
        return o.properties.color;
    }
</script>

@(Html.C1().FlexMap().Id("flexMap")
        .Header("Airport Map")
        .Height(500)
        .Tooltip(tt => tt.Content("&#9992; <b>{iata_code}</b><br>{name}"))
        .Layers(ls =>
        {
            ls.AddGeoMapLayer()
                .Url("/Content/data/land.json")
                .ColorScale(cs => cs.Scale("colorScale")
                                    .Binding("colorScaleBindingLand")
                                    .Colors(palette));

            ls.AddGeoMapLayer()
                .Url("/Content/data/europe.json");

            ls.AddScatterMapLayer()
                .Url("/Content/data/airports.json")
                .Style(s => s.Fill("rgba(0,119,179,1)"))
                .Binding("x,y,flow")
                .SymbolMinSize(2)
                .SymbolMaxSize(8)
                .OnClientItemsSourceChanged("scatterMapItemsSourceChanged");
        })
)

Back to Top

GeoGrid Layer

The GeoGrid layer displays grid for the geographical data. FlexMap adds the GeoGrid layer to the map using the AddGeoGridLayer method.

The following image shows FlexMap with grid created using the GeoGrid layer.

The following code demonstrates how you can add the GeoMapLayer to the map:

@using System.Drawing
@{
    string[] palette = new string[]
    {
        "#fbb258", "#90cd97", "#f6aac9", "#bfa554", "#bc99c7",
        "#eddd46", "#f07e6e", "#88bde6", "#8c8c8c" };
}
<script>
    function colorScale(v) {
        return 1 - v;
    }
    function colorScaleBindingLand(o) {
        return o.properties.color;
    }
</script>

@(Html.C1().FlexMap().Id("flexMap")
        .Header("Airport Map")
        .Height(500)
        .Layers(ls =>
        {
            ls.AddGeoMapLayer()
                .Url("/Content/data/land.json")
                .ColorScale(cs => cs.Scale("colorScale")
                                    .Binding("colorScaleBindingLand")
                                    .Colors(palette));

            ls.AddGeoMapLayer()
                .Url("/Content/data/europe.json");

            ls.AddGeoGridLayer();
        })
)

Back to Top