在地理信息处理和可视化项目中，我们经常需要把Google Earth中标注的地点导入自有系统。KML实质是基于XML的开放格式，坐标信息通常以文本形式存放在特定子节点里。用C++解析这类文件，核心任务是正确遍历XML树并提取字符串再转换类型。
一、KML坐标点的结构特征
一个最简单的Placemark包含Point和coordinates标签，coordinates内部的文本形如116.397128,39.916527,0，依次是经度、纬度、高程，使用英文逗号分隔。当存在LineString或Polygon时，coordinates里会出现多组坐标，每组占一行或以空格分开，但分隔逻辑不变。
理解这个结构是写解析代码的前提。如果误把纬度当经度，后续所有空间计算都会偏差数百公里。另外KML可能带命名空间xmlns="http://www.opengis.net/kml/2.2"，用普通字符串查找节点时务必忽略前缀影响，否则容易返回空指针。
二、选用tinyxml2读取文档
tinyxml2是一个适合嵌入式和小型服务的C++ XML解析库，编译简单且不需要依赖其他组件。我们可以从官方仓库获取源码，把tinyxml2.h与tinyxml2.cpp直接加入工程。下面示例展示如何加载KML并定位第一个Point坐标。
#include "tinyxml2.h"
#include <iostream>
#include <string>
#include <sstream>
#include <vector>
struct GeoPoint {
double lon;
double lat;
double alt;
};
// 解析单个coordinates文本
bool parseCoord(const std::string& text, GeoPoint& pt) {
// KML格式: lon,lat,alt
std::stringstream ss(text);
std::string item;
std::vector<std::string> parts;
while (std::getline(ss, item, ',')) {
parts.push_back(item);
}
if (parts.size() < 2) return false;
try {
pt.lon = std::stod(parts[0]);
pt.lat = std::stod(parts[1]);
pt.alt = parts.size() > 2 ? std::stod(parts[2]) : 0.0;
} catch (...) {
return false;
}
return true;
}
int main() {
tinyxml2::XMLDocument doc;
if (doc.LoadFile("sample.kml") != tinyxml2::XML_SUCCESS) {
std::cerr << "无法打开KML文件" << std::endl;
return -1;
}
// 忽略命名空间，直接按名字找节点
tinyxml2::XMLElement* coord = doc.FirstChildElement("kml")
->FirstChildElement("Document")
->FirstChildElement("Placemark")
->FirstChildElement("Point")
->FirstChildElement("coordinates");
if (coord && coord->GetText()) {
GeoPoint p;
if (parseCoord(coord->GetText(), p)) {
std::cout << "经度:" << p.lon << " 纬度:" << p.lat << " 高程:" << p.alt << std::endl;
}
}
return 0;
}
上述代码假设KML路径固定且结构标准。实际文件里Document可能嵌套Folder，Placemark也不一定紧跟Point，因此硬编码层级在生产环境不够稳健。更好的做法是递归搜索所有名为coordinates的元素，再判断其父链是否包含几何类型。
使用tinyxml2的优点是接口直观，FirstChildElement与GetText能快速取数；缺点是遇到超大KML（几十MB）时全量DOM加载会占用较多内存。若仅抽取坐标且文件庞大，可考虑改用SAX模式或RapidXML。
三、批量提取多组坐标
当KML记录了一条轨迹，coordinates文本会包含多行数据。我们需要按空白符切分每段，再逐段调用前面的解析函数。下面给出遍历全部Placemark下Point的示例片段。
#include <algorithm>
#include <cctype>
void trim(std::string& s) {
s.erase(s.begin(), std::find_if(s.begin(), s.end(), [](int ch) {
return !std::isspace(ch);
}));
s.erase(std::find_if(s.rbegin(), s.rend(), [](int ch) {
return !std::isspace(ch);
}).base(), s.end());
}
void collectPoints(tinyxml2::XMLElement* root, std::vector<GeoPoint>& out) {
for (tinyxml2::XMLElement* e = root->FirstChildElement(); e; e = e->NextSiblingElement()) {
if (std::string(e->Name()) == "coordinates") {
const char* txt = e->GetText();
if (txt) {
std::string block(txt);
std::stringstream ss(block);
std::string line;
while (std::getline(ss, line)) {
trim(line);
if (line.empty()) continue;
GeoPoint p;
if (parseCoord(line, p)) out.push_back(p);
}
}
}
collectPoints(e, out);
}
}
递归函数collectPoints会从根节点向下扫描，无论coordinates藏在Folder还是多层Group中都能捕获。对每行先做trim去掉换行与空格，避免std::stod转换时出现格式异常。
如果KML里同时存在Point与LineString，你可以通过检查coordinates父节点的标签名来区分类型。例如父节点是Point则单点入库，是LineString则连成折线。这样解析出的数据结构更贴合业务层渲染需求。
四、常见错误与处理建议
第一，很多解析失败源于文件声明了默认命名空间，而tinyxml2的FirstChildElement不匹配带前缀的节点。解决方法是忽略命名空间，只用本地名比较，如上例直接用"coordinates"即可。
第二，高程字段有时被省略，直接写116.39,39.91。我们的parseCoord已经用parts.size() > 2做了保护，缺失时补零，不会抛异常。第三，坐标字符串中可能混入不可见Unicode空格，建议在切分前统一替换为普通空格再做流式读取。
| 问题现象 | 可能原因 | 应对方式 |
|---|---|---|
| 取到的文本为空 | 节点层级写死导致未命中 | 改用递归或XPath风格搜索 |
| 转换抛异常 | 包含空格或非法字符 | trim并捕获std::exception |
| 经纬度颠倒 | 误认逗号顺序 | 牢记KML为经度在前 |
把握住KML的XML本质与坐标书写约定，C++解析工作就变得非常机械且可靠。将提取结果存入std::vector<GeoPoint>后，无论是写进数据库还是投影到平面地图，都只需关注业务逻辑本身。