道

表格转KML点位是空间数据可视化的关键环节。在地理信息领域，表格数据是最常见的数据存储形式，而KML是Google Earth等地理信息系统的标准数据格式。本工具通过将结构化表格数据转换为可视化的KML文件，实现数据从数字到图形的飞跃。

数据的价值在于被理解和应用。通过将枯燥的表格数据转换为直观的地图标记，我们让数据获得了空间维度的表达能力。这不仅是格式转换，更是数据价值的升华，让复杂的数据变得直观易懂，为决策提供有力支持。

法

表格转KML点位遵循标准化的数据转换流程，确保转换结果的准确性和可视化效果。

转换流程

1. 数据导入：读取CSV或Excel格式的点位数据，识别表头结构。

2. 数据验证：对每一行数据进行格式校验，验证坐标范围、颜色值有效性等。

3. 数据分组：根据文件夹字段对点位进行分组，便于在地图上分层展示。

4. 样式定义：收集所有不重复的颜色值，为每种颜色创建对应的KML样式定义。

5. KML生成：遍历所有点位，根据其颜色和分组信息生成Placemark标记。

6. 文件组装：将样式定义和点位标记组合成完整的KML文档结构。

7. 文件导出：生成KML文件并触发浏览器下载。

颜色处理策略

• 中文颜色名：支持常见中文颜色名称（如红色、蓝色、绿色等），自动映射到对应的Google图钉图标
• Hex颜色值：支持十六进制颜色代码（如#FF0000），使用白底图标叠加颜色
• 颜色映射：建立颜色到图钉图标的映射表，确保视觉一致性

KML结构设计

• Document：根元素，包含样式定义和文件夹
• Style：定义图标的颜色、大小、标签样式
• Folder：按文件夹字段分组的点位集合
• Placemark：单个点位标记，包含名称、描述和坐标

验证规则

• 坐标范围：经度-180至180，纬度-90至90
• 颜色格式：支持中文颜色名和Hex颜色值
• 必填字段：名称、经度、纬度为必填项

术

本工具采用现代化前端技术栈，实现高效的表格转KML点位功能。

核心技术依赖

xlsx

• 用途：读取Excel文件
• 官网：https://github.com/SheetJS/sheetjs
• 特点：支持多种Excel格式、处理效率高

关键实现

颜色解析

const CHINESE_COLOR_TO_PUSHPIN: Record<string, string> = {
  '#FF0000': 'red',
  '#00FF00': 'grn',
  '#0000FF': 'blue',
  '#FFFF00': 'ylw',
  '#FF00FF': 'pink',
  '#FFFFFF': 'wht',
}

function isChineseColor(color) {
  return !color.trim().startsWith('#')
}

KML生成

export function generateKml(points) {
  const folders = groupByFolder(points)
  const styles = collectStyles(points)
  
  // 生成样式定义
  const styleDefs = styles.map(([color, id]) => `
    <Style id="${id}">
      <IconStyle>
        <color>${kmlColor}</color>
        <Icon><href>${pushpinUrl}</href></Icon>
      </IconStyle>
    </Style>
  `)
  
  // 生成Placemark
  const placemarks = folders.map(folder => folder.points.map(pt => `
    <Placemark>
      <name>${pt.name}</name>
      <Point><coordinates>${pt.lng},${pt.lat},0</coordinates></Point>
    </Placemark>
  `))
  
  return `<?xml version="1.0" encoding="UTF-8"?>
    <kml xmlns="http://www.opengis.net/kml/2.2">
      <Document>${styleDefs.join('')}${placemarks.join('')}</Document>
    </kml>`
}

技术架构

采用模块化设计：TemplateReader负责文件读取和验证，KmlGenerator负责KML生成，ColorParser负责颜色处理，TemplateExporter负责模板导出。各模块职责清晰，便于测试和维护。