用途:用于在网页中构建交互式地图,基于 MapLibre GL JS 扩展,提供 MapTiler Cloud 的默认配置,兼容原生 MapLibre 的源和图层。
主要能力:统一 API Key 配置(config.apiKey)、MapStyle 枚举样式、helpers 辅助函数(折线、多边形、点、热力图、截图等)、内置地理编码、地理定位、海拔、静态地图、3D 地形(terrain: true)、地球投影(projection: 'globe')、构造器级控件、完整 TypeScript 类型。
使用方式:安装 npm install @maptiler/sdk,单独导入 CSS:import '@maptiler/sdk/dist/maptiler-sdk.css'; 或使用 CDN。设置 API Key 后创建 Map 实例,容器需显式尺寸。坐标顺序为 [lng, lat]。支持 React、Vue、Svelte、Angular、Next.js 集成。
适用场景:网页地图展示、地点搜索、数据可视化、3D 地形、地球视图、静态地图图片等。
限制:需用户自备 MapTiler API Key;容器无高度则地图不可见;setStyle 后需重新添加图层;SPA 中需调用 map.remove() 避免内存泄漏;不应单独导入 maplibre-gl。部分生态包和高级用法细节暂未提供。