用途
map-generator 用于创建基于 Leaflet JavaScript 库的交互式地图,以 MicroSim 形式嵌入使用 MkDocs Material 主题构建的智能教科书。
当用户需要以下内容时可使用本技能:
- 地理可视化(地区、国家、城市)
- 基于位置的数据展示(历史遗址、地标)
- 校园或设施地图
- 旅行路线可视化
- 带有标记、图层或高亮边界的自定义地图
- 地理教学教育内容
主要能力
- 使用 Leaflet 初始化交互式地图,支持中心坐标与缩放级别
- 添加标记与弹出窗口(popup)
- 支持 GeoJSON 图层以显示边界或区域
- 支持图层控件,在多种底图之间切换(如 OpenStreetMap、卫星图、地形图)
- 支持自定义标记图标
- 支持标记聚类以处理大数据集
- 生成配套的 HTML、CSS、JavaScript、Markdown 与 metadata 文件
使用方式
工作流分为以下步骤:
- 收集地图需求:地图用途、地理区域、标记点、地图图层、边界/区域、初始缩放级别(1-18)、交互功能、教育背景。
- 创建目录结构:
docs/sims/[map-name]/,命名使用 kebab-case(如california-universities、ancient-rome-map、world-capitals)。 - 可选创建
map-data.json:包含 center、zoom、title、subtitle、markers(含 lat、lng、title、description、category)。复杂几何使用 GeoJSON 格式。 - 创建
main.html:使用assets/template-iframe-main.html模板,包含 Leaflet CDN 链接、id="map"的容器、可选图层切换控件、script.js引用。替换占位符{{TITLE}}、{{SUBTITLE}}、{{MAP_HEIGHT}}(默认 400px)。 - 创建
style.css:使用assets/template-iframe-style.css模板,要求body { margin: 0; padding: 0; },#map固定高度,响应式断点,aliceblue 背景。 - 创建
script.js:使用assets/template-script.js模板,初始化地图、添加瓦片图层、添加标记与弹窗、可选 GeoJSON 图层与图层控件。替换{{CENTER_LAT}}、{{CENTER_LNG}}、{{ZOOM}}、{{MARKERS}}、{{TILE_LAYER}}。 - 创建
index.md:使用assets/template-index.md模板,包含标题与概述、iframe 嵌入(<iframe src="main.html" width="100%" height="700" frameborder="0"></iframe>)、全屏链接、功能说明、自定义指南、技术细节、用例与参考。 - 创建
metadata.json:使用assets/template-metadata.json模板,包含 Dublin Core 字段及地图专属字段(map_type、center_lat、center_lng、zoom_level、marker_count、concepts、bloom_taxonomy)。 - 更新
mkdocs.yml导航,在 MicroSims 下添加新地图条目,标签使用 Title Case。 - 测试与验证:直接打开 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 支持。
关于收费、价格、平台支持范围等信息,资料中暂未提供。