此页面由 Cloud Translation API 翻译。

KML 参考

本部分包含有关 KML 版本2.2中定义的所有 KML 元素以及 Google 扩展元素命名空间中的元素的参考（按字母顺序排列）。KML 元素的类树如下所示。在此图中，树中特定分支右侧的元素是其左侧的元素扩展。例如，地标是特殊类型的地图项。它包含属于 Feature 的所有元素，另外还添加一些 Placemark 元素所特有的元素。

KML 是一种开放式标准，其官方名称为“开放地理资讯编码标准”（OGC KML，OpenGIS® KML Encoding Standard），由 Open Geospatial Consortium, Inc. (OGC) 维护。访问 http://www.opengeospatial.org/standards/kml/，即可查看 OGC KML 的完整规范。

访问 http://schemas.opengis.net/kml/，即可查看 KML 的完整 XML 架构。

请注意：点击该图中的元素名称，即可跳转到参考部分中的相应条目。

请注意，KML 文件中不会真的使用抽象元素（上图中以方框标示）。它们是一种非常有用的编程方式，可用于将单个元素用作多个相似（但不相同）的派生元素的编程基础。同时，理解这一面向对象的层次结构可让您轻松了解相关元素的分组情况，因此也不失为学习 KML 的一个好方法。

所有派生自 Object 的元素都分配有一个 id。该 id 由 KML 更新机制（请参阅 <Update>）用于通过 NetworkLink 加载的文件。同时，共享样式（参见 <Style>）也使用该 ID。id 是标准的 XML ID。

KML 是一种 XML 语法和文件格式，因此标记名称区分大小写，而且必须与上图中的相应内容完全一致。如果您熟悉 XML，那么您也将会对KML 2.2架构感兴趣。编辑 KML 文本文件时，您可以将该架构加载到任何 XML 编辑器中，并用它来验证您的 KML 代码。

提示：查看 Google 地球地图项的 KML

Google 地球中提供了一个非常方便的功能，可让您轻松查看任意地图项的 KML 文件。在 Google 地球中，您可以右键点击“位置”面板中的某个地图项，并将其复制下来。要查看复制对象所对应的 KML，请打开您惯用的文本编辑器，然后将所选内容粘贴到编辑器中。

兼容性

KML 版本具有双重编号系统：majorVersion.minorVersion。具有相同 majorVersion 的所有版本都兼容。因此，如果您将命名空间更改为“2.2”（即 xmlns="http://www.opengis.net/kml/2.2"），则所有 KML 2.1 文件都会在 KML 2.2 架构中进行验证。

关于本参考

每个参考条目都包含一个“语法”部分，该部分列出了主元素中所包含的各个元素。语法部分是一个非正式列表，它使用简单的速记语言汇总了相应的元素。该部分还包含以下内容：

每个元素的默认值（如果是复杂元素或无默认值，则为省略号）
值的类型（请参阅 KML 字段）

您可以复制语法部分，并在 KML 文件中将其用作任意非抽象元素的模板。

KML 扩展元素命名空间和 gx 前缀

OGC KML 标准提供了一种扩展元素（即包含标准中未列信息的其他元素）机制（请访问 w3.org，了解有关 XML 命名空间的详情）。Google 地球5.0发布后，Google 提供了一些用以支持大量新地图项的 KML 扩展元素。这些扩展程序使用 gx 前缀和以下命名空间 URI：

xmlns:gx="http://www.google.com/kml/ext/2.2"

此命名空间 URI 必须使用 gx- 前缀元素添加到任意 KML 文件中的 <kml> 元素：

<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

并非所有的地理浏览器都支持 KML 的各种扩展元素。如果您的浏览器不支持某些特定的扩展元素，则会忽略这些扩展元素中的数据而不进行提示；同时还会正确加载 KML 文件的其余部分。

目前使用 gx 前缀的元素有：

gx:heightMode
gx:heightOffset
gx:angles
gx:AnimatedUpdate
gx:气球可见性
gx:coord
gx:delayedStart
gx:drawOrder
gx:duration
gx:FlyTo
gx:flyToMode
gx:h
gx:horizFov
gx:interpolate
gx:labelVisibility
gx:LatLonQuad
gx:MultiTrack
gx:vieweroptions
gx:outerColor
gx:outerWidth
gx:physicalWidth
gx:播放列表
gx:playMode
gx:SoundCue
gx:TimeSpan
gx:TimeStamp
gx：游览
gx:TourControl
gx:TourPrimitive
gx:Track
gx:ViewerOptions
gx:w
gx:Wait
gx:x
gx:y

访问 http://developers.google.com/kml/schema/kml22gx.xsd，即可查看该扩展元素命名空间中元素的完整 XML 架构。

KML 字段

KML 使用常见的布尔值类型，如布尔值、字符串、双精度、浮点数和整数。此外，它还定义了许多字段元素类型。下表列出了 KML 中定义的一些最常用的类型，以及指向使用这些类型的示例元素的链接：

字段类型	价值	用法示例
heightModeEnum	clampToGround、relativeToGround、absolute	参见 <LookAt> 和 <Region>
角度 90	大于等于−90且小于等于90的值	参见 <Model> 中的 <latitude>
anglepos90	大于等于0且小于等于90的值	参见 <LookAt> 中的 <tilt>
角度 180	大于等于−180且小于等于180的值	参见 <Model> 中的 <longitude>
角度 360	大于等于−360且小于等于360的值	请参阅 <Orientation> 中的 <head>
颜色	十六进制数值：aabbggrr	查看对 <ColorStyle> 进行扩展的任意元素
colorModeEnum	普通、随机	查看对 <ColorStyle> 进行扩展的任意元素
日期时间	dateTime、date、gYearMonth、gYear	参见 <TimeSpan> 和 <TimeStamp>
displayModeEnum	默认、隐藏	参见 <BalloonStyle>
gridOrigin	bottomLeft、upLeft	参见 <PhotoOverlay>
刷新模式枚举	onChange、onInterval、onExpire	参见 <Link>
shapeEnum	矩形、圆柱体、球体	参见 <PhotoOverlay>
styleStateEnum	normal、highlight	参见 <StyleMap>
unitsEnum	比例、像素、insetPixels	参见 <IconStyle> 中的 <hotSpot>，或参见 <ScreenOverlay>
vec2	x=double xunits=KML:unitsEnum y=double yunits=KML:unitsEnum	请参阅 <IconStyle> 中的 <hotSpot>、 <ScreenOverlay>
viewRefreshEnum	never、onRequest、onStop、onRegion	参见 <Link>

<抽象视图>

语法

<!-- abstract element; do not create -->
<!-- AbstractView -->                       <!-- Camera, LookAt -->
  <!-- extends Object -->
  <TimePrimitive>...</TimePrimitive>        <!-- gx:TimeSpan or gx:TimeStamp -->
  <gx:ViewerOptions>
    <gx:option name="" enabled=boolean />   <!-- name="streetview",
                                                      "historicalimagery",
                                                   or "sunlight" -->
  </gx:ViewerOptions>
<-- /AbstractView -->

说明

这是一个抽象元素，不能直接在 KML 文件中使用。该元素的扩展元素为 <Camera> 和 <LookAt>。

扩展源

<对象>

AbstractView 的特有元素

<gx:ViewerOptions>: 该元素可在 Google 地球 6.0 及更高版本中启用特殊查看模式。它有一个或多个 <gx:option> 子元素。<gx:option> 元素具有 name 属性和 enabled 属性。name 指定下列其中一项：街景图像（“街景”）、历史图像（“历史图像”）以及一天中给定时间的光照效果（“光照”）。enabled 属性用于开启或关闭指定的查看模式。
<gx:horizFov>: 定义游览期间 AbstractView 的水平视野。此元素不会影响游览之外的 AbstractView。在游览录制期间，Google 地球客户端（版本 6.1 及更高版本）会自动插入 <gx:horizFov>。常规 AbstractView 的值为 60；街景中的视图的值为 85，以与 Google 地球中的标准街景视野相匹配。设置后，该值将应用于后续视图，直到指定新值。

<gx:altitudeMode>

该元素是OGC KML 2.2标准的扩展元素，并且受 Google 地球5.0及更高版本的支持。了解详情

语法

<gx:altitudeMode>clampToGround</gx:altitudeMode>
  <!-- gx:altitudeModeEnum: relativeToSeaFloor, clampToSeaFloor, relativeToGround, clampToGround, absolute -->

说明

可用于替代 OGC KML 标准 <altitudeMode> 元素，且除了标准 heightMode 值外，还接受以下值：

relativeToSeaFloor - 将高度解释为以海底为基准的值（以米为单位）。如果 KML 地图项位于陆地上方而不是海面上方，则会将高度解释为地面以上的高度。
clampToSeaFloor - 用于忽略高度规范，并将 KML 地图项置于海底。如果 KML 地图项位于陆地上而不是海上，那么 clampToSeaFloor 会将其固定到地面上。

与 <altitudeMode> 一样，<gx:altitudeMode> 会影响：

<coordinates> 元素内的海拔坐标
<LatLonAltBox> 中的 <minAltitude> 和 <maxAltitude>
<Location>、<GroundOverlay> 和 AbstractView（<LookAt> 和 <Camera>）中的 <altitude>。

有关海拔模式的详情，请参阅 KML 开发者指南中的海拔模式章节。

示例

altitudemode_reference.kml

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">   <!-- required when using gx-prefixed elements -->

<Placemark>
  <name>gx:altitudeMode Example</name>
  <LookAt>
    <longitude>146.806</longitude>
    <latitude>12.219</latitude>
    <heading>-60</heading>
    <tilt>70</tilt>
    <range>6300</range>
    <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
  </LookAt>
  <LineString>
    <extrude>1</extrude>
    <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
    <coordinates>
      146.825,12.233,400
      146.820,12.222,400
      146.812,12.212,400
      146.796,12.209,400
      146.788,12.205,400
    </coordinates>
  </LineString>
