GeoVerse

Appearance

Documentation / @geoverse/react / useGeoVerseMap

Function: useGeoVerseMap() ​

ts
function useGeoVerseMap(options, containerRef): RefObject<GMap | null>;

Defined in: react/src/hooks/useGeoVerseMap.ts:18

命令式地图 hook：在给定容器 ref 上创建 / 销毁 GMap，实例存于返回的 ref （不进 state，见 GEOVERSE_REACT_PLAN §2.2）。

创建 effect 空依赖、cleanup 调 destroy()，对称收敛 StrictMode 双挂载。 options 经 latest-ref 读取，不入依赖——重渲染不重建地图。

tsx
const el = useRef<HTMLDivElement>(null);
const map = useGeoVerseMap({ base: 'gd-vec', center: [118.18, 24.49], zoom: 12 }, el);
// <div ref={el} style={{ width: '100%', height: '100%' }} />

Parameters ​

options ​

Omit<GMapOptions, "target">

containerRef ​

RefObject<HTMLElement | null>

Returns ​

RefObject<GMap | null>