SuperAPI AI 工具集

gis-maps-integration

编程与开发

查看项目

更新于 10-16 03:40

技能介绍

用途:在 Web 应用中集成 Google Maps JavaScript API 或 Mapbox GL,适用于 Leaflet 无法满足的场景,如地点自动补全、Google 生态、转向导航、Street View、3D 建筑、高级样式、出行/物流/门店定位等。选型规则:简单标记与基础图层选 Leaflet;需要地点补全、Google 生态、带路况路线选 Google Maps JS API;需要自定义样式、3D、移动离线、WebGL 性能选 Mapbox GL;自托管矢量瓦片或偏好开源可选 MapLibre(Mapbox GL v1 的开源分支,无厂商密钥)。

主要能力:Google 侧包括密钥按环境创建、HTTP referrer 与 API 限制、每日配额上限与预算告警;使用 @googlemaps/js-api-loader 加载;AdvancedMarkerElement 标记、InfoWindow 弹窗、Polyline/Polygon、Data Layer 加载 GeoJSON、超过约 200 个标记做聚合;Places 自动补全需防抖、缓存、限制国家与返回字段;Directions API 支持驾车/步行/骑行/公交,支持途经点重排与备选路线;样式推荐 Cloud-based Map Styles(Map IDs)。Mapbox 侧包括 WebGL 地图、矢量瓦片源、按图层表达式设置样式、移动 SDK 支持离线区域下载,Web 端无原生离线但可用 service worker 缓存瓦片。

使用方式:先读 SKILL.md,再按需加载 references 目录中的深入文件;按有序指引与检查清单执行,输出实现指南、评审发现、架构决策或模板,并明确假设、风险与后续工作。

限制与注意事项:每个地图服务请求都产生费用,需按密钥设配额、做客户端缓存、服务端代理密钥,并定期评估支出;API 密钥不得硬编码在前端包中;Places 未指定 fields 会产生额外成本;地图需提供文本替代、键盘导航与 aria-label,不能只靠颜色区分;移动端需规划离线方案;更换供应商前应有抽象层。具体价格与配额数值暂未提供。