Google Earth KML地标描述无法更新问题求助

我开发了一个生成Google Earth KML文件的应用，其中定义的可点击Placemark（地标）点击后会在弹出面板显示描述内容。此前功能正常，但现在点击第一个地标表现符合预期，点击后续地标时，弹窗标题更新但描述正文始终不变；关闭弹窗后重新点击地标则显示正常。

可复现问题的简化KML示例 #

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<kml:kml xmlns:gx="http://www.google.com/kml/ext/2.2" xmlns:kml="http://www.opengis.net/kml/2.2" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:xal="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0">
    <kml:Document>
        <kml:name>stackoverflow.adi</kml:name>
        <kml:open>1</kml:open>
        <kml:Style id="style_fixed">
            <kml:IconStyle>
                <kml:scale>1.0</kml:scale>
                <kml:heading>0.0</kml:heading>
                <kml:Icon>
                    <kml:href>https://maps.google.com/mapfiles/kml/shapes/ranger_station.png</kml:href>
                </kml:Icon>
            </kml:IconStyle>
            <kml:LabelStyle>
                <kml:color>ff43b3ff</kml:color>
                <kml:scale>1.0</kml:scale>
            </kml:LabelStyle>
        </kml:Style>
        <kml:Folder>
            <kml:name>Contacts</kml:name>
            <kml:open>1</kml:open>
            <kml:Folder>
                <kml:name>M0NOM</kml:name>
                <kml:open>1</kml:open>
                <kml:Folder>
                    <kml:name>M0NOM</kml:name>
                    <kml:open>0</kml:open>
                    <kml:Placemark>
                        <kml:name>M0NOM</kml:name>
                        <kml:description>&lt;html lang=&quot;en&quot;&gt;&lt;body&gt;M0NOM Body&lt;/body&gt;&lt;/html&gt;</kml:description>
                        <kml:LookAt>
                            <kml:longitude>-2.875</kml:longitude>
                            <kml:latitude>54.35416666666666</kml:latitude>
                            <kml:altitude>0.0</kml:altitude>
                            <kml:heading>0.0</kml:heading>
                            <kml:tilt>0.0</kml:tilt>
                            <kml:range>500.0</kml:range>
                        </kml:LookAt>
                        <kml:styleUrl>#style_fixed</kml:styleUrl>
                        <kml:Point>
                            <kml:coordinates>-2.875,54.35416666666666</kml:coordinates>
                        </kml:Point>
                    </kml:Placemark>
                </kml:Folder>
                <kml:Folder>
                    <kml:name>G8CPZ</kml:name>
                    <kml:open>0</kml:open>
                    <kml:Placemark id="20240207_12:00_G8CPZ">
                        <kml:name>G8CPZ</kml:name>
                        <kml:description>&lt;html lang=&quot;en&quot;&gt;&lt;body&gt;G8CPZ Body&lt;/body&gt;&lt;/html&gt;</kml:description>
                        <kml:LookAt>
                            <kml:longitude>-2.6999999999999886</kml:longitude>
                            <kml:latitude>54.30000000000001</kml:latitude>
                            <kml:altitude>0.0</kml:altitude>
                            <kml:heading>0.0</kml:heading>
                            <kml:tilt>0.0</kml:tilt>
                            <kml:range>500.0</kml:range>
                        </kml:LookAt>
                        <kml:styleUrl>#style_fixed</kml:styleUrl>
                        <kml:Point>
                            <kml:coordinates>-2.6999999999999886,54.30000000000001</kml:coordinates>
                        </kml:Point>
                    </kml:Placemark>
                </kml:Folder>
            </kml:Folder>
        </kml:Folder>
    </kml:Document>
</kml:kml>

问题原因 #

这是Google Earth的渲染缓存机制导致的：当弹窗处于打开状态切换地标时，Google Earth会复用现有弹窗的HTML容器，仅更新标题文本，但没有重新渲染描述部分的HTML内容，导致描述正文保持为第一个地标内容。

解决方案 #

1. 给所有Placemark添加唯一ID

原示例中第一个Placemark缺少唯一ID，补充后可帮助Google Earth区分不同地标，避免缓存混淆。修改第一个Placemark：

<kml:Placemark id="20240207_12:00_M0NOM">
    <kml:name>M0NOM</kml:name>
    <kml:description>&lt;html lang=&quot;en&quot;&gt;&lt;body&gt;M0NOM Body&lt;/body&gt;&lt;/html&gt;</kml:description>
    <!-- 其余代码保持不变 -->
</kml:Placemark>

2. 简化描述中的HTML结构

避免使用完整的<html>和<body>标签，直接使用纯文本或简化HTML片段，减少渲染冲突：

<!-- 纯文本描述 -->
<kml:description>M0NOM Body</kml:description>

<!-- 简化HTML -->
<kml:description>&lt;p&gt;M0NOM Body&lt;/p&gt;</kml:description>

3. 使用GX扩展强制刷新弹窗

借助Google Earth的GX扩展标签<gx:balloonVisibility>，强制切换地标时重新渲染弹窗，在每个Placemark中添加：

<kml:Placemark>
    <gx:balloonVisibility>1</gx:balloonVisibility>
    <!-- 其余代码保持不变 -->
</kml:Placemark>

验证 #

修改后重新生成KML文件并导入Google Earth，切换地标时弹窗的标题和描述会同步更新，无需关闭弹窗即可正常显示内容。

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