MapConductor React SDK Samples

店舗マップ | HERE | MapConductor React SDK

MapConductor React SDKでHEREを使用する店舗マップのサンプルです。

このインタラクティブサンプルでは、MapConductorの抽象APIを通じてHERE上で店舗マップを実装します。

コード例

import { useMemo, useState } from 'react';
import {
  createGeoPoint,
  createMapCameraPosition,
  createMarkerState,
  type MarkerState,
} from '@mapconductor/js-sdk-core';
import { InfoBubble, Markers } from '@mapconductor/js-sdk-react';
import { HereMapDesign, HereMapView2D, useHereViewState } from '@mapconductor/react-for-here';


// Before mounting App, add these tags to index.html:
// <script src="https://js.api.here.com/v3/3.1/mapsjs-core.js"></script>
// <script src="https://js.api.here.com/v3/3.1/mapsjs-core-legacy.js"></script>
// <script src="https://js.api.here.com/v3/3.1/mapsjs-service.js"></script>
// <script src="https://js.api.here.com/v3/3.1/mapsjs-ui.js"></script>
// <script src="https://js.api.here.com/v3/3.1/mapsjs-mapevents.js"></script>
// <link rel="stylesheet" href="https://js.api.here.com/v3/3.1/mapsjs-ui.css" />


function StoreInfoView({ store }: { store: { name: string; address: string } }) {
  return <article><h3>{store.name}</h3><p>{store.address}</p></article>;
}


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


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


  const mapViewState = useHereViewState({
    mapDesignType: HereMapDesign.NormalDay,
    cameraPosition: initialCamera,
  });
  const platform = useMemo(
    () => new H.service.Platform({ apikey: 'YOUR_HERE_API_KEY' }),
    [],
  );


  // (2) データと操作用Stateの準備
  const stores = useMemo(() => [
    { id: 'tokyo', name: 'Tokyo Store', address: 'Tokyo Station', lat: 35.6812, lng: 139.7671 },
    { id: 'ginza', name: 'Ginza Store', address: 'Ginza, Tokyo', lat: 35.6717, lng: 139.7650 },
  ], []);
  const [selectedMarker, setSelectedMarker] = useState<MarkerState | null>(null);
  const storeMarkers = useMemo(() => stores.map(store => createMarkerState({
    id: store.id,
    position: createGeoPoint({ latitude: store.lat, longitude: store.lng }),
    extra: store,
    onClick: markerState => setSelectedMarker(markerState),
  })), [stores]);
  const clearSelection = () => setSelectedMarker(null);


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


  return (
    <div style={{ height: 500, position: 'relative', display: 'flex', flexDirection: 'column' }}>
      <HereMapView2D platform={platform} state={mapViewState} onMapClick={clearSelection}>
        <Markers states={storeMarkers} />
        {selectedMarker && (
          <InfoBubble marker={selectedMarker}>
            <StoreInfoView store={selectedMarker.extra as (typeof stores)[number]} />
          </InfoBubble>
        )}
      </HereMapView2D>
    </div>
  );
}

コードの読み方

店舗マーカーを一括で描画し、選択された店舗に情報を表示する吹き出しを重ねます。

storeMarkers は useMemo で一度だけ生成し、各 createMarkerState は店舗データを extra に保持して、タップされた MarkerState を保存する onClick を持ちます。地図の余白をクリックすると選択が解除されます。

一括描画用の <Markers> が全店舗を1回で描画し、InfoBubble は選択中のマーカーに固定されるため、店舗を選んだ間だけ StoreInfoView が表示されます。