react-simple-maps

What is react-simple-maps?

react-simple-maps is a library for creating SVG maps in React applications. It provides a simple and flexible way to create interactive and customizable maps using React components.

What are react-simple-maps's main functionalities?

Creating a Basic Map

This code demonstrates how to create a basic world map using react-simple-maps. The `ComposableMap` component is the container for the map, and `Geographies` and `Geography` components are used to render the map's geographical features.

import React from 'react';
import { ComposableMap, Geographies, Geography } from 'react-simple-maps';

const BasicMap = () => (
  <ComposableMap>
    <Geographies geography="https://raw.githubusercontent.com/zcreativelabs/react-simple-maps/master/topojson-maps/world-110m.json">
      {({ geographies }) =>
        geographies.map(geo => (
          <Geography key={geo.rsmKey} geography={geo} />
        ))
      }
    </Geographies>
  </ComposableMap>
);

export default BasicMap;

Adding Interactivity

This code sample shows how to add interactivity to the map. The `onMouseEnter` and `onMouseLeave` events are used to log the name of the country when the mouse enters and leaves a geographical area.

import React from 'react';
import { ComposableMap, Geographies, Geography } from 'react-simple-maps';

const InteractiveMap = () => (
  <ComposableMap>
    <Geographies geography="https://raw.githubusercontent.com/zcreativelabs/react-simple-maps/master/topojson-maps/world-110m.json">
      {({ geographies }) =>
        geographies.map(geo => (
          <Geography
            key={geo.rsmKey}
            geography={geo}
            onMouseEnter={() => {
              const { NAME } = geo.properties;
              console.log(`Mouse entered: ${NAME}`);
            }}
            onMouseLeave={() => {
              console.log('Mouse left');
            }}
          />
        ))
      }
    </Geographies>
  </ComposableMap>
);

export default InteractiveMap;

Customizing Map Styles

This code demonstrates how to customize the styles of the map. The `style` prop is used to define different styles for the default, hover, and pressed states of the geographical areas.

import React from 'react';
import { ComposableMap, Geographies, Geography } from 'react-simple-maps';

const StyledMap = () => (
  <ComposableMap>
    <Geographies geography="https://raw.githubusercontent.com/zcreativelabs/react-simple-maps/master/topojson-maps/world-110m.json">
      {({ geographies }) =>
        geographies.map(geo => (
          <Geography
            key={geo.rsmKey}
            geography={geo}
            style={{
              default: { fill: '#D6D6DA', outline: 'none' },
              hover: { fill: '#F53', outline: 'none' },
              pressed: { fill: '#E42', outline: 'none' }
            }}
          />
        ))
      }
    </Geographies>
  </ComposableMap>
);

export default StyledMap;

Other packages similar to react-simple-maps

react-leaflet

react-leaflet is a React wrapper for the Leaflet library, which is a popular open-source JavaScript library for interactive maps. Unlike react-simple-maps, which focuses on SVG maps, react-leaflet provides a more feature-rich and flexible solution for creating interactive maps with various layers, markers, and controls.

react-map-gl

react-map-gl is a React wrapper for Mapbox GL JS, a powerful library for interactive, customizable maps. It offers advanced features like 3D terrain, vector tiles, and high-performance rendering. Compared to react-simple-maps, react-map-gl is more suitable for complex and high-performance mapping applications.

google-maps-react

google-maps-react is a library for integrating Google Maps into React applications. It provides a set of React components for embedding Google Maps and adding markers, info windows, and other map features. While react-simple-maps focuses on SVG maps, google-maps-react leverages the Google Maps API for more detailed and interactive maps.

README

react-simple-maps

Create beautiful SVG maps in react with d3-geo and topojson using a declarative api.

Read the docs, or check out the examples.

Why

React-simple-maps aims to make working with svg maps in react easier. It handles tasks such as panning, zooming and simple rendering optimization, and takes advantage of parts of d3-geo and topojson-client instead of relying on the entire d3 library.

Since react-simple-maps leaves DOM work to react, it can also easily be used with other libraries, such as react-spring and react-annotation.

Install

To install react-simple-maps

$ npm install --save react-simple-maps

...or if you use yarn:

$ yarn add react-simple-maps

Usage

React-simple-maps exposes a set of components that can be combined to create svg maps with markers and annotations. In order to render a map you have to provide a reference to a valid topojson file. You can find example topojson files on here or here. To learn how to make your own topojson maps from shapefiles, please read "How to convert and prepare TopoJSON files for interactive mapping with d3" on medium.

import React from "react";
import ReactDOM from "react-dom";
import { ComposableMap, Geographies, Geography } from "react-simple-maps";

// url to a valid topojson file
const geoUrl =
  "https://raw.githubusercontent.com/deldersveld/topojson/master/world-countries.json";

const App = () => {
  return (
    <div>
      <ComposableMap>
        <Geographies geography={geoUrl}>
          {({ geographies }) =>
            geographies.map((geo) => (
              <Geography key={geo.rsmKey} geography={geo} />
            ))
          }
        </Geographies>
      </ComposableMap>
    </div>
  );
};

document.addEventListener("DOMContentLoaded", () => {
  ReactDOM.render(<App />, document.getElementById("app"));
});

Check out the live example

The above will render a world map using the equal earth projection. You can read more about this projection on Shaded Relief and on Wikipedia.

For other examples and components, check out the documentation.

Map files

React-simple-maps does not restrict you to one specific map and relies on custom map files that you can modify in any way necessary for the project. This means that you can visualise countries, regions, and continents in various resolutions, as long as they can be represented using geojson/topojson.

In order for this to work properly, you will however need to provide these valid map files to react-simple-maps yourself. Luckily, there are decent sources for map files on github and elsewhere. Here are some you can check out:

• Natural Earth
• Topojson maps by @deldersveld
• Topojson world atlas

License

MIT licensed. Copyright (c) Richard Zimerman 2017. See LICENSE.md for more details.

Changelog

v3.0.0 2022-07-25

• Added forwardRef to mapping components
• Added ZoomPanContext and ZoomPanProvider
• Added useZoomPanContext and useMapContext hooks
• Added support for React 18