使用pykml生成KML文件时能否将图标图片嵌入其中？

KML标准本身支持直接嵌入base64编码的图片资源，无需依赖外部HTTP链接，只要将本地图标文件转成base64字符串，按指定格式填充到<Icon>的<href>字段即可，pykml支持自定义构造KML的各类节点，完全可以完成这个操作。

• 第一步：引入依赖，将本地图标转换为base64编码

import base64
from pykml.factory import KML_ElementMaker as KML
from lxml import etree

# 读取本地图标文件，转base64编码
with open("custom_icon.png", "rb") as f:
    icon_base64 = base64.b64encode(f.read()).decode("utf-8")
# 组装KML支持的内嵌资源链接格式
icon_href = f"data:image/png;base64,{icon_base64}"

• 第二步：构造嵌入base64图标的自定义Style节点

# 构造自定义图标样式
point_style = KML.Style(
    KML.IconStyle(
        KML.Icon(
            KML.href(icon_href)
        ),
        KML.scale(1.0) # 可根据需求调整图标缩放比例
    ),
    id="custom_point_style"
)

• 第三步：绑定样式到位点，生成最终KML文件

# 构造点位对象
test_point = KML.Placemark(
    KML.name("测试点位"),
    KML.styleUrl("#custom_point_style"),
    KML.Point(
        KML.coordinates("116.4039,39.9149,0") # 替换为实际点位经纬度
    )
)

# 组装完整KML结构
full_kml = KML.kml(
    KML.Document(
        point_style,
        test_point
        # 可继续添加更多点位、样式节点
    )
)

# 导出为KML文件
with open("embedded_icon.kml", "wb") as f:
    f.write(etree.tostring(full_kml, pretty_print=True, encoding="utf-8"))

• 单张图标大小建议控制在100KB以内，过大会导致KML体积大幅膨胀，Google Earth加载速度变慢
• 需根据图标实际格式修改href中的类型声明：JPG格式替换为data:image/jpeg;base64,，ICO格式替换为data:image/x-icon;base64,，格式不匹配会导致图标无法正常显示
• 最终生成的KML可直接本地打开，所有用户无需联网访问你的Web服务器就能正常查看点位自定义图标

内容的提问来源于stack exchange，提问作者Adrian