SuperAPI AI 工具集

map-generator

通用与其它

查看项目

更新于 10-16 07:31

技能介绍

用途

map-generator 用于创建基于 Leaflet JavaScript 库的交互式地图,以 MicroSim 形式嵌入使用 MkDocs Material 主题构建的智能教科书。

当用户需要以下内容时可使用本技能:

  • 地理可视化(地区、国家、城市)
  • 基于位置的数据展示(历史遗址、地标)
  • 校园或设施地图
  • 旅行路线可视化
  • 带有标记、图层或高亮边界的自定义地图
  • 地理教学教育内容

主要能力

  • 使用 Leaflet 初始化交互式地图,支持中心坐标与缩放级别
  • 添加标记与弹出窗口(popup)
  • 支持 GeoJSON 图层以显示边界或区域
  • 支持图层控件,在多种底图之间切换(如 OpenStreetMap、卫星图、地形图)
  • 支持自定义标记图标
  • 支持标记聚类以处理大数据集
  • 生成配套的 HTML、CSS、JavaScript、Markdown 与 metadata 文件

使用方式

工作流分为以下步骤:

  1. 收集地图需求:地图用途、地理区域、标记点、地图图层、边界/区域、初始缩放级别(1-18)、交互功能、教育背景。
  2. 创建目录结构:docs/sims/[map-name]/,命名使用 kebab-case(如 california-universities、ancient-rome-map、world-capitals)。
  3. 可选创建 map-data.json:包含 center、zoom、title、subtitle、markers(含 lat、lng、title、description、category)。复杂几何使用 GeoJSON 格式。
  4. 创建 main.html:使用 assets/template-iframe-main.html 模板,包含 Leaflet CDN 链接、id="map" 的容器、可选图层切换控件、script.js 引用。替换占位符 {{TITLE}}、{{SUBTITLE}}、{{MAP_HEIGHT}}(默认 400px)。
  5. 创建 style.css:使用 assets/template-iframe-style.css 模板,要求 body { margin: 0; padding: 0; },#map 固定高度,响应式断点,aliceblue 背景。
  6. 创建 script.js:使用 assets/template-script.js 模板,初始化地图、添加瓦片图层、添加标记与弹窗、可选 GeoJSON 图层与图层控件。替换 {{CENTER_LAT}}、{{CENTER_LNG}}、{{ZOOM}}、{{MARKERS}}、{{TILE_LAYER}}。
  7. 创建 index.md:使用 assets/template-index.md 模板,包含标题与概述、iframe 嵌入(<iframe src="main.html" width="100%" height="700" frameborder="0"></iframe>)、全屏链接、功能说明、自定义指南、技术细节、用例与参考。
  8. 创建 metadata.json:使用 assets/template-metadata.json 模板,包含 Dublin Core 字段及地图专属字段(map_type、center_lat、center_lng、zoom_level、marker_count、concepts、bloom_taxonomy)。
  9. 更新 mkdocs.yml 导航,在 MicroSims 下添加新地图条目,标签使用 Title Case。
  10. 测试与验证:直接打开 HTML 测试、运行 mkdocs serve 测试 iframe 嵌入与全屏链接、浏览器兼容性测试、移动端响应式测试。

常用瓦片图层 URL:

  • OpenStreetMap: https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png
  • Satellite: https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}
  • Terrain: https://{s}.tile.opentopomap.org/{z}/{x}/{y}.png

简单标记地图代码示例:

const markers = [
  { lat: 40.7128, lng: -74.0060, title: "New York", description: "The Big Apple" },
  { lat: 34.0522, lng: -118.2437, title: "Los Angeles", description: "City of Angels" }
];

markers.forEach(marker => {
  L.marker([marker.lat, marker.lng])
    .bindPopup(`<b>${marker.title}</b><br>${marker.description}`)
    .addTo(map);
});

高亮区域(GeoJSON)示例:

const region = {
  "type": "Feature",
  "geometry": {
    "type": "Polygon",
    "coordinates": [[...]]
  }
};

L.geoJSON(region, {
  style: { color: 'red', weight: 3, fillOpacity: 0.2 }
}).addTo(map);

图层控件示例:

const street = L.tileLayer('https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png');
const satellite = L.tileLayer('https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}');

const baseMaps = {
  "Street": street,
  "Satellite": satellite
};

L.control.layers(baseMaps).addTo(map);
street.addTo(map); // Default layer

自定义标记图标示例:

const universityIcon = L.icon({
  iconUrl: 'university-icon.png',
  iconSize: [32, 32],
  iconAnchor: [16, 32],
  popupAnchor: [0, -32]
});

L.marker([lat, lng], { icon: universityIcon }).addTo(map);

适用场景

  • 智能教科书中的地理教学内容
  • 校园、设施或地标地图
  • 基于位置的数据展示
  • 旅行路线可视化
  • 带有边界或区域高亮的自定义地图

限制与注意事项

教育考量方面,技能提供布鲁姆分类法对齐建议(记忆、理解、应用、分析、评价、创造)。无障碍方面要求确保标记弹窗有描述性文本、为视觉信息提供文本替代、高对比度颜色、支持键盘导航。性能方面建议将标记限制在 100 个以内,大数据集使用标记聚类:

const markers = L.markerClusterGroup();
markers.addLayer(L.marker([lat, lng]));
map.addLayer(markers);

排查常见问题:地图不显示时检查 Leaflet CDN 链接、#map 固定高度、坐标是否为十进制;标记不出现时检查纬度/经度顺序(lat 在前)、坐标范围(纬度 -90 到 90,经度 -180 到 180)、标记是否在地图初始化后添加;iframe 不适配时检查 body 边距、iframe 高度与容器边距。

版本历史:v1.0(2025-01-16)初始发布,包含基础标记地图、图层控件与 GeoJSON 支持。

关于收费、价格、平台支持范围等信息,资料中暂未提供。