React Vector Map - Zooming and Centering

This demo shows the VectorMap zooming and centering capabilities. The map contains several cities represented by dot markers. To identify a city, pause on its marker, and the name of the city will appear in a tooltip. Moreover, if you click the marker, the map will be zoomed and centered on it. In code it is performed by calling the center(centerCoordinates) and zoomFactor(zoomFactor) methods. A click on the «Reset» button restores default center coordinates and zoom factor.

TS JS

Backend API

import React, { useCallback, useRef } from 'react'; import VectorMap, { Layer, Tooltip, } from 'devextreme-react/vector-map'; import type { VectorMapTypes, ITooltipProps, VectorMapRef } from 'devextreme-react/vector-map'; import Button from 'devextreme-react/button'; import * as mapsData from 'devextreme-dist/js/vectormap-data/world.js'; import { markers } from './data.ts'; const bounds = [-180, 85, 180, -60]; const customizeTooltip: ITooltipProps['customizeTooltip'] = (arg) => { if (arg.layer.type === 'marker') { return { text: arg.attribute('name') }; } return {}; }; const markerClick = (e: VectorMapTypes.ClickEvent) => { if (e.target?.layer.type === 'marker') { e.component.center(e.target.coordinates()); e.component.zoomFactor(10); } }; const App = () => { const vectorMapRef = useRef<VectorMapRef>(null); const reset = useCallback(() => { vectorMapRef.current?.instance().center([0, 0]); vectorMapRef.current?.instance().zoomFactor(1); }, []); return ( <> <VectorMap ref={vectorMapRef} id="vector-map" onClick={markerClick} bounds={bounds} > <Layer dataSource={mapsData.world} hoverEnabled={false} /> <Layer dataSource={markers} /> <Tooltip enabled={true} customizeTooltip={customizeTooltip} /> </VectorMap> <Button text="Reset" id="reset" onClick={reset} /> </> ); }; export default App;

import React, { useCallback, useRef } from 'react'; import VectorMap, { Layer, Tooltip } from 'devextreme-react/vector-map'; import Button from 'devextreme-react/button'; import * as mapsData from 'devextreme-dist/js/vectormap-data/world.js'; import { markers } from './data.js'; const bounds = [-180, 85, 180, -60]; const customizeTooltip = (arg) => { if (arg.layer.type === 'marker') { return { text: arg.attribute('name') }; } return {}; }; const markerClick = (e) => { if (e.target?.layer.type === 'marker') { e.component.center(e.target.coordinates()); e.component.zoomFactor(10); } }; const App = () => { const vectorMapRef = useRef(null); const reset = useCallback(() => { vectorMapRef.current?.instance().center([0, 0]); vectorMapRef.current?.instance().zoomFactor(1); }, []); return ( <> <VectorMap ref={vectorMapRef} id="vector-map" onClick={markerClick} bounds={bounds} > <Layer dataSource={mapsData.world} hoverEnabled={false} /> <Layer dataSource={markers} /> <Tooltip enabled={true} customizeTooltip={customizeTooltip} /> </VectorMap> <Button text="Reset" id="reset" onClick={reset} /> </> ); }; export default App;

import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render( <App />, document.getElementById('app'), );

export const markers = [ { coordinates: [-0.1262, 51.5002], attributes: { name: 'London', }, }, { coordinates: [149.1286, -35.2820], attributes: { name: 'Canberra', }, }, { coordinates: [139.6823, 35.6785], attributes: { name: 'Tokyo', }, }, { coordinates: [-77.0241, 38.8921], attributes: { name: 'Washington', }, }, { coordinates: [-75.6794, 45.4214], attributes: { name: 'Ottawa', }, }, { coordinates: [37.617778, 55.751667], attributes: { name: 'Moscow', }, }, { coordinates: [116.4, 39.933333], attributes: { name: 'Beijing', }, }, { coordinates: [12.5, 41.9], attributes: { name: 'Rome', }, }, { coordinates: [23.716667, 38], attributes: { name: 'Athens', }, }, { coordinates: [2.333333, 48.833333], attributes: { name: 'Paris', }, }, { coordinates: [-3.683333, 40.4], attributes: { name: 'Madrid', }, }, { coordinates: [-47.866667, -15.798889], attributes: { name: 'Brasilia', }, }, ];

declare module 'devextreme-dist/js/vectormap-data/world.js' { type Position = number[]; type Geometry = | { type: 'Point'; coordinates: Position } | { type: 'MultiPoint'; coordinates: Position[] } | { type: 'LineString'; coordinates: Position[] } | { type: 'MultiLineString'; coordinates: Position[][] } | { type: 'Polygon'; coordinates: Position[][] } | { type: 'MultiPolygon'; coordinates: Position[][][] }; interface Feature { type: 'Feature'; geometry: Geometry; properties: Record<string, unknown>; } interface FeatureCollection { type: 'FeatureCollection'; features: Feature[]; // eslint-disable-next-line spellcheck/spell-checker bbox?: number[]; } const world: FeatureCollection; export { world }; export default world; }

import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));

export const markers = [ { coordinates: [-0.1262, 51.5002], attributes: { name: 'London', }, }, { coordinates: [149.1286, -35.282], attributes: { name: 'Canberra', }, }, { coordinates: [139.6823, 35.6785], attributes: { name: 'Tokyo', }, }, { coordinates: [-77.0241, 38.8921], attributes: { name: 'Washington', }, }, { coordinates: [-75.6794, 45.4214], attributes: { name: 'Ottawa', }, }, { coordinates: [37.617778, 55.751667], attributes: { name: 'Moscow', }, }, { coordinates: [116.4, 39.933333], attributes: { name: 'Beijing', }, }, { coordinates: [12.5, 41.9], attributes: { name: 'Rome', }, }, { coordinates: [23.716667, 38], attributes: { name: 'Athens', }, }, { coordinates: [2.333333, 48.833333], attributes: { name: 'Paris', }, }, { coordinates: [-3.683333, 40.4], attributes: { name: 'Madrid', }, }, { coordinates: [-47.866667, -15.798889], attributes: { name: 'Brasilia', }, }, ];

<!DOCTYPE html> <html lang="en"> <head> <title>DevExtreme Demo</title> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/26.1.5/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="./bundle.css" /> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"></div> </div> <script src="bundles/vendor/react.vendor.js"></script> <script src="./bundle.js"></script> </body> </html>

#vector-map { height: 420px; } #reset { margin: 10px 2px; }