We use cookies to give you the best experience on our website. If you continue to browse, then you agree to our privacy policy and cookie policy. Image for the cookie policy date
Unfortunately, activation email could not send to your email. Please try again.
Syncfusion Feedback

Trusted by the world’s leading companies

Syncfusion Trusted Companies


The JavaScript Maps control is ideal for rendering Maps from GeoJSON data or other map providers like OpenStreetMap, Google Maps, and Bing Maps. Its rich feature set includes markers, labels, bubbles, navigation lines, legends, tooltips, zooming, panning, drill down, and more.

Why choose the Syncfusion JavaScript Maps library?

JavaScript Maps customization.

Easy to customize

To visualize a geometric shape in SVG format in Maps, you bind GeoJSON data to it. GeoJSON data is light and simple to read. You can render a world map or a U.S. map and alter it with the JavaScript Maps control’s built-in options to achieve the required layout.

JavaScript Maps geospatial imaging.

Geospatial imaging services

Work with services like Google Maps, Bing Maps, and OpenStreetMap to view satellite, aerial, and street maps by locating map data quickly without the use of any external shape inputs.

JavaScript Maps markers and bubbles.

Markers and bubbles

Markers are notes on maps that indicate specific latitude and longitude points using symbols. Bubbles are used to convey additional information about shapes such as population density or land area. Circle and square bubbles are available.

JavaScript Maps multiple layers.

Multiple geometric layers

A map with several geometric layers in a single view can be generated with sublayers. You can render the geographic elements of a country, such as rivers and valleys, as a sublayer. Each layer can be drilled.

JavaScript Maps adaptive layout.

Adapts to any resolution

Maps has a highly responsive layout and an optimized design for desktops, tablets, and phones. It works well on all mobile phones that use iOS, Android, or Windows OS.

JavaScript Maps projections.

Custom projections

The JavaScript Maps component supports Mercator, rectangular, Miller, Eckert 3, Eckert 5, Eckert 6, and Winkel 3 projections.

JavaScript Maps zooming.

Zooming and panning

Zooming and panning in JavaScript Maps are fast. Zoom the map by scrolling the mouse wheel, clicking the shapes, or using the zooming toolbar. Pan the map to navigate among regions easily.

JavaScript Maps globalization.

Globalization and localization

An internationalization library is used to globalize number, date, and time values in Maps. All the strings used in the Maps user interface can be localized by users as needed. Localizing UI strings involves using the localization (l10n) library.

JavaScript Maps code example

Easily get started with the JavaScript Maps library using a few simple lines of HTML and TS code, as demonstrated in the following. Also explore our JavaScript Maps library example, which shows you how to render maps.

<!DOCTYPE html>
<html lang="en">
    <title>Essential JS 2</title>
    <script src="node_modules/systemjs/dist/system.src.js" type="text/javascript"></script>
    <script src="system.config.js" type="text/javascript"></script>
    <div id="container"></div>
import { world_map } from './world_map';
import { Maps } from '@syncfusion/ej2-maps';