</Placemark>

</kml>

<gx:AnimatedUpdate>

该元素是OGC KML 2.2标准的扩展元素，并且受 Google 地球5.0及更高版本的支持。了解详情

语法

<gx:AnimatedUpdate id="ID">
  <gx:duration>0.0</gx:duration>     <!-- double, specifies time in seconds -->
  <Update>
    <targetHref>...</targetHref>     <!-- required; can contain a URL or be left blank -->
                                      <!-- (to target elements within the same file) -->
    <Change>...</Change>
    <Create>...</Create>
    <Delete>...</Delete>
  </Update>
  <gx:delayedStart>0</gx:delayedStart>  <!-- double, specifies time in seconds -->
</gx:AnimatedUpdate>

说明

<gx:AnimatedUpdate> 可使用 <Update> 控制游览期间对 KML 地图项的更改。更改 KML 地图项不会修改 DOM，也就是说，游览结束后所有更改都将还原，而且更改不会保存在 KML 中。

<gx:AnimatedUpdate> 还应包含一个 <gx:duration> 值，用于指定更新所需的时长（以秒为单位）。在该时间段内，系统会动态平稳地将 integer、float 和 color 字段从原始值更改为新值；而 boolean、string 和其他不适合使用插值类型方法的值则会在此时间段结束后进行更新。

有关 <gx:AnimatedUpdate> 和游览时间轴的信息，请参见 KML 开发者指南的游览一章中的游览时间轴。

<gx:duration>: 指定更新所需的时长（以秒为单位）。
<gx:delayedStart>: 指定在开始更新之前等待（内嵌起始位置之后）的秒数。

示例

以下示例演示了图标大小的更改过程，该动画时长5秒钟。

animatedupdate_example.kml

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

<Document>
  <name>gx:AnimatedUpdate example</name>

  <Style id="pushpin">
    <IconStyle id="mystyle">
      <Icon>
        <href>http://maps.google.com/mapfiles/kml/pushpin/ylw-pushpin.png</href>
        <scale>1.0</scale>
      </Icon>
    </IconStyle>
  </Style>

  <Placemark id="mountainpin1">
    <name>Pin on a mountaintop</name>
    <styleUrl>#pushpin</styleUrl>
    <Point>
      <coordinates>170.1435558771009,-43.60505741890396,0</coordinates>
    </Point>
  </Placemark>

  <gx:Tour>
    <name>Play me!</name>

    <gx:Playlist>

      <gx:FlyTo>
        <gx:flyToMode>bounce</gx:flyToMode>
        <gx:duration>3</gx:duration>
        <Camera>
          <longitude>170.157</longitude>
          <latitude>-43.671</latitude>
          <altitude>9700</altitude>
          <heading>-6.333</heading>
          <tilt>33.5</tilt>
        </Camera>
      </gx:FlyTo>

      <gx:AnimatedUpdate>
        <gx:duration>5</gx:duration>
        <Update>
          <targetHref></targetHref>
          <Change>
            <IconStyle targetId="mystyle">
              <scale>10.0</scale>
            </IconStyle>
          </Change>
        </Update>
      </gx:AnimatedUpdate>

      <gx:Wait>
        <gx:duration>5</gx:duration>
      </gx:Wait>

    </gx:Playlist>
  </gx:Tour>

</Document>
</kml>

扩展源

<gx:TourPrimitive>

包含元素

<gx:duration>
<更新>

<BalloonStyle>

语法

<BalloonStyle id="ID">
  <!-- specific to BalloonStyle -->
  <bgColor>ffffffff</bgColor>            <!-- kml:color -->
  <textColor>ff000000</textColor>        <!-- kml:color -->
  <text>...</text>                       <!-- string -->
  <displayMode>default</displayMode>     <!-- kml:displayModeEnum -->
</BalloonStyle>

说明

指定如何绘制地标的说明提示框。<bgColor>（如果指定）的值所代表的颜色将用作提示框的背景色。有关默认说明提示框在 Google 地球中的显示形式的图示说明，请参见 <Feature>。

BalloonStyle 的特有元素

<bgColor>

提示框的背景颜色（可选）。颜色值和透明度 (alpha) 值以十六进制表示法表示。任何一种颜色值的范围都是 0 到 255（00 到 ff）。表达式的顺序是 aabbggrr，其中 aa=alpha（00 到 ff）；bb=blue（00 到 ff）；gg=green（00 到 ff）；rr=red（00 到 ff）。对于 Alpha 版，00 是完全透明的，ff 是完全不透明的。例如，如果要对叠加层应用透明度为 50% 的蓝色，您需要指定以下内容：<bgColor>7fff0000</bgColor>，其中 alpha=0x7f、blue=0xff、green=0x00 和 red=0x00。默认的背景色为不透明的白色 (ffffffff)。

注意：<BalloonStyle> 内已弃用 <color> 元素，请改为使用 <bgColor>。

<textColor>

文本的前景颜色。默认为黑色 (ff000000)。

<text>

提示框中显示的文字。如果未指定文字，Google 地球将绘制默认提示框（如果地图项 <name> 以粗体显示、地图项 <description>、行车路线链接、白色背景以及指向该地图项点坐标的尾部，则必须指定）。

您可以使用以下格式向 <text> 标记添加实体，以引用地图项的子元素：$[name]、$[description]、$[address]、$[id]、$[Snippet]。Google 地球会在当前的地图项中查找对应的字符串实体并替换提示框中的相应信息。要在提示框中添加前往此处 -“从此处出发”行车路线，请使用 $[geDirections] 标签。为防止行车路线链接显示在提示框中，请添加带有某些内容或使用 $[description] 的 <text> 元素，以替换基本地图项 <description>。

例如，在以下 KML 摘录中，$[name] 和 $[description] 字段将被替换为使用该样式的地图项样式

<text>This is $[name], whose description is:<br/>$[description]</text>

中的 <name> 和 <description> 字段：

<displayMode>

如果 <displayMode> 为默认值，Google 地球会使用 <text> 中提供的信息创建提示框。如果 <displayMode> 为“hide”，则 Google 地球将不显示提示框。在 Google 地球中，对于提示框的 <displayMode> 为“hide”的地标，点击该地标的“列表视图”图标即可让 Google 地球飞到该地标。

示例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>BalloonStyle.kml</name>
  <open>1</open>
  <Style id="exampleBalloonStyle">
    <BalloonStyle>
      <!-- a background color for the balloon -->
      <bgColor>ffffffbb</bgColor>
      <!-- styling of the balloon text -->
      <text><![CDATA[
      <b><font color="#CC0000" size="+3">$[name]</font></b>
      <br/><br/>
      <font face="Courier">$[description]</font>
      <br/><br/>
      Extra text that will appear in the description balloon
      <br/><br/>
      <!-- insert the to/from hyperlinks -->
      $[geDirections]
      ]]></text>
    </BalloonStyle>
  </Style>
  <Placemark>
    <name>BalloonStyle</name>
    <description>An example of BalloonStyle</description>
    <styleUrl>#exampleBalloonStyle</styleUrl>
    <Point>
      <coordinates>-122.370533,37.823842,0</coordinates>
    </Point>
  </Placemark>
</Document>
</kml>

扩展源

<ColorStyle

包含方

<样式>

返回页首

<gx:balloonVisibility>

该元素是OGC KML 2.2标准的扩展元素，并且受 Google 地球5.0及更高版本的支持。了解详情

语法

<gx:balloonVisibility>0</gx:balloonVisibility>    <!-- 0 (not visible) or 1 (visible) -->

说明

用于切换是否显示说明提示框。要更新的提示框必须通过对象的 XML ID（例如 <Placemark targetId="xxx">）标识。

示例

第一个示例展示了 <gx:balloonVisibility> 和地标。加载该地标时，系统会打开该说明提示框。
气球可见性示例_KML

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

  <Placemark>
    <name>Eiffel Tower</name>
    <description>
        Located in Paris, France. 
        
        This description balloon opens 
        when the Placemark is loaded.
    </description>
    <gx:balloonVisibility>1</gx:balloonVisibility>
    <Point>
      <coordinates>2.294785,48.858093,0</coordinates>
    </Point>
  </Placemark>

</kml>

