Web Components Map Overview

    The Ignite UI for Web Components map component allows you to display data that contains geographic locations from view models or geo-spatial data loaded from shape files on geographic imagery maps.

    Web Components Map Example

    The following sample demonstrates how display data in IgcGeographicMapComponent using IgcGeographicProportionalSymbolSeriesComponent also known as Bubble Series.

    The map component allows you to render geographic imagery from Bing Maps™, and Open Street Maps. The map provides plotting of tens of thousands of data points, and updates them every few milliseconds so that the control can handle your real-time feeds.

    The map's Series property is used to support rendering an unlimited number of geographic series. This property is a collection of geographic series objects and any type of geographic series can be added to it. For example, IgcGeographicSymbolSeriesComponent can be added for plotting geographic locations such as cities and the IgcGeographicPolylineSeriesComponent for plotting connections (e.g. roads) between these geographic locations.

    The map provides customizable navigation behaviors for navigating map content using mouse, keyboard, or code-behind.

    Dependencies

    The Web Components geographic map component, you need to first install these packages:

    npm install --save igniteui-webcomponents-core
npm install --save igniteui-webcomponents-charts
npm install --save igniteui-webcomponents-maps

    Component Modules

    The IgcGeographicMapComponent requires the following modules, however the DataChartInteractivityModule is only required for mouse interactions, such as panning and zooming the map content.

    import { IgcGeographicMapModule } from 'igniteui-webcomponents-maps';
import { IgcGeographicMap } from 'igniteui-webcomponents-maps';
import { IgcDataChartInteractivityModule } from 'igniteui-webcomponents-charts';

IgcGeographicMapModule.register();
IgcDataChartInteractivityModule.register();

    import { ModuleManager } from 'igniteui-webcomponents-core';
import { IgcGeographicMapModule } from 'igniteui-webcomponents-maps';
import { IgcDataChartInteractivityModule } from 'igniteui-webcomponents-charts';

ModuleManager.register(
    IgcDataChartInteractivityModule,
    IgcGeographicMapModule
);

    Usage

    Now that the map module is imported, next step is to create geographic map. The following code demonstrates how to do this and enable zooming in the map.

    <igc-geographic-map id="geoMap" width="100%" height="100%">

</igc-geographic-map>

    Additional Resources

    You can find more information about related Web Components map features in these topics:

    API References

    The following is a list of API members mentioned in the above sections: