用途:该技能用于指导在项目中集成 MapTiler 服务,适用于用户提出添加交互式地图、地理编码、地点 API、地形或 MapLibre 相关需求时。
主要能力:提供两个 npm 包的使用说明——@maptiler/sdk 用于交互式地图渲染、标记、弹窗、天气图层、3D 地形与 WebGL 地图;@maptiler/client 用于地理编码、静态地图、IP 地理定位与高程等无需可视化地图元素的原始 API 调用。
使用方式:编写代码前需确保存在 MAPTILER_API_KEY,新项目应让用户提供密钥或在 https://maptiler.com/cloud/ 创建,不得编造或硬编码假密钥,并按框架放入 .env(VITE_MAPTILER_API_KEY、NEXT_PUBLIC_MAPTILER_API_KEY 或 REACT_APP_MAPTILER_API_KEY)。按框架查阅参考文件:React/Next.js 见 references/sdk-react.md;原生 JS/HTML 见 references/sdk-vanilla.md;API 服务见 references/api-client.md;高级地图功能见 references/styles-and-layers.md。
辅助脚本:有 shell 权限时可运行 bash scripts/install-deps.sh sdk 安装 @maptiler/sdk,或 bash scripts/install-deps.sh client 安装 @maptiler/client。验证可用 tests/test_skill.py,通过 Gemini API 模拟交互(需 GEMINI_API_KEY),检查输出是否包含正确的 SDK 导入、CSS 链接、地图实例化与 API 密钥配置。
限制:具体收费、价格与平台支持范围资料未提供;密钥需用户自行申请,技能本身不提供密钥。