第二个示例展示了 <gx:balloonVisibility> 在游览中的使用。系统会在游览过程中打开和关闭多个提示框，从而为查看者提供相关信息。
气球可见性

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

  <Document>
    <name>balloonVisibility Example</name>
    <open>1</open>

    <gx:Tour>
      <name>Play me</name>
      <gx:Playlist>

        <gx:FlyTo>
          <gx:duration>8.0</gx:duration>
          <gx:flyToMode>bounce</gx:flyToMode>
          <LookAt>
            <longitude>-119.748584</longitude>
            <latitude>33.736266</latitude>
            <altitude>0</altitude>
            <heading>-9.295926</heading>
            <tilt>84.0957450</tilt>
            <range>4469.850414</range>
            <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
          </LookAt>
        </gx:FlyTo>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater1">
                <gx:balloonVisibility>1</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:Wait>
          <gx:duration>4.0</gx:duration>
        </gx:Wait>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater1">
                <gx:balloonVisibility>0</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:FlyTo>
          <gx:duration>3</gx:duration>
          <gx:flyToMode>smooth</gx:flyToMode>
          <LookAt>
            <longitude>-119.782630</longitude>
            <latitude>33.862855</latitude>
            <altitude>0</altitude>
            <heading>-9.314858</heading>
            <tilt>84.117317</tilt>
            <range>6792.665540</range>
            <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
          </LookAt>
        </gx:FlyTo>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater2">
                <gx:balloonVisibility>1</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:Wait>
          <gx:duration>4.0</gx:duration>
        </gx:Wait>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater2">
                <gx:balloonVisibility>0</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:FlyTo>
          <gx:duration>3</gx:duration>
          <gx:flyToMode>smooth</gx:flyToMode>
          <LookAt>
            <longitude>-119.849578</longitude>
            <latitude>33.968515</latitude>
            <altitude>0</altitude>
            <heading>-173.948935</heading>
            <tilt>23.063392</tilt>
            <range>3733.666023</range>
            <altitudeMode>relativeToGround</altitudeMode>
          </LookAt>
        </gx:FlyTo>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="onland">
                <gx:balloonVisibility>1</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:Wait>
          <gx:duration>4.0</gx:duration>
        </gx:Wait>

      </gx:Playlist>
    </gx:Tour>

    <Placemark id="underwater1">
      <name>Underwater off the California Coast</name>
      <description>
        The tour begins near the Santa Cruz Canyon,
        off the coast of California, USA.
      </description>
      <Point>
        <gx:altitudeMode>clampToSeaFloor</gx:altitudeMode>
        <coordinates>-119.749531,33.715059,0</coordinates>
      </Point>
    </Placemark>

    <Placemark id="underwater2">
      <name>Still swimming...</name>
      <description>We're about to leave the ocean, and visit the coast...</description>
      <Point>
        <gx:altitudeMode>clampToSeaFloor</gx:altitudeMode>
        <coordinates>-119.779550,33.829268,0</coordinates>
      </Point>
    </Placemark>

    <Placemark id="onland">
      <name>The end</name>
      <description>
        <![CDATA[The end of our simple tour.
        Use <gx:balloonVisibility>1</gx:balloonVisibility>
        to show description balloons.]]>
      </description>
      <Point>
        <coordinates>-119.849578,33.968515,0</coordinates>
      </Point>
    </Placemark>


  </Document>
</kml>

扩展

<功能>

<Camera>

语法

<Camera id="ID">
  <!-- inherited from AbstractView element -->
  <TimePrimitive>...</TimePrimitive>  <!-- gx:TimeSpan or gx:TimeStamp -->
  <gx:ViewerOptions>
    <option> name=" " type="boolean">     <!-- name="streetview", "historicalimagery", "sunlight", or "groundnavigation" -->
    </option>
  </gx:ViewerOptions>

  <!-- specific to Camera -->
  <longitude>0</longitude>            <!-- kml:angle180 -->
  <latitude>0</latitude>              <!-- kml:angle90 -->
  <altitude>0</altitude>              <!-- double -->
  <heading>0</heading>                <!-- kml:angle360 -->
  <tilt>0</tilt>                      <!-- kml:anglepos180 -->
  <roll>0</roll>                      <!-- kml:angle180 -->
  <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: relativeToGround, clampToGround, or absolute -->
        <!-- or, gx:altitudeMode can be substituted: clampToSeaFloor, relativeToSeaFloor -->
</Camera>

说明

定义用于查看场景的虚拟镜头。该元素定义了镜头相对于地表的位置以及镜头的查看方向。镜头位置由 <经度>、<纬度>、<高度> 以及 <海拔模式> 或 <gx:heightMode> 定义。镜头的查看方向由 <head>、<tilt> 和 <roll> 定义。<Camera> 可以是任何地图项的子元素，也可以是 <NetworkLinkControl> 的子元素。<父元素时间不得同时包含 <CameraLink>。

<Camera> 能够对视图提供六个方位的全面自由控制，因此您可以在空间中定位镜头，然后使它绕着 X、Y 和 Z 轴旋转。最重要的是，您可以倾斜镜头视图，以便越过地平线观察星空。

<Camera> 还可以包含 TimePrimitive（<gx:TimeSpan> 或 <gx:TimeStamp>）。相机中的时间值会影响历史图像、光照以及带有时间戳的地图项的显示。有关详情，请参见《开发者指南》的“时间和动画”一章中的“使用 AbstractView 指定时间”。

定义视图

在 Feature 或 <NetworkLinkControl> 中，使用 <Camera> 或 <LookAt> 对象（但不能在同一个对象中同时使用）。<Camera> 对象会根据查看者的位置和方向定义视点。通过 <Camera> 对象，您可以指定不位于地表的视图。<LookAt> 对象根据所查看的对象定义视点。<LookAt> 对象在视野方面的局限性要大于 <Camera>，且通常要求查看方向与地表相交。

下图显示了附加于虚拟镜头的 X、Y 和 Z 轴。

X 轴指向镜头右侧，称为“向右矢量”。
Y 轴定义相对于屏幕的“向上”方向，称为“向上矢量”。
Z 轴从屏幕的中心指向视点（镜头向下沿着 Z 轴方向，称为“查看矢量”）。

转换顺序

旋转的顺序很重要。默认情况下，镜头沿 −Z 轴垂直俯瞰地球。在执行旋转之前，相机会沿着 Z 轴转换到相应的高度。转换顺序如下：

<altitude> - 沿 Z 轴转换到 <height>
<heading> - 绕 Z 轴旋转。
<tilt> - 绕 X 轴旋转。
<roll> -（再次）绕 Z 轴旋转。

请注意，每次进行旋转时，两条镜头轴都会改变方向。

Camera 的特有元素

<longitude>

虚拟摄像头的经度（视点）。相对于本初子午线的角度距离（以度为单位）。子午线以西的值的范围是-180度到0度。子午线以东的值的范围是0度到180度。

<latitude>

虚拟相机的纬度。赤道（0度）以北或以南的度数。值的范围是-90度到90度。

<altitude>

相机与地表之间的距离（以米为单位）。根据相机的 <heightMode> 或 <gx:heightMode> 进行解释。

<heading>

摄像头的方向（方位），以度为单位。默认值 = 0（正北方向）（参见下图）。值的范围是0度到360度。

<tilt>

相机绕 X 轴旋转的角度（以度为单位）。值为0表示垂直俯瞰地球（最常见的情况）。<tilt> 的值为90表示视线沿着地平线。值大于90表示视线向上倾斜，指向天空。<tilt> 的值最大为+180度。

<roll>

相机绕 Z 轴旋转的角度（以度为单位）。值的范围是-180度到+180度。

<altitudeMode>

指定如何解释为相机指定的 <height>。可能的值如下所示：

relativeToGround - （默认值）将 <altitude> 解释为地面以上的高度值（以米为单位）。如果相应点在水面之上，则会将 <altitude> 解释为海平面以上的高度值（以米为单位）。请参阅下面的 <gx:heightMode>，指定相对于海底的点。
clampToGround - 如果是应用于镜头，此设置与 relativeToGround 的效果相同，因为将镜头放置在与地形高度完全相同的高度上，意味着视点和地形相交（因此视线会受到阻挡）。
absolute - 将 <altitude> 解释为海平面以上的高度值（以米为单位）。

<gx:altitudeMode>

Google 扩展元素命名空间中的 KML 扩展元素，允许存在以海底为基准的高度。具体值包括：

relativeToSeaFloor - 将 <altitude> 解释为以海底为基准的高度值（以米为单位）。如果相应的点位于陆地上方而不是海面上方，则会将 <altitude> 解释为地面以上的高度。
clampToSeaFloor - 用于忽略 <altitude> 规范，并将 LookAt 置于海底。如果相应的点位于陆地上方而不是海面上方，则会将镜头置于地面上。

扩展源

<抽象视图>

包含方

派生自 <Feature> 的任何元素
<网络链接控件>

返回页首

<ColorStyle>

语法

<!-- abstract element; do not create -->
<!-- ColorStyle id="ID" -->          <!-- IconStyle,LabelStyle,LineStyle,PolyStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum: normal or random -->
<!-- /ColorStyle -->

说明

这是一个抽象元素，不能直接在 KML 文件中使用。它提供了一些元素，可用于指定扩展样式类型的颜色和颜色模式。

ColorStyle 的特有元素

<color>: 颜色和不透明度 (alpha) 值以十六进制表示法表示。任何一种颜色的值的范围都是 0 到 255（00 到 ff）。对于 Alpha 值，00 是完全透明的，ff 是完全不透明的。表达式的顺序是 aabbggrr，其中 aa=alpha（00 到 ff）；bb=blue（00 到 ff）；gg=green（00 到 ff）；rr=red（00 到 ff）。例如，如果要对叠加层应用透明度为 50% 的蓝色，您需要指定以下内容：<color>7fff0000</color>，其中 alpha=0x7f、blue=0xff、green=0x00 和 red=0x00。
<colorMode>: <colorMode> 的值为 normal（无效果）和 Random。随机值会向基本 <color> 应用随机线性标度，如下所示。

要实现真正随机的颜色选择，请将基本 <color> 指定为白色 (ffffffff)。
如果您指定了单个颜色成分（例如，表示红色的值 ff0000ff），系统就会选择该成分（红色）的随机颜色值。在这种情况下，值的范围是 00（黑色）到 ff（全红）。
如果您为两种或全部三种颜色成分都指定了值，系统会对每种颜色成分应用随机线性标尺，所得结果的范围是黑色到为每种成分指定的最大值。
颜色的透明度取决于 <color> 的 alpha 成分，而且在任何情况下都不会随机选择。

扩展源

对象>

扩展元素

<图标样式>
<标签样式>
<线条样式>
<PolyStyle>

返回页首

<Container>

语法

<!-- abstract element; do not create -->
<!-- Container id="ID" -->              <!-- Document,Folder -->
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <address>...</address>                <!-- string -->
  <AddressDetails xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0">...
      </AddressDetails>                 <!-- string -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- LookAt or Camera -->
  <TimePrimitive>...</TimePrimitive>
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>
  <atom:author>...<atom:author>   <!-- xmlns:atom="http://www.w3.org/2005/Atom" -->
  <atom:link href=" "/>

  <!-- specific to Container --> 
  <!-- 0 or more Features -->