let map: Maps = new Maps({
  layers: [
      shapeData: world_map,
      dataSource: [
        { Country: 'United States', Membership: 'Permanent', Color: '#feb24c' },
        { Country: 'United Kingdom', Membership: 'Permanent', Color: '#feb24c' },
        { Country: 'Russia', Membership: 'Permanent', Color: '#feb24c' },
        { Country: 'France', Membership: 'Permanent', Color: '#feb24c' },
        { Country: 'China', Membership: 'Permanent', Color: '#feb24c' },
        { Country: 'Albania', Membership: 'Non-permanent', Color: '#f03b20' },
        { Country: 'Brazil', Membership: 'Non-permanent', Color: '#f03b20' },
        { Country: 'Gabon', Membership: 'Non-permanent', Color: '#f03b20' },
        { Country: 'Ghana', Membership: 'Non-permanent', Color: '#f03b20' },
        { Country: 'India', Membership: 'Non-permanent', Color: '#f03b20' },
        { Country: 'Ireland', Membership: 'Non-permanent', Color: '#f03b20' },
        { Country: 'Kenya', Membership: 'Non-permanent', Color: '#f03b20' },
        { Country: 'Mexico', Membership: 'Non-permanent', Color: '#f03b20' },
        { Country: 'Norway', Membership: 'Non-permanent', Color: '#f03b20' },
        { Country: 'United Arab Emirates', Membership: 'Non-permanent', Color: '#f03b20' }],
      shapePropertyPath: 'name',
      shapeDataPath: 'Country',
      shapeSettings: {
        fill: '#E5E5E5',
        colorValuePath: 'Color',


GeoJSON layer

Bind GeoJSON data to the maps to render any geometric shape in SVG (scalable vector graphics) format to visualize data. For example, render a world map or U.S. map and customize it to the desired look using built-in options. Add any number of layers to the maps.

Binding GeoJSON data in JavaScript Maps library.

JavaScript Maps rendered with geometric types over OSM map.

Geometric types

GeoJSON data contains geometric objects with properties such as geometry types and coordinates. The geometric types are the values present in the geometric objects of the GeoJSON data that specify the type of shape to be rendered, along with the coordinates that help to draw the shape’s boundary line. Polygon, MultiPolygon, LineString, MultiLineString, Point, MultiPoint, and GeometryCollection are the supported geometric types.

Geo-imagery visuals

Built-in support for external geospatial imagery services, such as Bing Maps and OpenStreetMap, is used to visualize satellite, aerial, and street maps, or other kinds of imagery tiles without any external shape inputs. Users can render maps from various map providers like Google Maps Tile API, TomTom, Mapbox, and Esri’s ArcGIS. By using these external services, map data can be located easily.

JavaScript Maps library geo imagery visuals.

JavaScript Maps with multiple layers.

Multiple layers

Using sublayers, a map can be created with multiple geometric layers in a single view. For example, render additional geographic features of a country such as rivers and valleys as sublayers. You can also drill each layer.


Denote a place with symbols or make a note at a desired latitude and longitude on a map using markers. For example, indicate a particular place on the U.S. map using a balloon marker shape. You can place any HTML element as a marker and add multiple markers to the map.

JavaScript Maps with multiple markers.

JavaScript Maps is rendered with a marker clustering option.

Marker clustering

Display multiple markers in the same location by clustering them. For example, use markers to indicate the top 50 cities in the world. If one marker overlaps another, they will be clustered, and the total number of markers will be displayed over the cluster.

Marker drag and drop

You can drag and drop markers to reposition them in a map. After dragging and dropping markers, the marker data source and elements such as marker shape, color, legend, and tooltip content can be changed using supported events.

JavaScript Maps with marker drag and drop option.

JavaScript Maps is rendered with polygon.


Polygons can be displayed over a shape layer or an online map to highlight a specific region.

Data labels

Data labels on a map provide identification for shapes by displaying their names. Trim or hide the labels at intersections with other labels and when they exceed shape bounds.

JavaScript Maps with data labels.

JavaScript Maps rendered with multiple bubbles.


Use bubbles to represent additional information about shapes in a map such as population density or land area. Bubbles are rendered with various magnitudes and colors based on their underlying data values.

Denote flight routes or ship routes between two places on a geographic map with connector lines. The lines can be straight or curved.

JavaScript Maps rendered with navigation lines.

Color mapping

Categorize the shapes on a map by customizing their colors based on the underlying values. The JavaScript Maps control supports three types of color mapping: range color mapping, equal color mapping, and desaturation color mapping.

Range color mapping is applied for the shapes in JavaScript Maps.

Range color mapping

Apply colors to the shapes by comparing their values with a desired numeric range. For example, apply colors to the states in the U.S. based on population density.

Equal color mapping is applied to the shapes in JavaScript Maps.

Equal color mapping

Differentiate a shape’s fill based on its underlying values and colors using equal color mapping. For example, apply colors to states in a U.S. map based on a winning political candidate.

Desaturation color mapping is applied to the shapes in JavaScript Maps.

Desaturation color mapping

Change the opacity of the shapes by comparing their values with a desired numeric range. Minimum and maximum opacity of the shapes can be customized.

Desaturation color mapping with multiple colors is applied to the shapes in JavaScript Maps.

Desaturation with multiple colors

Apply multiple colors to a shape from a gradient by comparing values with a desired numeric range. Any number of colors can be specified for creating the gradient.


Legends provide valuable information for interpreting a map by explaining colors, shapes, and other identifiers based on the data visualized. The JavaScript Maps library supports two types of legends: default and interactive.

JavaScript Maps rendered with default legend items.


A map with a legend contains swatches of symbols with descriptions to denote the categories of shapes.

JavaScript Maps rendered with interactive legend.


Use a map with an interactive legend to find the range of a shape’s underlying value on mouse hover.

Zooming and panning

Zoom JavaScript Maps for close-up analysis by pinching the map, scrolling the mouse wheel, clicking the shapes, or using the zooming toolbar. Pan the map for easy navigation across regions. Users can also change the zoom level of the initial rendering.

Zooming and panning enabled in JavaScript Maps.

Displays a tooltip on moving mouse over JavaScript Maps.


The tooltip displays details about the shape value on mouse hover. Tooltips are also displayed for markers and bubbles on a map.

Drill down

Drill down in the rendered JavaScript Maps to display shape data located on another layer. For example, the initial layer may render the world map and on clicking a particular continent, the continent alone will render separately on another layer.

JavaScript Maps is rendered with multiple layers and enabled drill-down option.

Particular shape is selected in the rendered JavaScript Maps.

Selection and highlight

Select a particular shape on mouse click or highlight on mouse hover to bring the focus to shapes on a map.

Custom shapes

Create a JavaScript map with custom shapes by rendering customized GeoJSON data to indicate building infrastructure, points of interest, flight seat arrangement, sports stadiums, and more.

Bus seat selection is simulated in JavaScript Maps.

JavaScript Maps is rendered with annotations that display a compass image.


Display any HTML element as an annotation at a specific point of interest on a map. For example, place a compass image on the map using an annotation. Add multiple annotations to a map.


Change the projection of the default rendered map. The HTML5 JavaScript Maps control supports various types of projections: Mercator, Equirectangular, Miller, Eckert 3, Eckert 5, Eckert 6, Winkel 3, and Aitoff.

JavaScript Maps is rendered with title and subtitle.

Title and subtitle

Add a title and subtitle to visualize additional information on a map. Fonts and alignment used in the title and subtitle can also be customized.


Customize the look and feel of a JavaScript map by changing the fill color, background, border, and opacity of shapes. Almost all the elements in JavaScript Maps are customizable. The control also provides built-in palettes with customizable options by default.

JavaScript Maps is rendered with customized appearance.

State persistence with JavaScript Maps library.

State persistence

State persistence allows the Maps component to maintain state by storing the most recent model value in browser cookies. When the appropriate setting is enabled, some of the Maps component model values are preserved even after the page is refreshed.


Export or print the rendered JavaScript Maps to save a local copy for further use.

Export JavaScript Maps illustration.


Export the JavaScript Maps control to a PDF document or in image formats such as SVG, PNG, and JPEG on the client side.

Print JavaScript Maps illustration.


Print the rendered JavaScript Maps directly from the browser.


Keyboard navigation in JavaScript Maps library.

Keyboard navigation

The JavaScript Maps library ensures that every element is keyboard accessible. Major features like zooming, panning, shape selection, and drill down can be performed using just keyboard shortcuts, no mouse interaction required. This helps in creating highly accessible applications.

Accessibility in JavaScript Maps library.


The JavaScript Maps library has complete WAI-ARIA accessibility support. The Maps UI includes high-contrast visual elements that help visually impaired people have the best viewing experience. Also, valid UI descriptions are easily accessible through assistive technologies such as screen readers.

Other supported frameworks

The Maps component is also available in our Blazor, Angular, React, and Vue frameworks. Check out the Maps control on different platforms from the following links:

Supported browsers

The JavaScript Maps library works well with all modern web browsers, including Chrome, Firefox, Microsoft Edge, Safari, and Opera.

Supported browsers in JavaScript Maps library.


Frequently Asked Questions

The JavaScript Maps component offers the following:

  • Geometric or custom shapes are rendered using GeoJSON data.
  • Maps from map providers like Bing Maps, OpenStreetMap, and Google Maps can be rendered.
  • Markers highlight specified latitudes and longitudes on maps.
  • Fast zooming and panning performance and elegant animation.
  • Simple configuration and API.
  • Support for all modern browsers.
  • Touch-friendly and responsive UI.
  • Expansive learning resources such as demos, documentation, and videos help you learn quickly and get started fast.

You can find our JavaScript Maps library demo, which demonstrates how to render and configure the Maps component.

No, this is a commercial product and requires a paid license. However, a free community license is also available for companies and individuals whose organizations have less than $1 million USD in annual gross revenue, 5 or fewer developers, and 10 or fewer total employees.

A good place to start would be our comprehensive getting started documentation.

Our Customers Love Us

Having an excellent set of tools and a great support team, Syncfusion reduces customers’ development time.
Here are some of their experiences.

Rated by users across the globe

Transform your applications today by downloading our free evaluation version
Download Free Trial No credit card required.


Greatness—it’s one thing to say you have it, but it means more when others recognize it. Syncfusion is proud to hold the following industry awards.

Up arrow icon
Live Chat Icon For mobile