Mapbox

Learn how to integreate high-performance maps in your application.

Mapbox GL JS is a JavaScript library for vector maps on the Web. Its performance, real-time styling, and interactivity features set the bar for anyone building fast, immersive maps on the web.

Installation

In order to use the Mapbox GL JS, you need to create a Mapbox access token. Read more about it here

Configuration

Open .env file (or create) in the project's root folder and set the variable NEXT_PUBLIC_MAPBOX_API_KEY with the access token ID provided by Mapbox platform.

NEXT_PUBLIC_MAPBOX_API_KEY=access_token

The environment variables, will be used in src/config.ts file.

export const config = {
	// ...
	mapbox: {
		apiKey: process.env.NEXT_PUBLIC_MAPBOX_API_KEY,
	},
	// ...
};

Usage

import { config } from "@/config";
 
function Component() {
	return (
		<div>
			<Map
				attributionControl={false}
				initialViewState={{}}
				mapStyle="mapbox://styles/mapbox/light-v9"
				mapboxAccessToken={config.mapbox.apiKey}
				maxZoom={20}
				minZoom={11}
			/>
		</div>
	);
}

Removing Mapbox support

If you do not need to support Mapbox, you can remove it by following the next steps.

  1. Uninstall the mapbox-gl andreact-map-gl dependencies.
  2. Remove the related styles from styles/global.css