<!-- /Container -->

说明

这是一个抽象元素，不能直接在 KML 文件中使用。一个 Container 元素持有一个或多个地图项，并且允许创建嵌套层次。

扩展源

<功能>

扩展元素

<文档>
<文件夹>

返回页首

<Document>

语法

<Document id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>                 <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- Camera or LookAt -->
  <TimePrimitive>...</TimePrimitive>
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>              <!-- deprecated in KML 2.2 -->
  <ExtendedData>...</ExtendedData>      <!-- new in KML 2.2 -->

  <!-- specific to Document -->
  <!-- 0 or more Schema elements -->
  <!-- 0 or more Feature elements -->
</Document>

说明

Document 是地图项和样式的容器。如果您的 KML 文件使用共享样式，则该元素是必需的。建议您使用共享样式，具体步骤如下：

在 Document 中定义所有样式。为每个样式分配一个唯一的 ID。

在给定的地图项或 StyleMap 中，使用 <styleUrl> 元素引用样式 ID。

请注意，文档中的功能不会沿用共享样式。

每个地图项都必须明确引用它在 <styleUrl> 元素中使用的样式。对于适用于 Document 的样式（例如 ListStyle），Document 本身必须明确引用 <styleUrl>。例如：

<Document>
  <Style id="myPrettyDocument">
   <ListStyle> ... </ListStyle>

  </Style>
  <styleUrl#myPrettyDocument">
  ...
</Document>

请勿将共享样式放入一个文件夹，

下面的示例说明了如何使用共享样式。

示例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>Document.kml</name>
  <open>1</open>
  <Style id="exampleStyleDocument">
    <LabelStyle>
      <color>ff0000cc</color>
    </LabelStyle>
  </Style>
  <Placemark>
    <name>Document Feature 1</name>
    <styleUrl>#exampleStyleDocument</styleUrl>
    <Point>
      <coordinates>-122.371,37.816,0</coordinates>
    </Point>
  </Placemark>
  <Placemark>
    <name>Document Feature 2</name>
    <styleUrl>#exampleStyleDocument</styleUrl>
    <Point>
      <coordinates>-122.370,37.817,0</coordinates>
    </Point>
  </Placemark>
</Document>
</kml>

扩展源

<容器>

包含元素

派生自 <Feature> 的0个或多个元素
派生自 <StyleSelector> 的0个或多个元素
派生自 <Schema> 的 0 个或多个元素

返回页首

<gx:duration>

该元素是OGC KML 2.2标准的扩展元素，并且受 Google 地球5.0及更高版本的支持。了解详情

语法

<gx:duration>0.0</gx:duration>            <!-- double -->

说明

<gx:duration> 通过指定事件的时间范围来扩展 gx:TourPrimitive。该时间使用 XML 的 double 数据类型表示，以秒为单位。

duration 和 <gx:FlyTo>

如果 <gx:FlyTo> 元素中包含时长，则用于指定浏览器从前一个点飞到指定点所需的时长。

<gx:FlyTo>
  <gx:flyToMode>bounce</gx:flyToMode>
  <gx:duration>10.2</gx:duration>

  <!-- AbstractView -->
    ...
  <!-- /AbstractView -->
</gx:FlyTo>

duration 和 <gx:AnimatedUpdate>

指定更新所需的时长。在该时间段内，系统会动态平稳地将 integer、float 和 color 字段从原始值更改为新值；而 boolean、string 和其他不适合使用插值类型方法的值则会在此时间段结束后进行更新。

<gx:AnimatedUpdate>
  <gx:duration>5.0</gx:duration>
  <Update>

    ....

  </Update>
</gx:AnimatedUpdate>

<ExtendedData>

语法

<ExtendedData>                       
  <Data name="string">
    <displayName>...</displayName>    <!-- string -->
    <value>...</value>                <!-- string -->
  </Data>
  <SchemaData schemaUrl="anyURI">
    <SimpleData name=""> ... </SimpleData>   <!-- string -->
  </SchemaData>
  <namespace_prefix:other>...</namespace_prefix:other>
</ExtendedData>

说明

ExtendedData 元素提供了三种向 KML 地图项（NetworkLink、Placemark、GroundOverlay、PhotoOverlay、ScreenOverlay、Document、Folder）添加自定义数据的方法。这些方法分别为：

使用 <Data> 元素添加非类型化数据对/值对（基本）
使用 <Schema> 元素声明新的类型化字段，然后使用 <SchemaData> 元素将它们实例化（高级）
通过在 KML 文件中引用相应的外部命名空间，来引用在其他命名空间中定义的 XML 元素（基本）

您可以在单个包含多种数据段的 KML 文件或地图项中，结合使用这些方法。

有关详情，请参见“KML 主题”中的“添加自定义数据”。

ExtendedData 的特有元素

<Data name ="字符串"

创建非类型化名称/值对。名称可以有两个版本：name 和 displayName。name 属性用于标识 KML 文件中的数据对。displayName 元素用于在 Google 地球中显示格式正确的名称（具有空格和 HTML 格式）时生效。在 <BalloonStyle> 的 <text> 元素中，表示法 $[name/displayName] 已替换为 <displayName>。如果您以这种格式替换 <Data> 元素的 name 属性的值（例如 $[holeYardage]），则属性值将替换为 <value>。默认情况下，地标的提示框会显示其名称/值。

<displayName>

name 的可选格式化版本，将用于显示。

<值>

数据对的值。

<Placemark>
  <name>Club house</name>
  <ExtendedData>
    <Data name="holeNumber">
      <value>1</value>
    </Data>
    <Data name="holeYardage">
      <value>234</value>
    </Data>
    <Data name="holePar">
      <value>4</value>
    </Data>
  </ExtendedData>
</Placemark>

<SchemaData schema="="anyURI">

此元素可与 <Schema> 结合使用，以将类型化自定义数据添加到 KML 地图项。Schema 元素（由 schemaUrl 属性标识）用于声明自定义数据类型。实际数据对象（自定义数据的“实例”）则需使用 SchemaData 元素来定义。

<schema网址> 可以是完整网址、对外部 KML 文件中定义的架构 ID 的引用，也可以是对同一 KML 文件中定义的架构 ID 的引用。以下所有规范均可接受

schemaUrl="http://host.com/PlacesIHaveLived.kml#my-schema-id"

schemaUrl="AnotherFile.kml#my-schema-id"

schemaUrl="#schema-id"   <!-- same file -->

Schema 元素始终是 Document 的子元素。ExtendedData 元素则是包含自定义数据的地图项的子元素。

<SimpleData name="字符串">: 此元素会为由 name 属性标识的自定义数据字段分配一个值。该自定义数据字段的类型和名称则在 <Schema> 元素中声明。; 以下示例展示了如何定义两个自定义数据元素

<命名空间前缀:<其他>: 您可以利用此元素添加非类型化自定义数据。请务必在您文件的 <kml> 元素中引用该命名空间前缀，或将其作为 <ExtendedData> 元素的一个属性，并确保将该命名空间前缀用作每个数据元素名称的前缀。以这种方式添加的自定义数据会保留在 KML 文件中，但 Google 地球绝不会使用此类数据。此类数据一律随文件一起保存。; 以下示例展示了如何使用“camp”命名空间前缀

包含方

派生自 <Feature> 的任何元素

另请参见

架构

<Feature>

语法

<!-- abstract element; do not create -->
<!-- Feature id="ID" -->                <!-- Document,Folder,
                                             NetworkLink,Placemark,
                                             GroundOverlay,PhotoOverlay,ScreenOverlay -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>            <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- Camera or LookAt -->
  <TimePrimitive>...</TimePrimitive>    <!-- TimeStamp or TimeSpan -->
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>              <!-- deprecated in KML 2.2 -->
  <ExtendedData>...</ExtendedData>      <!-- new in KML 2.2 -->
<-- /Feature -->

说明

这是一个抽象元素，不能直接在 KML 文件中使用。下图展示了地图项的部分元素是如何在 Google 地球中显示的。

Feature 的特有元素

<name>

用户定义的文本在 3D 查看器中显示为对象的标签（例如，用于地标、文件夹或 NetworkLink）。

<visibility>

布尔值。指定在最初加载地图项时，是否要在3D查看器中绘制该地图项。若要显示地图项，相应地图项的所有上级元素的 <visibility> 标记也都必须设置为1。在 Google 地球列表视图中，每个地图项都有一个复选框，可供用户控制相应地图项的可见性。

<open>

布尔值。指定在首次加载到“位置”面板时文档或文件夹是会关闭还是打开。0=收起（默认值），1=展开。另请参阅 <ListStyle>。此元素仅适用于 Document、Folder 和 NetworkLink。

<atom:author>

KML 2.2 支持新的元素，用于在 KML 文件中包含作者和相关网站的数据。无论是在 Google 地球等地球浏览器中，还是在 Google 地图等其他应用中，此类信息都会显示在地理搜索结果中。KML 中使用的归属元素如下所示：

atom:author 元素 - atom:name 的父元素
atom:name 元素 - 作者的名字
atom:link 元素 - 包含 href 属性
href 属性 - 包含 KML/KMZ 文件的网页网址

这些元素以 Atom 整合格式定义。如需查看完整规范，请访问 http://atompub.org。（请参阅下面的示例）。

<atom:author> 元素是 <atom:name> 的父元素，后者指定 KML 地图项的作者。

<atom:link href="..." >

