Vue Maps Component

The Vue Maps component 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

Trusted by the world's leading companies

Setup

Create a Vue Application

You can use Vue CLI to setup your Vue 2 applications. To install Vue CLI, use the following commands.

1npm install -g @vue/cli
2vue create quickstart
3cd quickstart
4npm run serve

Initiating a new project prompts us to choose the type of project to be used for the current application. Select the option Default ([Vue 2] babel, eslint) from the menu.

Add Syncfusion Maps package

All Syncfusion Vue packages are published in npmjs.com registry. To install Vue Maps package, use the following command.

1npm install @syncfusion/ej2-vue-maps --save

Register Maps Component

You can register the Maps component in your application by using the Vue.use(). Refer to the code example given below.

1import { MapsPlugin } from '@syncfusion/ej2-vue-maps';
2
3Vue.use(MapsPlugin);

Registering MapsPlugin in Vue, will register the Maps component along with its required child directives globally.

Add Maps Component

Add the Vue Maps by using ejs-maps selector in template section of the App.vue file.

1<template>
2    <div id="map">
3        <ejs-maps>
4            <e-layers>
5                <e-layer :shapeData='shapeData'></e-layer>
6            </e-layers>
7        </ejs-maps>
8    </div>
9</template>
10<script>
11import Vue from 'vue';
12import { MapsPlugin } from '@syncfusion/ej2-vue-maps';
13import { world_map } from './world-map.js';
14Vue.use(MapsPlugin);
15export default {
16  data() {
17    return {
18      shapeData: world_map
19    }
20  }
21}
22</script>

Refer the Getting Started with Vue3 topic for using Syncfusion Vue components in Vue 3 applications.

Supported frameworks

Maps component is also offered in the following list of frameworks.

JavaScript	Angular	React	ASP.NET Core	ASP.NET MVC

Showcase samples

• Heat map - Live Demo
• Flight routes - Live Demo
• Bus seat booking - Live Demo

Key features

• Data sources: Binds the maps control to an array of JSON objects containing GeoJSON data.
• Map providers: Online map providers such as OpenStreetMap, Bing Maps and others can also be rendered.
• Layer: Layer represents the area which renders the map. Also, any number of layers can be added.
• Projection: Maps can be rendered in eight different types of projections.
• Drill-down: Provides drill-down option to have a closer look at the lower level of a hierarchy.
• Marker: Provides support to mark a specific place of interest in the map.
• Data label: Provides additional information about the shapes in the form of text over the shapes.
• Bubble: Represents visually the underlying data values of the shapes.
• Navigation line: Denotes the path between two locations.
• Color mapping: 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: Summarizes the information from the layers, markers and bubbles.
• Annotation: Uses any custom HTML element as annotation and place it anywhere on the maps.
• Selection and highlight: Supports selecting or highlighting shapes to bring center of attraction.
• Zooming and panning: Allows to zoom in, zoom out, and pan the map to show in-depth information.
• Tooltip: Provides additonal information about the shapes on hover.
• Print and Export: Prints or exports the rendered maps to a desired format. Exporting supports four formats: PDF, PNG, JPEG and SVG.
• Templates: Templates can be used to create custom user experiences in the Maps.
• Globalization: Personalize the Maps component with different languages, as well as culture-specific number, date and time formatting.
• Accessibility: Provides with built-in accessibility support which helps to access all the Maps component features through the keyboard, screen readers, or other assistive technology devices.

Support

Product support is available through the following mediums.

• Support ticket - Guaranteed Response in 24 hours | Unlimited tickets | Holiday support
• Community forum
• GitHub issues
• Request feature or report bug
• Live chat

Changelog

Check the changelog here. 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^® licensed software, including this component, is subject to the terms and conditions of Syncfusion^® EULA. To acquire a license for 80+ Vue UI components, you can purchase or start a free 30-day trial.

A free community license 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 for more info.

© Copyright 2025 Syncfusion^® Inc. All Rights Reserved. The Syncfusion^® Essential Studio^® license and copyright applies to this distribution.