MapConductor React SDK Samples

Three.js (web only) | MapLibre | MapConductor React SDK

MapConductor React SDKでMapLibreを使用するThree.js (web only)のサンプルです。

このインタラクティブサンプルでは、MapConductorの抽象APIを通じてMapLibre上でThree.js (web only)を実装します。

コード例

import { useEffect, useMemo } from 'react';
import * as THREE from 'three';
import {
  createGeoPoint,
  createMapCameraPosition,
  type GeoPoint,
  type MapDesignTypeInterface,
  type MapViewStateInterface,
} from '@mapconductor/js-sdk-core';
import { useMapLoaded } from '@mapconductor/js-sdk-react';
import { MapLibreDesign, MapLibreMapView2D, useMapLibreViewState } from '@mapconductor/react-for-maplibre';
import '@mapconductor/react-for-maplibre/style.css';


function ThreeMapObject({ mapViewState, position }: {
  mapViewState: MapViewStateInterface<MapDesignTypeInterface<unknown>>;
  position: GeoPoint;
}) {
  const isMapLoaded = useMapLoaded();


  useEffect(() => {
    if (!isMapLoaded) return;
    const holder = mapViewState.getMapViewHolder();
    if (!holder) return;
    const mapElement = holder.mapView;
    if (!(mapElement instanceof HTMLElement)) return;
    const host = mapElement.parentElement ?? mapElement;


    const scene = new THREE.Scene();
    const camera = new THREE.OrthographicCamera(0, 1, 1, 0, 0.1, 1000);
    camera.position.z = 200;
    const renderer = new THREE.WebGLRenderer({ alpha: true, antialias: true });
    let height = 1;
    const resize = () => {
      const width = Math.max(host.clientWidth, 1);
      height = Math.max(host.clientHeight, 1);
      renderer.setSize(width, height);
      camera.right = width;
      camera.top = height;
      camera.updateProjectionMatrix();
    };
    const observer = new ResizeObserver(resize);
    observer.observe(host);
    resize();
    renderer.domElement.style.position = 'absolute';
    renderer.domElement.style.inset = '0';
    renderer.domElement.style.pointerEvents = 'none';
    host.appendChild(renderer.domElement);


    const object = new THREE.Mesh(
      new THREE.TorusKnotGeometry(13, 4),
      new THREE.MeshNormalMaterial(),
    );
    scene.add(object);


    let frame = 0;
    let disposed = false;
    // Leaflet exposes outer-viewport projection separately.
    const projector = holder as typeof holder & {
      toOuterScreenOffset?: typeof holder.toScreenOffset;
    };
    const draw = async () => {
      const offset = await (projector.toOuterScreenOffset?.(position) ?? holder.toScreenOffset(position));
      if (disposed) return;
      object.visible = offset !== null;
      if (offset) {
        object.position.set(offset.x, height - offset.y, 0);
      }
      object.rotation.y += 0.02;
      renderer.render(scene, camera);
      frame = requestAnimationFrame(draw);
    };
    draw();


    return () => {
      disposed = true;
      cancelAnimationFrame(frame);
      observer.disconnect();
      renderer.domElement.remove();
      object.geometry.dispose();
      object.material.dispose();
      renderer.dispose();
    };
  }, [isMapLoaded, mapViewState, position]);


  return null;
}


export default function App() {
  // (1) 地図の作成


  const initialCamera = createMapCameraPosition({
    position: createGeoPoint({ latitude: 35.6812, longitude: 139.7671 }),
    zoom: 12,
  });


  const mapViewState = useMapLibreViewState({
    mapDesignType: MapLibreDesign.OsmBrightJa,
    cameraPosition: initialCamera,
  });


  // (2) データと操作用Stateの準備
  const position = useMemo(() => createGeoPoint({
    latitude: 35.6812,
    longitude: 139.7671,
  }), []);


  // (3) 地図とオーバーレイの描画


  return (
    <div style={{ height: 500, position: 'relative', display: 'flex', flexDirection: 'column' }}>
      <MapLibreMapView2D state={mapViewState}>
        <ThreeMapObject mapViewState={mapViewState} position={position} />
      </MapLibreMapView2D>
    </div>
  );
}

コードの読み方

透明な Three.js の canvas を地図へ重ね、Provider 非依存の MapViewHolder.toScreenOffset() で立体オブジェクトを地理座標へ固定します。

useMapLoaded が地図の準備が整うまで useEffect を待たせ、その後 getMapViewHolder() が返すホルダーの WebGL canvas を地図の上へ追加します。

毎フレーム holder.toScreenOffset(position) が地理座標をピクセル座標へ変換するため、地図を動かしても立体オブジェクトが固定され、どのプロバイダーでも同じ呼び出しで動きます。