Wondering what’s next for npm?Check out our public roadmap! »

    mapbox-gl-leaflet
    DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/mapbox-gl-leaflet package

    0.0.14 • Public • Published

    Note: this tool is experimental and is not actively supported by Mapbox. For support, please open an issue in this repository.

    Mapbox GL Leaflet

    build status

    This is a binding from Mapbox GL JS to the familiar Leaflet API.

    Code example

    var token ="pk.XXXX"; // replace with your Mapbox API Access token. Create a Mapbox account and find it on https://account.mapbox.com/
     
    var map = L.map('map').setView([38.912753, -77.032194], 15);
    L.marker([38.912753, -77.032194])
        .bindPopup("Hello <b>Leaflet GL</b>!<br>Whoa, it works!")
        .addTo(map)
        .openPopup();
    var gl = L.mapboxGL({
        accessToken: token,
        style: 'mapbox://styles/mapbox/bright-v8'
    }).addTo(map);

    Note that you can use any vector tile source useable by mapbox-gl. For instance, you can use OSM2VectorTiles with:

    var gl = L.mapboxGL({
        style: 'https://api.maptiler.com/maps/topo/style.json?key=<YOUR_MAPTILER_API_KEY>'
    }).addTo(map);

    Once you have created the leaflet layer, the mapbox-gl map object can be accessed using

    gl.getMapboxMap()....
    // add a source to the mapbox-gl layer
    gl.getMapboxMap().addSource({...})

    Get your Mapbox token

    Create a mapbox account, then head to https://www.mapbox.com/studio/ and copy your access token that was automatically created for you. The access token should start with "pk.".

    Live examples

    Basic example

    Cluster example

    Map events example

    Code for these examples is hosted in the examples folder

    Installation

    Add a script tag referencing mapbox-gl-leaflet after adding leaflet and mapbox-gl-js in your website:

    <!-- Leaflet -->
    <link rel="stylesheet" href="leaflet.css" />
    <script src="leaflet.js"></script>
     
    <!-- Mapbox GL -->
    <link href='https://api.tiles.mapbox.com/mapbox-gl-js/v1.5.0/mapbox-gl.css' rel='stylesheet' />
    <script src='https://api.tiles.mapbox.com/mapbox-gl-js/v1.5.0/mapbox-gl.js'></script>
     
    <script src="leaflet-mapbox-gl.js"></script>

    You can also use Unpkg as a CDN using:

    <script src="https://unpkg.com/mapbox-gl-leaflet/leaflet-mapbox-gl.js"></script>

    Motivation

    This project makes it possible to easily add a mapbox-gl-js layer in your Leaflet map. When using mapbox-gl-leaflet, you won't be able to use some of the mapbox-gl-js features. Here are the main differences between a "pure" mapbox-gl-js map and a Leaflet map using mapbox-gl-leaflet:

    • No rotation / bearing / pitch support
    • Slower performances: When using mapbox-gl-leaflet, mapbox-gl-js is set as not interactive. Leaflet receives the touch/mouse events and updates the mapbox-gl-js map behind the scenes. Because mapbox-gl-js doesn't redraw as fast as Leaflet, the map can seem slower.

    On the bright side, the mapbox-gl-leaflet binding will allow you to use all the leaflet features and plugins.

    If you only need the mapbox-gl-js features (adding a map with a mapbox-style, adding a GeoJSON, etc.), you are probably better off using it directly.

    API Reference

    API Reference

    Bug Reports & Feature Requests

    Please use the issue tracker to report any bugs or file feature requests. You can fork this jsfiddle template to reproduce a bug, then share the URL of your fork in the GitHub issue.

    Licence

    ISC © Mapbox

    Install

    npm i mapbox-gl-leaflet

    DownloadsWeekly Downloads

    6,042

    Version

    0.0.14

    License

    ISC

    Unpacked Size

    18.6 kB

    Total Files

    5

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar
    • avatar
    • avatar