Maps in React

The main branch's code shows a basic example of a map with a marker and navbar using React and MapTiler SDK. (MapTiler SDK extends MapLibre GL JS with functions related to the MapTiler mapping platform. The basic concepts of this tutorial also show how to create a React map with MapLibre GL JS). You can find a step-by-step tutorial for it here.

Repository branches show code changes corresponding to the MapTiler React video series.

Get your MAPTILER_CLOUD_API_KEY to make this code work: https://cloud.maptiler.com/account/keys/ You can create it for free!

You can learn more about MapTiler SDK.
Find out more about MapTiler Cloud - where you can get your basemaps and store your mapping data.

Get started

1. Clone this repo

  git clone https://github.com/maptiler/maps-in-react.git my-react-map

2. Navigate to the newly created project folder my-react-map

  cd my-react-map

3. Install dependencies

  npm install

4. ⚠️ Open my-react-map/src/config.js and replace YOUR_MAPTILER_API_KEY_HERE with your actual MapTiler API key. If you don't have an API KEY, you can create it for FREE at https://www.maptiler.com/cloud/

5. Start your local environment

  npm run dev

6. You will find your app on the address http://localhost:5173/. Now, you should see the map in your browser.

Episode specific instructions

Here is the step-by-step guide for creating a state in the main branch: https://docs.maptiler.com/react/sdk-js/get-started-material-ui/.

E1 - Map in React js with geojson data, points, and clusters

step-by-step tutorial

add custom geojson data to a React map with SDK helpers read more about MapTilerSDK point helper

You can find GeoJSON data used in tutorial videos in the assets folder.

E2 - Map in React js with heatmap and visualization switcher

step-by-step tutorial

MapTiler SDK heatmap helper MapTiler SDK Color Ramp

E3 - Map in React js with popup and sidebar

step-by-step tutorial

Material UI: https://mui.com/core/ MUI sidebar examples: https://mui.com/material-ui/react-drawer/

E4 - Map in React js with geocoding control

step-by-step tutorial

Download MapTiler geocoding control from npm: https://www.npmjs.com/package/@maptiler/geocoding-control

Open the terminal on the my-react-map folder.

• npm i @maptiler/geocoding-control
• npm install
• npm run dev //to start your map app geocoding API reference

E5 - 3D Map in React js

step-by-step tutorial

Enable/disable map terrain programmatically: https://docs.maptiler.com/sdk-js/examples/map-terrain/

How to find the id of last text map layer?

1. Go to MapTiler Cloud
2. Select a map that you want to use as a basemap
3. Customize
4. Go to layer - Verticality and find the last symbol layer
5. Click at the last symbol layer and open JSON editor ( {} )
6. Copy layer id, e.g., "Ocean labels".

How to create a custom map style on MapTiler Cloud: https://documentation.maptiler.com/hc/en-us/articles/360020805917-How-to-make-custom-map-design-in-MapTiler-Cloud

Build with

Vite
MapTiler SDK JS
MUI