# @syncfusion/ej2-maps > The Maps component is used to visualize the geographical data and represent the statistical data of a particular geographical area on earth with user interactivity, and provides various customizing options Latest version **34.2.8** (published 2026-09-15) · SEE LICENSE IN license license · 0 weekly downloads ## Install ```sh npm install @syncfusion/ej2-maps pnpm add @syncfusion/ej2-maps yarn add @syncfusion/ej2-maps bun add @syncfusion/ej2-maps ``` ## Health **Score 55/100 (C)** — status: active. Positive: no vulnerabilities; recently updated; high maintenance score. Warnings: low downloads; no types; no esm support. ## Facts | | | |---|---| | Version | 34.2.8 | | Published | 2026-09-15 | | First published | 2018-02-22 | | Weekly downloads | 0 | | License | SEE LICENSE IN license | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 0 | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 448 | | Author | Syncfusion Inc. | | Maintainers | syncfusionorg, essentialjs2, syncfusion-javascript | | Keywords | ej2, syncfusion, web-components, ej2-maps, javascript, typescript, maps, geoJSON, shapes, custom-shapes, OSM, openstreetmap, bing maps, azure maps, google maps, projection, layer, sublayer, bubble, color-mapping, marker, cluster, data-label, navigation-line, zoom, pan, point, multipoint, linestring, multilinestring, polygon, multipolygon, geometry-collection, feature-collection | ## Links - npm: https://www.npmjs.com/package/@syncfusion/ej2-maps - Repository: https://github.com/syncfusion/ej2-javascript-ui-controls - Homepage: https://www.syncfusion.com/javascript-ui-controls - Issues: https://github.com/syncfusion/ej2-javascript-ui-controls/issues - npm.io page: https://npm.io/package/@syncfusion/ej2-maps ## Alternatives - [@mapbox/jsonlint-lines-primitives](https://npm.io/package/@mapbox/jsonlint-lines-primitives.md) — 5.3M weekly downloads - [reftools](https://npm.io/package/reftools.md) — 3.5M weekly downloads - [@hey-api/openapi-ts](https://npm.io/package/@hey-api/openapi-ts.md) — 3.5M weekly downloads - [@mapbox/geojson-rewind](https://npm.io/package/@mapbox/geojson-rewind.md) — 2.4M weekly downloads - [turbo-stream](https://npm.io/package/turbo-stream.md) — 1.7M weekly downloads ## Recent versions - 34.2.8 (latest) — 2026-09-15 - 34.2.6 — 2026-09-01 - 34.2.5 — 2026-08-25 - 34.2.4 — 2026-08-18 - 34.2.2 — 2026-08-05 - 34.1.33 — 2026-07-28 - 34.1.29 — 2026-07-06 - 33.2.3 — 2026-04-21 - 33.1.44 — 2026-03-16 - 32.2.4 — 2026-02-11 - 32.2.3 — 2026-02-05 - 32.1.24 — 2026-01-20 - 32.1.21 — 2025-12-30 - 32.1.19 — 2025-12-16 - 31.2.12 — 2025-11-18 - … 184 more at https://npm.io/package/@syncfusion/ej2-maps/versions ## README # JavaScript Maps Control The [JavaScript Maps](https://www.syncfusion.com/javascript-ui-controls/js-maps-library?utm_source=npm&utm_medium=listing&utm_campaign=javascript-map-npm) control is used to visualize geographical data and represent statistical data of a specific geographical area on earth with user interactivity, and it provides a wide range of customization options.

Getting started . Online demos . Learn more

JavaScript Maps Control

Trusted by the world's leading companies Bootstrap logo