指定包含此 KML 或 KMZ 文件的网站的网址。请务必在使用此元素的所有 KML 文件中都添加其命名空间：xmlns:atom="http://www.w3.org/2005/Atom"（请参阅下面的示例）。

<address>

一个字符串值，表示以标准街道、城市、省级行政区和/或邮政编码形式表示的非结构化地址。您可以使用 <address> 标记（而非经度和纬度坐标）来指定某点的位置（不过，如果提供 <Point>，则其优先级高于 <address>）。若要在 Google 地球中了解该标记支持哪些语言区域，请访问 Google 地图帮助。

<xal:AddressDetails>

结构化地址，格式为 xAL（即可扩展地址语言，即一种地址格式国际标准）。KML 只使用 <xal:AddressDetails> 进行 Google 地图地理编码。如需了解详情，请参阅 Google Maps API 文档。目前，Google 地球不使用该元素，而是使用 <address>。请务必在使用该元素的任何 KML 文件中都添加其命名空间：xmlns:xal="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"

<phoneNumber>

一个表示电话号码的字符串值。该元素仅供谷歌手机地图使用。启用 Java 的手机的行业标准为RFC2806。
有关详情，请参阅 http://www.ietf.org/rfc /rfc2806.txt。

<Snippet maxLines="2" >

功能的简短说明。在 Google 地球中，该说明会显示在“位置”面板中，地图项名称的下面。如果文件中未提供 Snippet 部分，则会使用 <description> 的前两行。在 Google 地球中，如果某个 Placemark 元素同时包含 description 和 Snippet 部分，则 <Snippet> 会显示在“位置”面板中的“地标”下，而 <description> 则会显示在该地标的说明提示框中。该标记不支持 HTML 标记。<Snippet> 包含一个 maxLines 属性（一个整数），用于指定要显示的行数上限。

<description>

在说明提示框中显示的内容（由用户提供）。

对于 <description> 元素，Google 地球5.0与 Google 地球4.3所支持的内容有所不同。下面列出了每个版本的特定信息，以及两个版本的通用信息。

Google 地球 5.0

Google 地球5.0（及更高版本）支持在说明提示框中显示纯文本内容以及完整的 HTML 和 JavaScript 内容。说明标记的内容由 WebKit 开源网络浏览器引擎呈现，且呈现效果与它在所有基于 WebKit 的浏览器中的呈现效果相同。

一般限制

一般不支持指向本地文件的链接。这可以防止恶意代码破坏您的系统或访问您的数据。如果您希望允许访问您的本地文件系统，请依次选择偏好设置 > 允许访问本地文件和个人数据。如果该元素包含在 <img> 标记中，则始终支持指向本地文件系统中的图片文件的链接。

可以访问压缩为 KMZ 文件的内容（即使该内容是在本地文件系统中）。

Cookie 处于启用状态，但根据同源政策的规定，本地内容不会与其他任何内容（包括其他本地内容）共享网域。

HTML

在大多数情况下，HTML 在该版本中的呈现效果与它在所有 WebKit 浏览器中的呈现效果相同。

当目标包含在直接写入 KML 的 HTML 中时，系统会将其忽略；所有的此类链接都会打开，就像将目标设置为 _blank 一样。系统会忽略所有指定的目标。

但是，包含在 iFrame 中的 HTML，或者通过 JavaScript 或 DHTML 动态生成的 HTML，会使用 target="_self" 作为默认值。您还可以指定其他目标，系统也会支持这些目标。

不支持从包含在 iFrame 内的 HTML 中定位 KMZ 文件的内容、本地锚点链接和 ;flyto 方法。

如果用户为 iFrame 的宽度指定了 width="100%"，那么 iFrame 的宽度将取决于提示框中的所有其他内容 - 计算布局大小时，它本应会被忽略。此规则也适用于提示框内的其他所有板块元素。

JavaScript

支持大多数 JavaScript。无法创建对话框 - 不会显示 alert() 和 prompt() 等函数。不过，与其他错误和异常一样，它们也会写入系统控制台。

CSS

不支持 CSS。与常规网络浏览器中的 CSS 一样，CSS 可用于设计文本和页面元素样式，并控制说明提示框的大小和外观。

Google 地球 4.3

<description> 元素支持纯文本和 HTML 格式元素的子集，其中包括表格（参见下面的 KML 示例）。它不支持其他基于网络的技术，例如动态网页标记（PHP、JSP、ASP）、脚本语言（VBScript、Javascript），也不支持应用语言（Java、Python）。Google 地球 4.2 版支持视频。（请参见下面的示例）。

基本信息

如果您的说明不包含 HTML 标记，那么 Google 地球将会尝试将其格式化，即用 <br> 替换新行并用锚标记封装网址。万维网的有效网址字符串会自动转换为该网址的超链接（例如 http://www.google.com）。因此，您无需在网址两边添加 <a href="http://.."></a> 标记，即可实现简单的链接。

当使用 HTML 代码针对特定字词创建超链接或者在 HTML 内容中添加图片时，您必须使用 HTML 实体引用或 CDATA 元素，来避开尖括号、省略号和其他特殊字符。CDATA 元素会告知 XML 解析器忽略括号内使用的特殊字符。该元素的形式如下：

<![CDATA[
  special characters here
]]>

如果您不喜欢使用 CDATA 元素，则可以使用实体引用来代替所有的特殊字符。

<description>
  <![CDATA[
This is an image
<img src="icon.jpg">
  ]]>
</description>

通过使用 <a> 元素指定的其他行为

KML 支持在 <a> 元素中使用以下两个属性：href 和 type。

锚元素 <a> 包含用于指定网址的 href 属性。

如果 href 是 KML 文件，且文件扩展名为 .KML 或 .kmz，则 Google 地球会在用户点击该文件时直接加载该文件。如果网址以 Google 地球未知的扩展名（例如 .html）结尾，则系统会将网址发送到浏览器。

href 可以是片段网址（即，# 符号后跟 KML 标识符的网址）。用户点击包含片段网址的链接时，默认情况下，浏览器会飞到 ID 与该片段匹配的地图项。如果地图项具有 LookAt 或 Camera 元素，那么您可以从指定的视点查看该地图项。

您可以通过向 fragment 网址附加以下三个字符串之一进一步指定该行为：

;flyto（默认）- 飞到地图项
气球：打开地图项的提示框，但不飞到该地图项
;气球飞行 - 打开地图项的提示框，并飞到该地图项

例如，以下代码表示打开文件 CraftsFairs.KML，飞到 ID 为“Albuquerque”的地标，然后打开其提示框：

<description>
  <![CDATA[ 
    <a href="http://myServer.com/CraftsFairs.kml#Albuquerque;balloonFlyto">
      One of the Best Art Shows in the West</a>
  ]]>
</description>

如果 href 不以 .KML 或 .kmz 结尾，则 <a> 元素中会使用 type 属性，但您需要在 KML 的上下文中解释引用。指定以下内容：

type="application/vnd.google-earth.kml+xml"

例如，以下网址虽然使用文件扩展名 .php，但使用 type 属性通知 Google 地球应尝试加载该文件：

<a href="myserver.com/cgi-bin/generate-kml.php#placemark123"
   type="application/vnd.google-earth.kml+xml">

<AbstractView>

定义与派生自地图项的任何元素相关联的视角。请参阅 <Camera> 和 <LookAt>。

<TimePrimitive>

将此功能与时间段 (<TimeSpan>) 或时间点 (<TimeStamp>) 相关联。

<styleUrl>

文档中定义的 <Style> 或 <StyleMap> 的网址。如果样式位于同一文件中，请使用 # 引用。如果样式是在外部文件中定义的，请使用完整网址以及 # 个引用。例如：

<styleUrl>#myIconStyleID</styleUrl>

<styleUrl>http://someserver.com/somestylefile.xml#restaurant</styleUrl>

<styleUrl>eateries.kml#my-lunch-spot</styleUrl>

<StyleSelector>

可以定义一个或多个样式和 StyleMap，以自定义派生自地图项或地标中的几何图形的任何元素的外观。（参见 <BalloonStyle>、<ListStyle>、<StyleSelector>、以及派生自 <ColorStyle> 的样式）。地图项中定义的样式称为“内嵌样式”，它仅适用于包含它的地图项。样式定义为 <Document> 的子项，称为“共享样式”。必须为共享样式定义 id。<Document> 中的一个或多个地图项引用了此 ID。如果某个样式元素同时以共享样式和地图项的内嵌样式（即 Folder、GroundOverlay、NetworkLink、Placemark 或 ScreenOverlay）定义，那么地图项的内嵌样式的值优先于共享样式的值。

<Region>

仅当某个区域处于活动状态时，才会绘制与该区域关联的地图项和几何图形。请参阅 <Region>。

<Metadata>

<ExtendedData>

可让您向 KML 文件添加自定义数据。这些数据可以是 (1) 引用外部 XML 架构的数据、(2) 非类型化数据/值对，或 (3) 类型化数据。给定的 KML 地图项可以包含这些类型的自定义数据的组合。

说明中的 HTML 元素用法

