MapConductor React SDK Samples

Store Map | HERE | MapConductor React SDK

MapConductor React SDK Store Map sample using HERE.

This interactive example demonstrates the Store Map feature through the MapConductor abstraction on HERE.

Code example

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';


// (1) Create the map


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: import.meta.env.VITE_HERE_API_KEY }),
  [],
);


// (2) Prepare the data and interaction state
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) Render the map and its overlays


<HereMapView2D platform={platform} state={mapViewState} onMapClick={clearSelection}>
  <Markers states={storeMarkers} />
  {selectedMarker && (
    <InfoBubble marker={selectedMarker}>
      <StoreInfoView store={selectedMarker.extra} />
    </InfoBubble>
  )}
</HereMapView2D>

How the code works

Render a collection of store markers in one composition and show an information bubble for the selected store.

The storeMarkers array is built once with useMemo: each createMarkerState keeps its store record in the extra field and an onClick handler that saves the tapped MarkerState, while onMapClick clears the selection.

The batched <Markers> component draws every store in a single pass, and the InfoBubble is anchored to the selected marker so StoreInfoView appears only while a store is chosen.