Print and Export in React Maps component

05 Oct 2022 / 5 minutes to read

Print

The rendered Maps can be printed directly from the browser by calling the print method. To use the print functionality, the Print module must be injected into the Maps using Inject services={[]} tag and set the allowPrint property to true.

<MapsComponent id="maps">
    <Inject services={[Print]}/>
<MapsComponent>

Source

Preview

index.jsx

index.tsx

import { world_map } from 'world-map.ts';
import * as React from "react";
import * as ReactDOM from "react-dom";
import { ButtonComponent } from '@syncfusion/ej2-react-buttons';
import { MapsComponent, LayersDirective, LayerDirective, Inject, Print, DataLabel } from '@syncfusion/ej2-react-maps';
class App extends React.Component {
    clickHandler() {
        this.maps.print();
    }
    render() {
        return (<div>
        <ButtonComponent value='export' onClick={this.clickHandler.bind(this)}>print</ButtonComponent>
            <MapsComponent id="maps" allowPrint={true} ref={g => this.maps = g}>
                <Inject services={[DataLabel, Print]}/>
                <LayersDirective>
                    <LayerDirective shapeData={world_map} dataLabelSettings={{
            visible: true,
            labelPath: 'name',
            smartLabelMode: 'Trim'
        }}>
                    </LayerDirective>
                </LayersDirective>
            </MapsComponent></div>);
    }
}
;
ReactDOM.render(<App />, document.getElementById('maps'));

import { world_map } from 'world-map.ts';
import * as React from "react";
import * as ReactDOM from "react-dom";
import { ButtonComponent } from '@syncfusion/ej2-react-buttons';
import { MapsComponent, LayersDirective, LayerDirective, Inject, Print, DataLabel } from '@syncfusion/ej2-react-maps';
class App extends React.Component<{}, {}>{
    private maps: MapsComponent;
    public clickHandler(){
        this.maps.print();
    }
render(){
        return (<div>
        <ButtonComponent value='export' onClick= { this.clickHandler.bind(this)}>print</ButtonComponent>
            <MapsComponent id="maps" allowPrint={true} ref={g => this.maps = g}>
                <Inject services={[DataLabel, Print]} />
                <LayersDirective>
                    <LayerDirective shapeData={world_map}
                     dataLabelSettings={ {
                            visible: true,
                            labelPath: 'name',
                            smartLabelMode: 'Trim'
                        } }>
                    </LayerDirective>
                </LayersDirective>
            </MapsComponent></div>)
        }
};
ReactDOM.render(<App />, document.getElementById('maps'));

Export

Image Export

To use the image export functionality in Maps, ImageExport module must be injected into the Maps using Inject services={[ImageExport]} tag and set the allowImageExport property to true.

<MapsComponent id="maps">
    <Inject services={[ImageExport]}/>
<MapsComponent>

The rendered Maps can be exported as an image using the export method. This method requires two parameters: image type and file name. The Maps can be exported as an image in the following formats.

JPEG
PNG
SVG

Source

Preview

index.jsx

index.tsx

import { world_map } from 'world-map.ts';
import * as React from "react";
import * as ReactDOM from "react-dom";
import { ButtonComponent } from '@syncfusion/ej2-react-buttons';
import { MapsComponent, LayersDirective, LayerDirective, DataLabel, Inject, ImageExport } from '@syncfusion/ej2-react-maps';
class App extends React.Component {
    clickHandler() {
        this.maps.export('PNG', 'Maps');
    }
    render() {
        return (<div>
    <ButtonComponent value='export' onClick={this.clickHandler.bind(this)}>Export</ButtonComponent>
        <MapsComponent id="maps" allowImageExport={true} ref={g => this.maps = g}>
            <Inject services={[DataLabel, ImageExport]}/>
            <LayersDirective>
                <LayerDirective shapeData={world_map} dataLabelSettings={{
            visible: true,
            labelPath: 'name',
            smartLabelMode: 'Trim'
        }}>
                </LayerDirective>
            </LayersDirective>
        </MapsComponent></div>);
    }
}
;
ReactDOM.render(<App />, document.getElementById('maps'));

import { world_map } from 'world-map.ts';
import * as React from "react";
import * as ReactDOM from "react-dom";
import { ButtonComponent } from '@syncfusion/ej2-react-buttons';
import { MapsComponent, LayersDirective, LayerDirective, DataLabel, Inject, ImageExport } from '@syncfusion/ej2-react-maps';

