Get Started
Introduction
The NextBillion.ai Maps provides a JavaScript library to render interactive maps that display raster or vector tiles, markers, static and dynamic graphic elements for your mapping and visualization needs. It is part of NextBillion.ai Maps platform, which provides hyper local geospatial AI in our mapping eco-system, including Routing and ETAs, Location Management, Map Production and Maintenance, and much more.
Hello, World
Below is a basic map generated with NextBillion.ai Maps. It positions at Los Angeles with a zoom level of 10. Try dragging and scrolling on it!
Installation
From CDN
You can use NextBillion.ai Maps SDK's features with our CDN. If the visitor to your web site has already downloaded NextBillion.ai Maps, it won't have to be re-downloaded.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39<!DOCTYPE html> <html lang="en"> <head> <meta name="viewport" content="initial-scale=1.0" /> <meta charset="UTF-8" /> <title>Basic Map</title> <link href="https://maps-gl.nextbillion.io/maps/api/css" rel="stylesheet" /> <!-- Or use the legacy version: --> <!-- <link href="https://maps.nextbillion.io/maps/api/css" rel="stylesheet"> --> <style> * { margin: 0; padding: 0; } #map { width: 100vw; height: 100vh; } </style> </head> <body> <div id="map"></div> <script src="https://maps-gl.nextbillion.io/maps/api/js"></script> <!-- Or use the legacy version: --> <!-- <script src="https://maps.nextbillion.io/maps/api/js"></script> --> <script> ;(function () { // To use NextBillion Maps GL, an apiKey is required. // You don't need to provide an apiKey for the legacy version of // NextBillion Maps. nextbillion.setApiKey('your-api-key') var map = new nextbillion.maps.Map(document.getElementById('map'), { zoom: 12, center: { lat: 28.6139, lng: 77.209 }, }) })() </script> </body> </html>
From NPM
NextBillion.ai Maps is also available as an NPM package. You can install it with the npm command:
npm install nbmap-glOr if you prefer the yarn command:
yarn add nbmap-glThis will install NextBillion.ai Maps to the node_modules folder. You will find all released JavaScript, map and CSS files in node_modules/nbmap-gl/dist.
In your project, taking a React.js one created with create-react-app for example, you can use NextBillion.ai Maps like this:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18import React, { useEffect } from 'react' import nextbillion from 'nbmap-gl' import 'nbmap-gl/dist/nextbillion.css' import './App.css' nextbillion.setApiKey('your-api-key') function App() { useEffect(() => { new nextbillion.maps.Map(document.getElementById('map'), { zoom: 12, center: { lat: 28.6139, lng: 77.209 }, }) }, []) return <div id='map'></div> } export default App
1 2 3 4 5 6 7 8 9* { margin: 0; padding: 0; } #map { width: 100vw; height: 100vh; }