该示例介绍了 Google 地球4.3中 <description> 元素支持的完整 HTML 元素集。Google 地球5.0及更高版本支持完整的 HTML 和 JavaScript。

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Placemark>
  <name>Feature.kml</name>
  <Snippet maxLines="4">
    The snippet is a way of
    providing an alternative
    description that will be
    shown in the List view.
  </Snippet> 
  <description>
    <![CDATA[
      Styles: <i>Italics</i>, <b>Bold</b>, <u>Underlined</u>, 
      <s>Strike Out</s>, subscript<sub>subscript</sub>,
      superscript<sup>superscript</sup>,  
      <big>Big</big>, <small>Small</small>, <tt>Typewriter</tt>,
      <em>Emphasized</em>, <strong>Strong</strong>, <code>Code</code>
      <hr />
      Fonts: 
      <font color="red">red by name</font>, 
      <font color="#408010">leaf green by hexadecimal RGB</font>, 
      <font size=1>size 1</font>, <font size=2>size 2</font>,
      <font size=3>size 3</font>, <font size=4>size 4</font>,
      <font size=5>size 5</font>, <font size=6>size 6</font>, 
      <font size=7>size 7</font>,
      <font face=times>Times</font>, 
      <font face=verdana>Verdana</font>, 
      <font face=arial>Arial</font>
      <br/>
      <hr />
      Links:
      <a href="http://doc.trolltech.com/3.3/qstylesheet.html">
      QT Rich Text Rendering
      </a>
      <br />
      <hr />
      Alignment:
      <br />
      <p align=left>left</p><p align=center>center</p>
      <p align=right>right</p>
      <hr />
      Ordered Lists:
      <br />
      <ol><li>First</li><li>Second</li><li>Third</li></ol>
      <ol type="a"><li>First</li><li>Second</li><li>Third</li></ol>
      <ol type="A"><li>First</li><li>Second</li><li>Third</li></ol>
      <hr />
      Unordered Lists:
      <br />
      <ul><li>A</li><li>B</li><li>C</li></ul>
      <ul type="circle"><li>A</li><li>B</li><li>C</li></ul>
      <ul type="square"><li>A</li><li>B</li><li>C</li></ul>
      <hr />
      Definitions:
      <br />
      <dl>
      <dt>Scrumpy</dt>
      <dd>Hard English cider from the west country</dd>
      <dt>Pentanque</dt>
      <dd>A form of boules where the goal is to throw metal ball as
      close as possible to a jack</dd>
      </dl>
      <hr />
      Block Quote:
      <br />
      <blockquote>
      We shall not cease from exploration<br />
      And the end of all our exploring<br />
      Will be to arrive where we started<br />
      And know the place for the first time
      </blockquote>
      <br />
      <hr />
      Centered:
      <br />
      <center>See, I have a Rhyme assisting<br />
      my feeble brain,<br />
      its tasks oft-times resisting!</center>
      <hr />
      Headings:
      <br />
      <h1>Header 1</h1>
      <h2>Header 2</h2>
      <h3>Header 3</h3>
      <h3>Header 4</h4>
      <h3>Header 5</h5>
      <hr />
      Images:
      <br />
      <img src="icon.jpg"> 
and we have a link http://www.google.com.]]>
  </description>
  <Point>
    <coordinates>-122.378927,37.826793,0</coordinates>
  </Point>
</Placemark>
</kml>

归属元素使用示例

此示例展示了如何使用 Atom 命名空间中的 <atom:author>、<atom:name> 和 <atom:link> 元素。请注意，您需要在 <kml> 元素中引用该命名空间。

<kml xmlns="http://www.opengis.net/kml/2.2"
     xmlns:atom="http://www.w3.org/2005/Atom"> 
  <Document>
    <atom:author>
      <atom:name>J. K. Rowling</atom:name>
    </atom:author>
    <atom:link href="http://www.harrypotter.com" />
    <Placemark>
      <name>Hogwarts</name>
      <Point>
        <coordinates>1,1</coordinates>
      </Point>
    </Placemark>
    <Placemark>
      <name>Little Hangleton</name>
      <Point>
        <coordinates>1,2</coordinates>
      </Point>
    </Placemark>
  </Document>
</kml>

示例视频

此示例展示了如何在提示框中嵌入 Flash 视频。

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
  <Document>
    <name>Video Example</name>
    <Style id="sn_blue-dot_copy3">
      <IconStyle>
        <Icon>
          <href>http://www.google.com/intl/en_us/mapfiles/ms/icons/blue-dot.png</href>
        </Icon>
      </IconStyle>
    </Style>
    <Placemark>
      <name>Placemark</name>
      <description>
        <![CDATA[<div style="font-size:larger">
          <div>
            <div style="width: 212px; font-size: 12px;">
              <b>The Spaghetti Film</b>
            </div>
            <div style="font-size: 11px;">
              <a target="_blank" href="http://www.youtube.com/?v=FICUvrVlyXc">
                http://www.youtube.com/?v=FICUvrVlyXc</a><br>
            </div><br>
            <div style="margin-left: auto; margin-right:auto;">
              <object height="175" width="212">
                <param value="http://www.youtube.com/v/FICUvrVlyXc" name="movie">
                <param value="transparent" name="wmode">
                <embed wmode="transparent" type="application/x-shockwave-flash"
                   src="http://www.youtube.com/v/FICUvrVlyXc" height="175"
                   width="212">
               </object>
             </div>
           </div>
          </div>
          <div style="font-size: smaller; margin-top: 1em;">Saved from 
            <a href="http://maps.google.com/ig/add?synd=mpl&pid=mpl&moduleurl=
                http:%2F%2Fwww.google.com%2Fig%2Fmodules%2Fmapplets-youtube.xml&hl=en&gl=us">
                YouTubeVideos</a>
          </div>
         ]]>
      </description>
      <styleUrl>#sn_blue-dot_copy3</styleUrl>
      <Point>
        <coordinates>-93.47875999999999,45.083248,0</coordinates>
      </Point>
    </Placemark>
</Document>
</kml>

扩展源

对象>

扩展元素

<容器>
<叠加层>
<地标>
<NetworkLink>
<gx:Tour>

<gx:FlyTo>

该元素是OGC KML 2.2标准的扩展元素，并且受 Google 地球5.0及更高版本的支持。了解详情

语法

<gx:FlyTo id="ID">
  <gx:duration>0.0</gx:duration>         <!-- double -->
  <gx:flyToMode>bounce</gx:flyToMode>    <!-- smooth or bounce -->
  <!-- AbstractView -->                        <!-- Camera or LookAt -->
    ...
  <!-- /AbstractView -->
</gx:FlyTo>

说明

<gx:FlyTo> 用于指定浏览器在游览期间要前往的空间点。它必须包含一个 AbstractView，且应包含 <gx:duration> 和 <gx:flyToMode> 元素，这两个元素分别指定从当前点飞到指定点所需的时间，以及飞行方法。

<gx:flyToMode>

<gx:flyToMode> 有两个可接受的值：smooth 和 bounce。

Smooth FlyTo 允许从一点到另一点（逐点）的不间断飞行。一个不间断的 smooth FlyTo 系列在开始和结束点的速度均为零，并且在中间每一个点时都不会减速。以下任何元素都会损坏一系列顺畅的 FlyTo：
- <gx:flyToMode>bounce</gx:flyToMode>
- <gx:Wait>
这意味着，在上述任何元素之前，smotive FlyTo 中的速度都将为零。<gx:AnimatedUpdate> 元素不会中断 smooth FlyTo 系列。

Bounce FlyTo 在开始和结束点的速度均为零。

示例

<gx:FlyTo>
  <gx:duration>2.55</gx:duration>
  <gx:flyToMode>smooth</gx:flyToMode>
  <Camera>
    <longitude>-113.084448</longitude>
    <latitude>36.567081</latitude>
    <altitude>41277.571403</altitude>
    <heading>116.150227</heading>
    <altitudeMode>absolute</altitudeMode>
  </Camera>
</gx:FlyTo>

扩展源

<gx:TourPrimitive>

包含元素

<gx:duration>
<gx:flyToMode>
<抽象视图>

<Folder>

语法

<Folder id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>            <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- Camera or LookAt -->
  <TimePrimitive>...</TimePrimitive>
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>              <!-- deprecated in KML 2.2 -->
  <ExtendedData>...</ExtendedData>

  <!-- specific to Folder -->
  <!-- 0 or more Feature elements -->
</Folder>

说明

Folder 用于按层次结构排列其他地图项（Folder、Placemark、NetworkLink 或 Overlay）。只有将某个地图项及其所有上级元素都设为可见时，系统才会显示该地图项。

示例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Folder>
  <name>Folder.kml</name>
  <open>1</open>
  <description>
    A folder is a container that can hold multiple other objects
  </description>
  <Placemark>
    <name>Folder object 1 (Placemark)</name>
    <Point>
      <coordinates>-122.377588,37.830266,0</coordinates>
    </Point>
  </Placemark>
  <Placemark>
    <name>Folder object 2 (Polygon)</name>
    <Polygon>
      <outerBoundaryIs>
        <LinearRing>
          <coordinates>
            -122.377830,37.830445,0
            -122.377576,37.830631,0
            -122.377840,37.830642,0
            -122.377830,37.830445,0
          </coordinates>
        </LinearRing>
      </outerBoundaryIs>
    </Polygon>
  </Placemark>
  <Placemark>
    <name>Folder object 3 (Path)</name>
    <LineString>
      <tessellate>1</tessellate>
      <coordinates>
        -122.378009,37.830128,0 -122.377885,37.830379,0
      </coordinates>
    </LineString>
  </Placemark>
</Folder>
</kml>

扩展源

<容器>

包含元素

派生自 <Feature> 的任何元素

<Geometry>

语法

<!-- abstract element; do not create -->
<!-- Geometry id="ID" -->
                                              <!-- Point,LineString,LinearRing,
                                               Polygon,MultiGeometry,Model,
                                               gx:Track -->
<!-- /Geometry -->

说明

这是一个抽象元素，不能直接在 KML 文件中使用。它为所有派生的 Geometry 对象提供占位符对象。

扩展源

对象>

扩展元素

<点>
<线字符串>
<线性响铃>
<Polygon>
<MultiGeometry>
<gx:MultiTrack>
<型号>
<gx:Track>

<GroundOverlay>

语法

<GroundOverlay id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>                <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
  <phoneNumber>...</phoneNumber>        <!-- string -->
  <Snippet maxLines="2">...</Snippet>   <!-- string -->
  <description>...</description>        <!-- string -->
  <AbstractView>...</AbstractView>      <!-- Camera or LookAt -->
  <TimePrimitive>...</TimePrimitive>
  <styleUrl>...</styleUrl>              <!-- anyURI -->
  <StyleSelector>...</StyleSelector>
  <Region>...</Region>
  <Metadata>...</Metadata>              <!-- deprecated in KML 2.2 -->
  <ExtendedData>...</ExtendedData>      <!-- new in KML 2.2 -->

  <!-- inherited from Overlay element -->
  <color>ffffffff</color>                   <!-- kml:color -->
  <drawOrder>0</drawOrder>                  <!-- int -->
  <Icon>...</Icon>

  <!-- specific to GroundOverlay -->
  <altitude>0</altitude>                    <!-- double -->
  <altitudeMode>clampToGround</altitudeMode>
     <!-- kml:altitudeModeEnum: clampToGround or absolute -->
     <!-- or, substitute gx:altitudeMode: clampToSeaFloor or relativeToSeaFloor -->
  <LatLonBox>
    <north>...</north>                      <! kml:angle90 -->
    <south>...</south>                      <! kml:angle90 -->
    <east>...</east>                        <! kml:angle180 -->
    <west>...</west>                        <! kml:angle180 -->
    <rotation>0</rotation>                  <! kml:angle180 -->
  </LatLonBox>
  <gx:LatLonQuad>
    <coordinates>...</coordinates>          <!-- four lon,lat tuples -->
  </gx:LatLonQuad>
</GroundOverlay>

说明

该元素会绘制地形上叠加的图像叠加层。<Icon> 的子元素 <href> 会指定将用作叠加层的图片。该文件可以存储在本地文件系统中，也可以存储在网络服务器中。如果省略此元素或该元素不包含 <href>，系统会使用地面叠加层定义的颜色和 LatLonBox 边界绘制一个矩形。

GroundOverlay 的特有元素

<altitude>

：指定地表以上的距离（以米为单位），并根据海拔模式进行解释。

<altitudeMode>

指定如何解读 <height>。可能的值包括：

clampToGround -（默认）表示忽略高度规范，并将叠加层叠加到相应地形上。
absolute - 设置叠加层相对于海平面的高度，无论该元素下的地形的实际高度如何。例如，如果您用 absolute 高度模式将叠加层的高度设置为10米，那么当下面的地形也高于海平面10米时，叠加层看上去就在地平面上。如果地形高于海平面3米，那么叠加层看上去就悬空高于该地形7米。

<gx:heightMode>

Google 扩展元素命名空间中的 KML 扩展元素，允许存在以海底为基准的高度。具体值包括：

relativeToSeaFloor - 将 <altitude> 解释为以海底为基准的高度值（以米为单位）。如果相应的点位于陆地上方而不是海面上方，则会将 <altitude> 解释为地面以上的高度。
clampToSeaFloor - 用于忽略 <height> 规范，并将叠加层叠加到海底。如果该点位于陆地上方而不是海面上方，则系统会将叠加层放置在地面上。

<LatLonBox>

指定地面叠加层边界框的顶部、底部、右侧和左侧对齐的位置。

<north> 指定边界框北边缘的纬度（以 0 到 ±90 的十进制度数表示）。
<south> ：指定边界框南边缘的纬度（以 0 到 ±90 的十进制度数表示）。
<east> 指定边界框东边缘的经度（以 0 到 ±180 的十进制度数表示）。（对于与经度 180° 子午线重叠的叠加层，值可超出该范围。）
<west> 指定边界框西边缘的经度（以 0 到 ±180 的十进制度数表示）。（对于与经度 180° 子午线重叠的叠加层，值可超出该范围。）
<rotation>：指定叠加层围绕其中心旋转的角度（以度为单位）。值可以为 ±180。默认值为 0（北）。旋转按照逆时针方向指定。

<LatLonBox>
   <north>48.25475939255556</north>
   <south>48.25207367852141</south>
   <east>-90.86591508839973</east>
   <west>-90.8714285289695</west>
   <rotation>39.37878630116985</rotation>
</LatLonBox>

<gx:LatLonQuad>

用于非矩形的四边形地面叠加层。

示例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<GroundOverlay>
   <name>GroundOverlay.kml</name>
   <color>7fffffff</color>
   <drawOrder>1</drawOrder>
   <Icon>
      <href>http://www.google.com/intl/en/images/logo.gif</href>
      <refreshMode>onInterval</refreshMode>
      <refreshInterval>86400</refreshInterval>
      <viewBoundScale>0.75</viewBoundScale>
   </Icon>
   <LatLonBox>
      <north>37.83234</north>
      <south>37.832122</south>
      <east>-122.373033</east>
      <west>-122.373724</west>
      <rotation>45</rotation>
   </LatLonBox>
</GroundOverlay>
</kml>

扩展源

<功能>
<Overlay>

包含方

<文档>
<文件夹>

<Icon>

语法

<Icon id="ID">
  <!-- specific to Icon -->
  <href>...</href>                         <!-- anyURI -->
  <gx:x>0<gx:x/>                           <!-- int -->
  <gx:y>0<gx:y/>                           <!-- int -->
  <gx:w>-1<gx:w/>                          <!-- int -->
  <gx:h>-1<gx:h/>                          <!-- int -->
  <refreshMode>onChange</refreshMode>
    <!-- kml:refreshModeEnum: onChange, onInterval, or onExpire -->
  <refreshInterval>4</refreshInterval>     <!-- float -->
  <viewRefreshMode>never</viewRefreshMode>
    <!-- kml:viewRefreshModeEnum: never, onStop, onRequest, onRegion -->
  <viewRefreshTime>4</viewRefreshTime>     <!-- float -->
  <viewBoundScale>1</viewBoundScale>       <!-- float -->
  <viewFormat>...</viewFormat>             <!-- string -->
  <httpQuery>...</httpQuery>               <!-- string -->
</Icon>

说明

定义与图标样式或叠加层相关联的图片。所需的子元素 <href> 会定义将用作叠加层或地标图标的图片的位置。该位置可以位于本地文件系统中，也可以位于远程网络服务器中。<gx:x>、<gx:y>、<gx:w> 和 <gx:h> 元素用于从包含多个图标的图片（通常称为图标调色板）中选择一个图标。

<Icon>
  <href>Sunset.jpg</href>   <!-- Here, the image contains only one icon -->
</Icon>

<Icon>
  <href>/home/mydir/myiconpalette.jpg</href>
  <gx:w>138</gx:w>
  <gx:h>138</gx:h>
    <!-- Since x and y values are omitted, these measurements are made starting at
    the lower-left corner of the icon palette image -->
</Icon>

Icon 的特有元素

<href>: 用于加载图标的 HTTP 地址或本地文件规范。
<gx:x>
<gx:y>: 如果 <href> 指定了图标调色板，则这些元素会标识相对于图标调色板左下角的偏移量（以像素为单位）。如果没有为 x 和 y 指定值，则系统会假定图标调色板的左下角是要使用的图标的左下角。
<gx:w>
<gx:h>: 如果 <href> 指定了图标调色板，则这些元素会指定要使用的宽度 (<gx:w>) 和高度 (<gx:h>)（以像素为单位）。
<refreshMode>: 如需了解 <refreshMode> 和下面列出的其他元素，请参阅 <Link>。
<refreshInterval>
<viewRefreshMode>
<viewRefreshTime>
<viewBoundScale>
<viewFormat>
<httpQuery>

包含方

<GroundOverlay>
<屏幕叠加层>
<图标样式>

<IconStyle>

语法

<IconStyle id="ID">
  <!-- inherited from ColorStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum:normal or random -->

  <!-- specific to IconStyle -->
  <scale>1</scale>                   <!-- float -->
  <heading>0</heading>               <!-- float -->
  <Icon>
    <href>...</href>
  </Icon>
  <hotSpot x="0.5"  y="0.5"
    xunits="fraction" yunits="fraction"/>    <!-- kml:vec2 -->
</IconStyle>

说明

指定如何在“位置”面板和 Google 地球的3D查看器中绘制点地标的图标。<Icon> 元素会指定图标图片。<scale> 元素用于指定图标的 x, y 缩放比例。在 <IconStyle> 的 <color> 元素中指定的颜色会与 <Icon> 的颜色混合。

IconStyle 的特有元素

<scale>

调整图标大小。

请注意：<geomScale> 标记已弃用，请改用 <scale>。

<heading>

方向（即北、南、东、西），以度为单位。默认值 = 0（北）（参见下图）。值的范围是0度到360度。

<Icon>

自定义图标。在 <IconStyle> 中，<Icon> 的唯一子元素是 <href>：

<href>：用于加载图标的 HTTP 地址或本地文件规范。

<hotSpot x="0.5" y="0.5" xunits="fraction" yunits="fraction">

指定图标内的位置，该位置“锚定”于地标中指定的 <Point>。可通过三种不同的方式指定 x 和 y 值：按像素 ("pixels")、以分数表示 ("fraction")，或以插入像素("insetPixels") 表示，即与图标右上角的偏移（以像素为单位）。可以以不同的方式指定 x 和 y 位置，例如，x 可以以像素为单位，而 y 可以是小数。坐标系的原点位于图标的左下角。

x - 表示图标上点的 x 分量的像素数、图标比例或像素插入。
y - 表示图标上点的 y 分量的像素数、图标比例或像素插入。
xunits - 指定 x 值时所使用的单位。fraction 值表示 x 值是图标的比例。pixels 值表示以像素为单位的 x 值。insetPixels 值表示以图标右边缘为起始的缩进。
yunits - 指定 y 值时所使用的单位。fraction 值表示 y 值是图标的比例。pixels 值表示以像素为单位的 y 值。insetPixels 值表示以图标上边缘为的缩进。

示例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
   <Style id="randomColorIcon">
      <IconStyle>
         <color>ff00ff00</color>
         <colorMode>random</colorMode>
         <scale>1.1</scale>
         <Icon>
            <href>http://maps.google.com/mapfiles/kml/pal3/icon21.png</href>
         </Icon>
      </IconStyle>
   </Style>
   <Placemark>
      <name>IconStyle.kml</name>
      <styleUrl>#randomColorIcon</styleUrl>
      <Point>
         <coordinates>-122.36868,37.831145,0</coordinates>
      </Point>
   </Placemark>
</Document>
</kml>

扩展源

<ColorStyle

包含方

<样式>

包含元素

<href>（作为 <Icon> 的子元素）

<kml>

语法

<kml xmlns="http://www.opengis.net/kml/2.2" hint="target=sky"> ... </kml>

说明

KML 文件的根元素。该元素为必需元素。它遵循相应文件开头部分的 xml 声明。hint 属性用作一个信号，指示 Google 地球将文件显示为天体数据。

<KML> 元素还可能包含文件中引用的任何外部 XML 架构的命名空间。

基本 <KML> 元素包含 0 个或 1 个地图项以及 0 个或 1 个 NetworkLinkControl：

<kml xmlns="http://www.opengis.net/kml/2.2">
  <NetworkLinkControl> ... </NetworkLinkControl>
  <!-- 0 or 1 Feature elements -->
</kml>

<LabelStyle>

语法

<LabelStyle id="ID">
  <!-- inherited from ColorStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum: normal or random -->

  <!-- specific to LabelStyle -->
  <scale>1</scale>                   <!-- float -->
</LabelStyle>

说明

指定如何在3D查看器中绘制地图项的 <name>。您可以指定标签（名称）的自定义颜色、颜色模式和比例。

请注意：<labelColor> 标记已被弃用，现改用 <LabelStyle>。

<LabelStyle> 的特有元素

<scale>: 调整标签大小。

示例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
   <Style id="randomLabelColor">
      <LabelStyle>
         <color>ff0000cc</color>
         <colorMode>random</colorMode>
         <scale>1.5</scale>
      </LabelStyle>
   </Style>
   <Placemark>
      <name>LabelStyle.kml</name>
      <styleUrl>#randomLabelColor</styleUrl>
      <Point>
         <coordinates>-122.367375,37.829192,0</coordinates>
      </Point>
   </Placemark>
</Document>
</kml>

扩展源

<ColorStyle

包含方

<样式>

<gx:LatLonQuad>

该元素是OGC KML 2.2标准的扩展元素，并且受 Google 地球5.0及更高版本的支持。了解详情

语法

<GroundOverlay id="ID">
  ...
  <Icon>...</Icon>
  <altitude>0</altitude>
  <altitudeMode>clampToGround</altitudeMode>                   <!-- or absolute -->
         <!-- can substitute <gx:altitudeMode>clampToSeaFloor</gx:altitudeMode> -->

  <gx:LatLonQuad>
    <coordinates>...</coordinates>              <!-- four lon,lat tuples -->
  </gx:LatLonQuad>
</GroundOverlay>

说明

允许使用非矩形的四边形地面叠加层。

指定定义叠加层区域的四边形的四角顶点的坐标。您实际上需要提供四个坐标元组，每个元组均由经度和纬度的浮点值组成。请在元组间插入空格，但勿在元组内插入空格。您必须以逆时针方向来指定坐标，并且第一个坐标需对应叠加层图片的左下角。这些角所描述的形状必须是凸面的。

在任意元组中插入的第三个值（表示高度）均会被忽略。海拔高度使用 <altitude> 和 <altitudeMode>（或 <gx:altitudeMode>）来扩展 <GroundOverlay>。允许的海拔模式为绝对、clampToGround 和 clampToSeaFloor。

示例

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">
<GroundOverlay>
  <name>gx:LatLonQuad Example</name>
  <Icon>
    <href>http://developers.google.com/kml/documentation/images/rectangle.gif</href>
    <viewBoundScale>0.75</viewBoundScale>
  </Icon>
  <gx:LatLonQuad>
    <coordinates>
      81.601884,44.160723 83.529902,43.665148 82.947737,44.248831 81.509322,44.321015
    </coordinates>
  </gx:LatLonQuad>
</GroundOverlay>
</kml>

扩展源

<对象>

包含方

<GroundOverlay>

<LinearRing>

语法

<LinearRing id="ID">
  <!-- specific to LinearRing -->
  <gx:altitudeOffset>0</gx:altitudeOffset>   <!-- double -->
  <extrude>0</extrude>                       <!-- boolean -->
  <tessellate>0</tessellate>                 <!-- boolean -->
  <altitudeMode>clampToGround</altitudeMode>
    <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
    <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <coordinates>...</coordinates>             <!-- lon,lat[,alt] tuples -->
</LinearRing>

说明

定义闭合的线条字符串，通常为多边形的外边界。或者，LinearRing 也可用作多边形的内边界，以在多边形中创建孔。一个多边形可包含多个用作内边界的 <LinearRing> 元素。

注意：在 Google 地球中，<heightMode> 为 clampToGround 的多边形是沿着同位线方向；而 <heightMode> 为 clampToGround 的 LinearRing（本身）则是沿着大圆方向。

LinearRing 的特有元素

<gx:altitudeOffset>

Google 扩展元素命名空间中的 KML 扩展项，用于修改高度值的呈现方式。此偏移量可让您将整个 LinearRing 作为一个整体上下移动，而不用修改构成 LinearRing 的所有单个坐标值（虽然在显示 LinearRing 时使用的是高度偏移量值，但原来的高度值会保留在 KML 文件中）。其值以米为单位。

<extrude>

布尔值。指定是否将 LinearRing 连接到地面。要使该几何图形向外凸出，高度模式必须为 relativeToGround、relativeToSeaFloor 或绝对。只有 LinearRing 的端点才会凸出，而几何图形的中心则不会。这些端点凸出的方向为地球球体中心。

<tessellate>

布尔值。指定是否允许 LinearRing 沿着地形方向。如需启用曲面细分，<heightMode> 的值必须为 clampToGround 或 clampToSeaFloor。非常大的 LinearRing 应启用地形镶嵌，以便其沿着地球的曲率铺设（否则它们会进入地下而被隐藏）。

<altitudeMode>

指定如何解释 <Coordinates> 元素中的高度分量。可能的值包括：

clampToGround -（默认）表示忽略高度规范（例如在 <Coordinates> 标记中）。
relativeToGround - 设置相应元素相对于特定位置实际地面高度的高度值。例如，如果某位置的地面高度正好与海平面齐平，且某点的高度被设置为9米，那么在该模式下点地标高度的图标高度是9米。然而，如果是在地面高度高于海平面10米的位置上设置相同的坐标，则该坐标的高度是19米。该模式的典型应用情境是放置电话线杆或滑雪缆索。
absolute - 设置相对于海平面的坐标高度，无论该元素下的地形的实际高度如何。例如，如果您使用绝对高度模式将坐标高度设置为 10 米，那么当下面的地形也高于海平面 10 米时，点地标的图标看上去就在地面上。如果地形高于海平面3米，那么该地标看上去就悬空高于该地形7米。该模式的典型应用情境是放置飞机。

<gx:heightMode>

Google 扩展元素命名空间中的 KML 扩展元素，允许存在以海底为基准的高度。具体值包括：

relativeToSeaFloor - 将 <altitude> 解释为以海底为基准的高度值（以米为单位）。如果该点位于陆地上方而不是海面上方，则会将 <altitude> 解释为地面以上的高度。
clampToSeaFloor - 用于忽略 <altitude> 规范，并将相应的点置于海底。如果该点位于陆地上方而不是海面上方，则会将该点置于地面上。

<coordinates>（必需）

四个或更多的元组，每个元组均由经度、纬度和高度的浮点值组成。高度分量为可选分量。请勿在元组中加入空格。最后一个坐标必须和第一个坐标相同。坐标只能用十进制的度数表示。

<SimpleField type="string" name="string">: 自定义字段的声明，必须同时指定该字段的类型和名称。如果省略 type 或 name，则该字段会被忽略。类型可以是以下项之一：

字符串

int

uint

short

ushort

float

double

bool; <displayName>

向 Google 地球用户显示字段名称时使用的名称（如果有）。请使用 [CDATA] 元素，以避开标准 HTML 标记。

KML 参考

关于本参考

KML 扩展元素命名空间和 gx 前缀

KML 字段

<抽象视图>

语法

说明

扩展源

AbstractView 的特有元素

扩展来源

<gx:altitudeMode>

语法

说明

示例

<gx:AnimatedUpdate>

语法

说明

示例

扩展源

包含元素

<BalloonStyle>

语法

说明

BalloonStyle 的特有元素

示例

扩展源

包含方

<gx:balloonVisibility>

语法

说明

示例

扩展

<Camera>

语法

说明

定义视图

转换顺序

Camera 的特有元素

扩展源

包含方

<ColorStyle>

语法

说明

ColorStyle 的特有元素

扩展源

扩展元素

<Container>

语法

说明

扩展源

扩展元素

<Document>

语法

说明

示例

扩展源

包含元素

<gx:duration>

语法

说明

duration 和 <gx:FlyTo>

duration 和 <gx:AnimatedUpdate>

<ExtendedData>

语法

说明

ExtendedData 的特有元素

包含方

另请参见

<Feature>

语法

说明

Feature 的特有元素

说明 中的 HTML 元素用法

归属元素使用示例

示例视频

扩展源

扩展元素

<gx:FlyTo>

语法

说明

说明中的 HTML 元素用法