class App extends React.Component<{}, {}>{
private maps: MapsComponent;
public clickHandler(){
    this.maps.export('PNG', 'Maps');
}
render(){
    return (<div>
    <ButtonComponent value='export' onClick= { this.clickHandler.bind(this)}>Export</ButtonComponent>
        <MapsComponent id="maps" allowImageExport={true} ref={g => this.maps = g}>
            <Inject services={[DataLabel, ImageExport]} />
            <LayersDirective>
                <LayerDirective shapeData={world_map}
                 dataLabelSettings={ {
                        visible: true,
                        labelPath: 'name',
                        smartLabelMode: 'Trim'
                    } }>
                </LayerDirective>
            </LayersDirective>
        </MapsComponent></div>)
    }
};
ReactDOM.render(<App />, document.getElementById('maps'));

Exporting Maps as base 64 string of the file

The image can be exported as base64 string for the JPEG and PNG formats. The rendered Maps can be exported to image as a base64 string using the export method. There are four parameters required: image type, file name, orientation of the exported PDF document which must be set as null for image export and finally allowDownload which should be set as false to return base64 string.

Source

Preview

index.jsx

index.tsx

import { world_map } from 'world-map.ts';
import * as React from "react";
import * as ReactDOM from "react-dom";
import { ButtonComponent } from '@syncfusion/ej2-react-buttons';
import { MapsComponent, LayersDirective, LayerDirective, DataLabel, Inject, ImageExport } from '@syncfusion/ej2-react-maps';
class App extends React.Component {
    clickHandler() {
        this.maps.export('PNG', 'Maps', null, false).then((data) => {
            document.getElementById('data').innerHTML = data;
        });
    }
    render() {
        return (<div>
    <ButtonComponent value='export' onClick={this.clickHandler.bind(this)}>Export</ButtonComponent>
        <MapsComponent id="maps" allowImageExport={true} ref={g => this.maps = g}>
            <Inject services={[DataLabel, ImageExport]}/>
            <LayersDirective>
                <LayerDirective shapeData={world_map} dataLabelSettings={{
            visible: true,
            labelPath: 'name',
            smartLabelMode: 'Trim'
        }}>
                </LayerDirective>
            </LayersDirective>
        </MapsComponent><div id="data"></div></div>);
    }
}
;
ReactDOM.render(<App />, document.getElementById('maps'));

import { world_map } from 'world-map.ts';
import * as React from "react";
import * as ReactDOM from "react-dom";
import { ButtonComponent } from '@syncfusion/ej2-react-buttons';
import { MapsComponent, LayersDirective, LayerDirective, DataLabel, Inject, ImageExport } from '@syncfusion/ej2-react-maps';

class App extends React.Component<{}, {}>{
private maps: MapsComponent;
public clickHandler(){
    this.maps.export('PNG', 'Maps', null, false).then((data: string)=>{
        document.getElementById('data').innerHTML = data;
    })
}
render(){
    return (<div>
    <ButtonComponent value='export' onClick= { this.clickHandler.bind(this)}>Export</ButtonComponent>
        <MapsComponent id="maps" allowImageExport={true} ref={g => this.maps = g}>
            <Inject services={[DataLabel, ImageExport]} />
            <LayersDirective>
                <LayerDirective shapeData={world_map}
                 dataLabelSettings={ {
                        visible: true,
                        labelPath: 'name',
                        smartLabelMode: 'Trim'
                    } }>
                </LayerDirective>
            </LayersDirective>
        </MapsComponent><div id="data"></div></div>)
    }
};
ReactDOM.render(<App />, document.getElementById('maps'));

PDF Export

To use the PDF export functionality, PdfExport module must be injected into the Maps using Inject services={[PdfExport]} method and set the allowPdfExport property to true.

<MapsComponent id="maps">
<Inject services={[PdfExport]}/>
<MapsComponent>

The rendered Maps can be exported as PDF using the export method. The export method requires three parameters: file type, file name and orientation of the PDF document. The orientation setting is optional and 0 indicates portrait and 1 indicates landscape.

Source

Preview

index.jsx

index.tsx