> **Using this package with an AI coding agent** > > Before generating Syncfusion code, ask your AI coding agent to run the Syncfusion setup using the following prompt: > > ```text > Set up this project for Syncfusion before generating code. Fetch > and follow the official instructions at https://ai.syncfusion.com, > then report the detected platform, installed skill pack, MCP > status, and any required licensing action. > ``` > The setup detects your project’s platform and loads the appropriate Syncfusion skill pack. No Syncfusion account or MCP key is required to install or read Syncfusion agent skills. > > **Platform reference:** [https://ai.syncfusion.com/javascript/llms.txt](https://ai.syncfusion.com/javascript/llms.txt) ## Setup To install the Maps and its dependent packages, use the following command. ```sh npm install @syncfusion/ej2-maps ``` ## Supported frameworks Maps control is also offered in the following list of frameworks. | [](https://www.syncfusion.com/angular-ui-components?utm_medium=listing&utm_source=github)
     [Angular](https://www.syncfusion.com/angular-ui-components?utm_medium=listing&utm_source=github)     | [](https://www.syncfusion.com/react-ui-components?utm_medium=listing&utm_source=github)
       [React](https://www.syncfusion.com/react-ui-components?utm_medium=listing&utm_source=github)       | [](https://www.syncfusion.com/vue-ui-components?utm_medium=listing&utm_source=github)
       [Vue](https://www.syncfusion.com/vue-ui-components?utm_medium=listing&utm_source=github)          | [](https://www.syncfusion.com/aspnet-core-ui-controls?utm_medium=listing&utm_source=github)
  [ASP.NET Core](https://www.syncfusion.com/aspnet-core-ui-controls?utm_medium=listing&utm_source=github)   | [](https://www.syncfusion.com/aspnet-mvc-ui-controls?utm_medium=listing&utm_source=github)
  [ASP.NET MVC](https://www.syncfusion.com/aspnet-mvc-ui-controls?utm_medium=listing&utm_source=github)   | | :-----: | :-----: | :-----: | :-----: | :-----: | ## Showcase samples * Heat map - [Live Demo](https://ej2.syncfusion.com/demos/?utm_source=npm&utm_campaign=javascript-map-npm#/material/maps/heat-map.html) * Flight routes - [Live Demo](https://ej2.syncfusion.com/demos/?utm_source=npm&utm_campaign=javascript-map-npm#/material/maps/curved-lines.html) * Bus seat booking - [Live Demo](https://ej2.syncfusion.com/demos/?utm_source=npm&utm_campaign=javascript-map-npm#/material/maps/seat-selection.html) ## Key features * [Data sources](https://ej2.syncfusion.com/documentation/maps/populate-data/?utm_source=npm&utm_campaign=javascript-map-npm): Binds the maps control to an array of JSON objects containing GeoJSON data. * [Map providers](https://ej2.syncfusion.com/documentation/maps/providers/other-maps/?utm_source=npm&utm_campaign=javascript-map-npm): Online map providers such as OpenStreetMap, Bing Maps and others can also be rendered. * [Layer](https://ej2.syncfusion.com/documentation/maps/layers/?utm_source=npm&utm_campaign=javascript-map-npm): Layer represents the area which renders the map. Also, any number of layers can be added. * [Projection](https://ej2.syncfusion.com/demos/?utm_source=npm&utm_campaign=javascript-map-npm#/material/maps/projection.html): Maps can be rendered in eight different types of projections. * [Drill-down](https://ej2.syncfusion.com/demos/?utm_source=npm&utm_campaign=javascript-map-npm#/material/maps/drilldown.html): Provides drill-down option to have a closer look at the lower level of a hierarchy. * [Marker](https://ej2.syncfusion.com/documentation/maps/markers/?utm_source=npm&utm_campaign=javascript-map-npm): Provides support to mark a specific place of interest in the map. * [Data label](https://ej2.syncfusion.com/documentation/maps/data-label/?utm_source=npm&utm_campaign=javascript-map-npm): Provides additional information about the shapes in the form of text over the shapes. * [Bubble](https://ej2.syncfusion.com/documentation/maps/bubble/?utm_source=npm&utm_campaign=javascript-map-npm): Represents visually the underlying data values of the shapes. * [Navigation line](https://ej2.syncfusion.com/documentation/maps/navigation-line/?utm_source=npm&utm_campaign=javascript-map-npm): Denotes the path between two locations. * [Color mapping](https://ej2.syncfusion.com/documentation/maps/color-mapping/?utm_source=npm&utm_campaign=javascript-map-npm): Applies colors to the shapes based on various conditions. Maps supports three types of color mapping: range color mapping, equal color mapping and desaturation color mapping. * [Legend](https://ej2.syncfusion.com/documentation/maps/legend/?utm_source=npm&utm_campaign=javascript-map-npm): Summarizes the information from the layers, markers and bubbles. * [Annotation](https://ej2.syncfusion.com/documentation/maps/annotations/?utm_source=npm&utm_campaign=javascript-map-npm): Uses any custom HTML element as annotation and place it anywhere on the maps. * [Selection and highlight](https://ej2.syncfusion.com/documentation/maps/user-interactions/?utm_source=npm&utm_campaign=javascript-map-npm#selection): Supports selecting or highlighting shapes to bring center of attraction. * [Zooming and panning](https://ej2.syncfusion.com/documentation/maps/user-interactions/?utm_source=npm&utm_campaign=javascript-map-npm#zooming): Allows to zoom in, zoom out, and pan the map to show in-depth information. * [Tooltip](https://ej2.syncfusion.com/documentation/maps/user-interactions/?utm_source=npm&utm_campaign=javascript-map-npm#tooltip): Provides additonal information about the shapes on hover. * [Print and Export](https://ej2.syncfusion.com/documentation/maps/print/?utm_source=npm&utm_campaign=javascript-map-npm): Prints or exports the rendered maps to a desired format. Exporting supports four formats: PDF, PNG, JPEG and SVG. * [Templates](https://ej2.syncfusion.com/demos/?utm_source=npm&utm_campaign=javascript-map-npm#/material/maps/marker-template.html): Templates can be used to create custom user experiences in the Maps. * [Globalization](https://ej2.syncfusion.com/documentation/maps/internationalization/?utm_source=npm&utm_campaign=javascript-map-npm): Personalize the Maps control with different languages, as well as culture-specific number, date and time formatting. * [Accessibility](https://ej2.syncfusion.com/documentation/maps/accessibility/?utm_source=npm&utm_campaign=javascript-map-npm): Provides with built-in accessibility support which helps to access all the Maps control features through the keyboard, screen readers, or other assistive technology devices. ## Resources * [Documentation](https://ej2.syncfusion.com/documentation/maps/getting-started) * [Theme Studio](https://ej2.syncfusion.com/themestudio/) * [Custom Resource Generator](https://crg.syncfusion.com/) * [What's New](https://www.syncfusion.com/products/whatsnew/essential-js2?utm_medium=listing&utm_source=github) * [Road Map](https://www.syncfusion.com/products/roadmap/essential-js2?utm_medium=listing&utm_source=github) * [E-Books](https://www.syncfusion.com/ebooks?tag=javascript&utm_medium=listing&utm_source=github) ## Support Product support is available through the following mediums. * [Support ticket](https://support.syncfusion.com/support/tickets/create) - Guaranteed Response in 24 hours | Unlimited tickets | Holiday support * [Community forum](https://www.syncfusion.com/forums/essential-js2?utm_source=npm&utm_medium=listing&utm_campaign=javascript-map-npm) * [GitHub issues](https://github.com/syncfusion/ej2-javascript-ui-controls/issues/new) * [Request feature or report bug](https://www.syncfusion.com/feedback/javascript?utm_source=npm&utm_medium=listing&utm_campaign=javascript-map-npm) * Live chat ## Changelog Check the changelog [here](https://github.com/syncfusion/ej2-javascript-ui-controls/blob/master/controls/maps/CHANGELOG.md?utm_source=npm&utm_campaign=javascript-map-npm). Get minor improvements and bug fixes every week to stay up to date with frequent updates. ## License and copyright > This is a commercial product and requires a paid license for possession or use. Syncfusion’s licensed software, including this control, is subject to the terms and conditions of Syncfusion's [EULA](https://www.syncfusion.com/eula/es/). To acquire a license for 140+ [JavaScript UI controls](https://www.syncfusion.com/javascript-ui-controls), you can [purchase](https://www.syncfusion.com/sales/products) or [start a free 30-day trial](https://www.syncfusion.com/account/manage-trials/start-trials). > A free community [license](https://www.syncfusion.com/products/communitylicense) is also available for companies and individuals whose organizations have less than $1 million USD in annual gross revenue and five or fewer developers. See [LICENSE FILE](https://github.com/syncfusion/ej2-javascript-ui-controls/blob/master/controls/maps/license?utm_source=npm&utm_campaign=javascript-map-npm) for more info. © Copyright 2026 Syncfusion® Inc. All Rights Reserved. The Syncfusion® Essential Studio® license and copyright applies to this distribution. --- _Source: https://npm.io/package/@syncfusion/ej2-maps · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._