@mapcomponents/three

This library provides React components to easily integrate Three.js 3D content into MapLibre GL JS maps using @mapcomponents/react-maplibre.

Installation

Install the package and its peer dependencies:

npm install @mapcomponents/three @mapcomponents/react-maplibre

Getting Started

To use @mapcomponents/three, you need to wrap your 3D layers with the ThreeProvider component. This provider initializes the Three.js scene, camera, and renderer, and registers a custom layer within the MapLibre map.

Basic Usage

Here is a simple example of how to render a 3D model on a map:

import React from 'react';
import { MapComponentsProvider, MapLibreMap } from '@mapcomponents/react-maplibre';
import { ThreeProvider, MlThreeModelLayer } from '@mapcomponents/three';

const App = () => {
  return (
    <MapComponentsProvider>
      <ThreeProvider id="three-scene-1">
        <MapLibreMap
          options={{
            style: 'https://demotiles.maplibre.org/style.json',
            center: [13.404954, 52.520008],
            zoom: 15,
            pitch: 60
          }}
        />
      
        <MlThreeModelLayer
          url="https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Duck/glTF-Binary/Duck.glb"
          mapPosition={[13.404954, 52.520008]}
          scale={10}
        />
      </ThreeProvider>
    </MapComponentsProvider>
  );
};

export default App;

Running unit tests

Run nx test @mapcomponents/three to execute the unit tests via Vitest.