import { world_map } from 'world-map.ts';
import * as React from "react";
import * as ReactDOM from "react-dom";
import { ButtonComponent } from '@syncfusion/ej2-react-buttons';
import { MapsComponent, LayersDirective, LayerDirective, DataLabel, Inject, PdfExport } from '@syncfusion/ej2-react-maps';
class App extends React.Component {
    clickHandler() {
        this.maps.export('PDF', 'Maps');
    }
    render() {
        return (<div>
    <ButtonComponent value='export' onClick={this.clickHandler.bind(this)}>Export</ButtonComponent>
        <MapsComponent id="maps" allowPdfExport={true} ref={g => this.maps = g}>
            <Inject services={[DataLabel, PdfExport]}/>
            <LayersDirective>
                <LayerDirective shapeData={world_map} dataLabelSettings={{
            visible: true,
            labelPath: 'name',
            smartLabelMode: 'Trim'
        }}>
                </LayerDirective>
            </LayersDirective>
        </MapsComponent></div>);
    }
}
;
ReactDOM.render(<App />, document.getElementById('maps'));

import { world_map } from 'world-map.ts';
import * as React from "react";
import * as ReactDOM from "react-dom";
import { ButtonComponent } from '@syncfusion/ej2-react-buttons';
import { MapsComponent, LayersDirective, LayerDirective, DataLabel, Inject, PdfExport } from '@syncfusion/ej2-react-maps';

class App extends React.Component<{}, {}>{
private maps: MapsComponent;
public clickHandler(){
    this.maps.export('PDF', 'Maps');
}
render(){
    return (<div>
    <ButtonComponent value='export' onClick= { this.clickHandler.bind(this)}>Export</ButtonComponent>
        <MapsComponent id="maps" allowPdfExport={true} ref={g => this.maps = g}>
            <Inject services={[DataLabel, PdfExport]} />
            <LayersDirective>
                <LayerDirective shapeData={world_map}
                 dataLabelSettings={ {
                        visible: true,
                        labelPath: 'name',
                        smartLabelMode: 'Trim'
                    } }>
                </LayerDirective>
            </LayersDirective>
        </MapsComponent></div>)
    }
};
ReactDOM.render(<App />, document.getElementById('maps'));

The exporting of the Maps as base64 string is not supported for the PDF export.

Export the tile Maps

The rendered Maps with providers such as OSM, Bing and Google static Maps can be exported using the export method. It supports the following export formats.

JPEG
PNG
PDF

Source

Preview

index.jsx

index.tsx

import * as React from "react";
import * as ReactDOM from "react-dom";
import { ButtonComponent } from '@syncfusion/ej2-react-buttons';
import { MapsComponent, LayersDirective, LayerDirective, Inject, ImageExport } from '@syncfusion/ej2-react-maps';
class App extends React.Component {
    clickHandler() {
        this.maps.export('PNG', 'Maps');
    }
    render() {
        return (<div>
    <ButtonComponent value='export' onClick={this.clickHandler.bind(this)}>Export</ButtonComponent>
        <MapsComponent id="maps" allowImageExport={true} ref={g => this.maps = g} titleSettings={{ text: 'OSM' }}>
            <Inject services={[ImageExport]}/>
            <LayersDirective>
                <LayerDirective urlTemplate="https://tile.openstreetmap.org/level/tileX/tileY.png">
                </LayerDirective>
            </LayersDirective>
        </MapsComponent></div>);
    }
}
;
ReactDOM.render(<App />, document.getElementById('maps'));

import * as React from "react";
import * as ReactDOM from "react-dom";
import { ButtonComponent } from '@syncfusion/ej2-react-buttons';
import { MapsComponent, LayersDirective, LayerDirective, Inject, ImageExport } from '@syncfusion/ej2-react-maps';

class App extends React.Component<{}, {}>{
private maps: MapsComponent;
public clickHandler(){
    this.maps.export('PNG', 'Maps');
}
render() {
    return (<div>
    <ButtonComponent value='export' onClick= { this.clickHandler.bind(this)}>Export</ButtonComponent>
        <MapsComponent id="maps" allowImageExport={true}
                                 ref={g => this.maps = g}
                                 titleSettings={ { text: 'OSM' } }>
            <Inject services={[ImageExport]} />
            <LayersDirective>
                <LayerDirective urlTemplate="https://tile.openstreetmap.org/level/tileX/tileY.png">
                </LayerDirective>
            </LayersDirective>
        </MapsComponent></div>)
    }
};
ReactDOM.render(<App />, document.getElementById('maps'));

Contents

Print
Export
Image Export
Exporting Maps as base 64 string of the file
PDF Export
Export the tile Maps

Contents

Print
Export
Image Export
Exporting Maps as base 64 string of the file
PDF Export
Export the tile Maps