Scroll Top

Play with Maps in React using MapBox

Getting your Trinity Audio player ready...

Play with Maps in React using MapBox - WTT Blogs

Creating maps, marking and finding specific positions on the map and lots more can be done with maps. MapBox is a mapping platform which helps in building custom maps and solutions using maps.

In this blog, we will use MapBox in our React application to render a map with custom Markers.

I have picked up some of my neighbouring coordinates, and in our React application, we will show the hospitals as Markers with the number of beds available in each using a street style map.

Setting up

In order to be able to use MapBox, we need to first sign up to get the API token.

Sign up in MapBox and create a new token using the blue button as below after signup.

Provide a name and the default public token should suffice for general use. If you select secret scopes in the bottom section, you will also receive a secret token which will be displayed only once. You can define scopes based on your requirement of accessing the API.

You will be prompted to re-enter password after which your token will be created and ready to use. This token will be used in your React component.

Next we will create our template React application using create-react-app as below

In order to include MapBox into our React application, we will make use of react-map-gl, a set of React components created by engineers at Uber for Mapbox GL JS that can be easily included in our React application.

So let’s install all the dependencies. Semantic-ui is included for any styling requirements.

For the Mapbox GL JS to work as expected we need to include the below dependencies in public/index.html:

If you miss to include the above, you also get the below warning in the browser console:

With the prerequisites setup, we can now proceed with defining our Map component and rendering it in the App.js.

Adding a Map Component

To include a simple map, first import the MapGL and NavigationControl to show the map and the controls on the map.

The local state is initialised with the required coordinates(latitude, longitude), the size of the map(width, height) and zoom options for the viewport as below:

The TOKEN created earlier should be defined as a constant and used for the mapboxApiAccessToken option to setup the MapGL component  in the render method as below:

The onViewportChange={(viewport) => this.setState({viewport})} function is required to be bound to update the local viewport state to ensure the zoom and click functionality work on the map and the viewport is updated for any action, along with the Navigation controls, so it is mapped for both MapGL and NavigationControl.

The mapStyle option is used to select the type of map you want to render. You can pick one of the predefined styles listed here, or you can create your own style in the MapBox website. In this example, I am using the predefined street style mapbox://styles/mapbox/streets-v10.

The navStyle is used to position the Navigation control within the map on the top left.

The rendered local map looks like below(the center coordinates are from a locality called Madhapur in Hyderabad, India):

Adding Markers and Popup to the Map

Now we will mark and show some dummy data for hospitals in the above map. I have created a sample list for the coordinates and the data to be shown as the markers, as below:

First, we need to include two additional imports to incorporate Markers and PopUps:

The PopUp is defined using the PopUp component by providing the coordinates from the markerList as below:

The render is modified to include the marker display in the form of a Hospital Icon based on the markerList data, we defined initially.

To keep the example simple, we show the popup all at once with some basic info on mouse enter event of the marker.

Now the map looks like below with the hospital icon markers and the corresponding popUp info.

You can zoom into it to get a better look at the location as below:

This map can be further modified and styled to suit your needs.

You can find the complete code for this example here or fork and try out the example by yourself at sandbox.


In this blog, we learnt how to display maps with markers and popups at specific coordinates in a React Application, using MapBox GL JS library through the components provided by the react-map-gl. This library provides a plethora of functionalities and styling around maps and can be explored further depending on your interest and requirements.


Related Posts

Comments (4)

react-map-gl doesn’t support markers clusters )-:
It’s very-very bad…

Thanks for your inputs. I didn’t cover this aspect as a part of my use case. Will surely explore other alternatives.

Map markers doesnt work with this.

Hey Abhilasha! I am learning to react js currently and I searched for some interesting tutorials for polishing my knowledge, luckily I found your article very helpful and I liked that you have taken easy code to create maps with react.

I would implement this tutorial. Thanks for posting this amazing code and content.

Leave a comment

Privacy Preferences
When you visit our website, it may store information through your browser from specific services, usually in form of cookies. Here you can change your privacy preferences. Please note that blocking some types of cookies may impact your experience on our website and the services we offer.