本頁面由 Cloud Translation API 翻譯而成。

KML 參考資料

本節包含由 KML 2.2 版定義的所有 KML 元素，以及 Google 擴充功能命名空間中所含的字母/參照資料。KML 元素的類別樹狀結構如下所示。在樹狀圖中，樹狀結構中特定分支版本的右側元素是左側元素的「擴充功能」。例如，地標是特殊的 Feature 類型。其中包含屬於地圖項目的所有元素，並加入一些與地標元素專屬的元素。

KML 是開放式的開放標準，名為 OpenGIS® KML 編碼標準 (OGC KML)。由 Open Geospatial Consortium, Inc. (OGC) 維護。您可以在 http://www.opengeospatial.org/standards/KML/ 參閱 OGC KML 的完整規格。

KML 的完整 XML 架構位於 http://schemas.opengis.net/KML/。

注意：按一下圖表中的元素名稱，即可直接跳到該參考資料部分中的項目。

請注意，KML 檔案實際上並未使用抽像元素 (如圖中的方塊所示)。這是一種單一元素，可做為多個相似 (但不同) 衍生元素的程式輔助基礎。瞭解這個物件導向的階層也有助於瞭解 KML，因為您可以輕鬆查看相關元素的分組。

從 Object 衍生的所有元素皆可獲得指派的 id。KML 更新機制 (請參閱 <Update>) 會使用透過 NetworkLink 載入的檔案來使用這個 id。它也由共用樣式使用 (請見 <Style>)。id 是標準的 XML ID。

由於 KML 是 XML 文法和檔案格式，因此標記名稱有大小寫之分，且必須如此處所示。如果您熟悉 XML，也很有興趣瞭解 KML 2.2 架構。編輯 KML 文字檔案時，您可以將這個結構定義載入任何 XML 編輯器，然後透過該 KML 驗證 KML 程式碼。

提示：檢視 KML 以檢視 Google 地球功能

「Google 地球」的便利功能讓您可輕鬆檢視任何地圖項目的 KML 檔案，在「Google 地球」中的 [位置] 面板中，於 [地圖項目] 上按一下滑鼠右鍵，即可複製該地圖項目。如要查看複製物件的對應 KML，請開啟您慣用的文字編輯器，並將選取項目貼到其中。

相容性

KML 版本具備雙編號系統：majorVersion.minorVersion。所有具有相同 majorVersion 的版本都相容。因此，如果您將命名空間變更為「2.2」(也就是 xmlns="http://www.opengis.net/kml/2.2")，則所有 KML 2.1 檔案都必須在 KML 2.2 架構中進行驗證。

關於此參考資料

每個參照項目都包含一個語法區段，其中列出主要元素中包含的元素。這個「語法」區段是非正式的列表，採用簡單的簡短摘要來概述元素。這個部分也包含下列內容：

每個元素的預設值 (如果是複雜元素，則沒有刪節號)
值的 type (請參閱 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:balloonVisibility
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:等候
x x x
gx:y

這個擴充功能命名空間元素的完整 XML 架構位於 http://developers.google.com/KML/schema/KML22gx.xsd。

KML 欄位

KML 使用常見的 XML 類型，例如 布林 (值)、字串、雙精度浮點 (浮點)、浮點 (float) 和整數。此外，KML 也定義了多個欄位元素類型。下表列出 KML 中定義的一些常用類型，並提供這些類型之元素元素的連結：

欄位類型	值	使用範例
heightModeEnum	clampToGround、relativeToGround、絕對值	查看<LookAt>和<Region>
角度 90	值 ≥-90 和 ≤90	請查看<Model>的<緯度>
anglepos9	值為 ≥0 且 ≤90	查看 <LookAt> 的 <tilt>
角度 180	值 ≥-180 和 ≤180	請查看<Model>的「<經度>」
角度 360	值為 ≥-360 且 ≤360	請在 <Orientation> 中查看 <heading>
顏色	十六進位二進位檔值：aabbggrr	查看延伸 <ColorStyle> 的任何元素
色彩模式 Enum	正常，隨機	查看延伸 <ColorStyle> 的任何元素
日期時間	dateTime、date、gYearMonth、gYear	請參閱 <TimeSpan> 和 <TimeStamp>
displayModeEnum	預設、隱藏	請參閱 <BalloonStyle>
gridOrigin	lowerLeft、upLeft	詳情請參閱 <PhotoOverlay>
RefreshModeEnum	onChange, onInterval, onExpire	請參閱 <Link>
shapeEnum	矩形、圓柱、球體	詳情請參閱 <PhotoOverlay>
styleStateEnum	正常，醒目顯示	查看 <StyleMap>
單位	分數, 像素, insetPixels	查看 <IconStyle> 和 <ScreenOverlay> 的 <hotSpot>
vec2	x=double xunits=KML:unitsEnum y=double yunits=KML:unitsEnum	查看 <IconStyle> 中的 <hotSpot>、 <ScreenOverlay>
viewRefreshEnum	永不、onRequest、onStop、onRegion	請參閱 <Link>

<AbstractView>

語法

<!-- 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>。一般 AbstractViews 被指定的值為 60，而街景服務中的檢視畫面值則是 85，以符合 Google 地球的標準街景服務欄位。設定完畢後，該值就會套用至後續的檢視畫面，直到指定新的值為止。

<gx:heightMode>

這項元素是 OGC KML 2.2 標準的擴充功能，可支援 Google 地球 5.0 以上版本。瞭解詳情

語法

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

說明

您可以使用 OGC KML 標準 <altitudeMode> 元素來代替 OGC KML 標準元素，除了標準 ElevationMode 值之外，也接受以下值：

relativeToSeaFloor：將高度解讀為以公尺為單位的高度。如果 KML 功能在陸地上，而不是海平面，系統會將高度視為地上。
clampToSeaFloor - 系統會略過高度規格，同時將 KML 功能放置在海平面上。如果 KML 功能在陸上而非海上，則 clampToSeaFloor 會改為採用地面。

與 <altitudeMode> 一樣，<gx:altitudeMode> 會影響：

<coordinates> 元素內的高度座標
<LatLonAltBox> 中的 <minAltitude> 和 <maxAltitude>
<Location>、<GroundOverlay> 和 AbstractView 中的 <altitude> (<LookAt> 和 <Camera>)。

如要進一步瞭解高度模式，請參閱 KML 開發人員指南的「高度模式」章節。

範例

heightmode_reference.gp

<?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> 值，以指定更新作業進行的時間長度 (以秒為單位)。整數、浮點及顏色欄位會在整個期間順暢地以原始格式繪製到新的值；布林 (值)、字串 (及其他) 與內插值無關的值則會在持續時間結束時更新。

如要進一步瞭解 <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> 會做為氣球的背景顏色。請參閱 <Feature> 的圖表，瞭解 Google 地球預設說明的說明框。

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)。
<textColor>: 文字的前景顏色。預設值為黑色 (ff000000)。
<text>: 說明框中顯示的文字。如未指定文字，Google 地球會繪製預設氣球 (以粗體標示的地圖項目 <名稱>、功能 <說明>、行車路線連結、白色背景，以及附加在功能點座標 (如有指定) 的尾部。; 你可以使用下列格式在 <text> 標記中加入實體，以參照「地圖項目」的子元素：$[name]、$[description]、$[address]、$[id]、$[Snippet]。Google 地球會在目前的 Feature 中尋找對應的字串實體，並以資訊框取代該資訊。如要在氣球中加入目的地至此處的行車路線，請使用 $[geDirections] 標記。如要避免出現氣球的連結在說明框中，請加入 <text> 元素和部分內容，或使用 $[description] 取代基本的 <description> 屬性。; 舉例來說，下列 KML 摘錄，$[name] 和 $[description] 欄位將由 Ball 中所用的 <name> 和 <description> 欄位取代
<displayMode>: 如果 <displayMode> 為預設設定，Google 地球會使用 <text> 提供的資訊來建立氣球。如果 <displayMode> 為 hide，Google 地球就不會顯示說明框。在「Google 地球」中，按一下氣球的 <displayMode> 為隱藏的「地標」的「清單檢視」圖示，就能讓「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>

擴充

<顏色樣式>

包含

<樣式>

返回頁首

<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>。地標載入後，說明框就會開啟。
balloonvisibility_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">

  <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>。巡迴演出期間開啟和關閉許多氣球，提供觀眾資訊。
balloonvisibility_tourexample.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>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 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:海拔高度模式定義。相機的檢視方向由 <heading>、<tilt> 及 <roll> 定義。<Camera> 可以是任何 Feature 或 <NetworkLinkControl> 的子項元素。a<<相機名稱>> 相同。

<Camera> 提供 6 自由度的視圖自由度控制選項，因此您可以將相機放置在空間內，然後沿著 X、Y 和 Z 軸旋轉。最重要的是，你可以傾斜相機鏡頭，將天地的視角俯瞰天空。

<Camera> 也可能包含 TimePrimitive (<gx:TimeSpan> 或 <gx:TimeStamp>)。「相機」中的時間值會影響歷史圖像、日光，或有時間戳記效果的功能顯示。如需詳細資訊，請參閱《開發人員指南》中「時間與動畫」章節中的「搭配 AbstractViews 的時間」。

定義檢視

在 Feature 或 <NetworkLinkControl> 中，使用 <Camera> 或 <LookAt> 物件 (但不得同時使用同一個物件)。<Camera> 物件會根據檢視者的位置和方向定義檢視點。<Camera> 物件可讓您指定不在地球表面上的視圖。<LookAt> 物件可依據使用者正在檢視的內容定義檢視點。<LookAt> 物件的範圍比 <Camera> 更為有限，且通常要求檢視方向與地球表面相交。

下圖顯示連接至虛擬相機的 X、Y 和 Z 軸。

X 軸指向相機右側，稱為右側向量。
Y 軸可定義與螢幕相關的「向上」方向，也稱為 向上向量。
「Z」軸從螢幕中央朝向眼點。攝影機往下看 --Z 軸，也就是檢視向量。

轉換順序

輪播順序很重要。在預設狀態下，攝影機會朝地球的方向向下看 -Z 軸。在旋轉之前，相機沿著 Z 軸轉譯為 <海拔高度>。轉換順序如下所示：

<altitude> - 沿著 Z 軸平移至 <海拔高度>
<heading> - 沿著「Z」軸旋轉。
<tilt> - 圍繞「X」軸。
<roll> - 再旋轉「Z」軸。

請注意，每次套用旋轉方向時，兩個相機軸的方向都會改變方向。

相機專用的元素

<longitude>

虛擬相機的經度 (眼點)。相對於本初子午線的角度距離角度。Meridian 西方的值介於 -180 到 0 度之間。梅里達文的東方值介於 0 到 180 度之間。

<latitude>

虛擬相機的位置。度量等於赤道以南或南度 (0 度)。這個值的範圍介於 -90 度到 90 度之間。

<altitude>

相機與地球表面之間的距離，單位為公尺。依照相機的 <海拔高度模式> 或 <gx:海拔高度模式> 解讀。

<heading>

攝影機的方向 (方位角度)，以度為單位。Default=0 (true North)。(請參閱圖表)。範圍從 0 到 360 度。

<tilt>

相機沿著 X 軸旋轉的度數 (以度為單位)。如果這個值為 0，表示將檢視畫面直接朝向地球 (最常見的情況)。如果 <tilt> 的值為 90，表示檢視畫面正以水平顯示。如果值超過 90，表示檢視畫面指向天空。<tilt> 的值會固定在 +180 度以上。

<roll>

相機沿著 Z 軸旋轉的度數 (以度為單位)。這個值的範圍介於 -180 至 +180 度之間。

<altitudeMode>

指定系統為相機指定的 <海拔高度> 的解讀方式。可能的值如下：

relativeToGround - (預設) 將 <height> 解讀為地面上公尺內的值。如果該點超過水位，系統會將 <海拔高度> 解讀為高於海平面的公尺值。請參閱下方的 <gx:heightMode> 來指定相對於海平面的點。
clampToGround - 對相機而言，這項設定也會將相機放置在 relativeToGround，因為將相機置於地形高度時，表示眼睛與地形相交 (檢視區塊也會遭到封鎖)。
絕對 - 將 <海拔高度> 的值呈現為高於海平面的單位值。

<gx:heightMode>

Google 擴充功能命名空間中的 KML 擴充功能，可讓海拔高度相對高於海底。可能的值如下：

relativeToSeaFloor - 將 <height> 解譯為海平面上方的公尺。如果點位於陸上而非海平面，系統會將 <海拔高度> 解讀為地面上方。
clampToSeaFloor - 系統會忽略 <Elevation> 規格，且攝影機會放置在海床上。如果攝影機位於陸上而非海上，攝影機就會定位在地面上。

擴充

<摘要檢視>

包含

從 <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>，如下所示。

如要隨機選取顏色，請指定白色 (ffffffff) 的基礎 <color>。
如果您指定一個單一色彩元件 (例如，red 的值為 ff0000ff)，系統會選取該元件 (紅色) 的隨機色彩值。在這個範例中，這個值的範圍介於 00 (black) 到 ff (full red) 之間。
如果您針對這兩個顏色元件指定值，或是同時為這三種色彩元件指定任何隨機線性比例，則系統會隨機套用線性比例比例，並將結果範圍從黑色到各元件的最大值。
色彩的不透明度來自 <color> 的 alpha 元件，且永遠不會隨機產生。

擴充

<物件>

擴充者

<圖示樣式>
<LabelStyle>
<LineStyle>
<PolyStyle>

返回頁首

<容器

語法

<!-- 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 檔案中使用。容器元素包含一或多項特徵，並允許建立巢狀階層。

擴充

<功能>

擴充者

<文件>
<資料夾>

返回頁首

<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>

說明

文件是一種功能與樣式的容器，如果您的 KML 檔案使用了共用樣式，則此為必要元素。建議您使用共用樣式，因此必須完成以下步驟：

定義文件中的所有樣式。為每個樣式指定專屬的 ID。

在特定 Feature 或 StyleMap 中，使用 <styleUrl> 元素參照樣式的 ID。

請注意，文件中的功能不會沿用共用樣式。

每項功能都必須明確參照 <styleUrl> 元素中使用的樣式。如果是文件適用的樣式 (例如 ListStyle)，文件本身必須明確參照 <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 資料類型以秒計算。

時間長度和 <gx:FlyTo>

如果 <gx:FlyTo> 元素中含有時間長度，就會指定瀏覽器從上一個點到指定點之間經過的時間。

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

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

時間長度及 <gx:AnimatedUpdate>

指定更新作業的時間長度。整數、浮點及顏色欄位會在整個期間順暢地以原始格式繪製到新的值；布林 (值)、字串 (及其他) 與內插值無關的值則會在持續時間結束時更新。

<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、地標、GroundOverlay、PhotoOverlay、ScreenOverlay、文件、資料夾)。這些技巧就是

使用 <Data> 元素新增未輸入的資料/值組合 (基本)
使用 <Schema> 元素宣告新的輸入欄位，然後使用 <SchemaData> 元素 (進階) 進行欄位解析
參照 KML 檔案中的外部命名空間 (基本) 參照其他命名空間定義的 XML 元素

這些技巧可以結合在單一 KML 檔案或功能中，針對不同的資料進行組合。

如需詳細資訊，請參閱「KML 主題」中的新增自訂資料。

ExtendedData 專用的元素

<資料名稱 ="字串">

建立一個未命名的名稱/值組合。名稱可分為兩個版本：name 和 displayName。name 屬性可用來識別 KML 檔案中的檔案組合。當 Google 地球顯示格式正確的名稱 (含空格和 HTML 格式) 時，系統就會使用 displayName 元素。在 <BalloonStyle> 的 <text> 元素中，標記 $[name/displayName] 會換成 <displayName>。如果以這個格式取代 <Data> 元素的 name 屬性值 (例如 $[holeYardage])，屬性值會替換為 <value>。根據預設，「地標」名稱與說明框的組合將以 <value> 取代。

<顯示名稱>

選擇性的名稱格式設定版本，用於顯示用途。

<值>

資料集的值。

<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 schemaUrl="anyURI

這個元素會與 <Schema> 搭配使用，可在 KML 特徵中新增打字的自訂資料。結構定義元素 (由 schemaUrl 屬性識別) 會宣告自訂資料類型。實際資料物件 (「自訂資料」的「執行個體」) 是使用 SchemaData 元素來定義。

<schemaURL> 可以是完整網址、參照外部 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 元素是包含自訂資料的 Feature 子項。

<SimpleData name="string">: 這個元素會將值指派給由 name 屬性識別的自訂資料欄位。此自訂資料欄位的類型及名稱會在 <Schema> 元素中宣告。; 以下是定義兩個自訂資料元素的範例：

<命名空間名稱：<其他>>: 這個元素可讓您新增未輸入的自訂資料。請務必參照您檔案的 <KML> 元素中的命名空間前置字元，或是 <ExtendedData> 元素的屬性，並在每個資料元素的名稱前面加上命名空間前置字元。以這種方式新增的自訂資料會保留在 KML 檔案中，但「Google 地球」並不會以任何方式使用這些資料。並且隨檔案一起儲存。; 以下範例說明如何使用「camp」露營區的前置字串：

包含

從 <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 地球」中某個地圖項目的元素。

各項功能專用的元素

<name>

3D 檢視器中顯示的使用者定義文字，顯示為物件標籤 (例如地標、資料夾或 NetworkLink)。

<visibility>

布林值。指定當初始載入時地圖項目是否繪製在 3D 檢視器中。如要讓地圖項目顯示，其所有上階的 <visibility> 標記也必須設為 1。在「Google 地球」清單檢視中，每項功能都具備核取方塊，可讓使用者控制「功能」的顯示設定。

<open>

布林值。指定第一次載入「位置」面板時，文件或資料夾是關閉還是開啟。0=收合 (預設)，1=展開。另請參閱 <ListStyle>。這個元素僅適用於文件、資料夾和 NetworkLink。

<atom:author>

KML 2.2 支援新的元素，可在 KML 檔案中加入作者及相關網站的資料。這些資訊會顯示在地理搜尋結果中，包括「Google 地球」瀏覽器 (如「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:地址詳細資料>

採用 xAL 的結構化地址，或採用 eXtensible Address Language 的國際位址格式標準。KML 只會使用 <xal:AddressDetails> 進行 Google 地圖地理編碼。詳情請參閱 Google Maps API 說明文件。Google 地球目前尚未使用這項元素，請改用 <address>。請務必在任何使用此元素的 KML 檔案中納入此元素的命名空間：xmlns:xal="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"

<phoneNumber>

代表電話號碼的字串值。這個元素只會用於「Google 地圖行動版」。支援 Java 的行動電話符合業界標準 RFC2806。
詳情請參閱 http://www.ietf.org/rfc /rfc2806.txt。

<片段 maxLines="2" >

功能的簡短說明。在「Google 地球」中，這項說明會顯示在功能名稱下方的「地點」面板中。如未提供程式碼片段，則會使用 <description> 的前兩行。在「Google 地球」中，如果「地標」同時包含說明和程式碼片段，「地點」面板中的地標下方會顯示 <Snippet>，而「地標」的說明說明框中會顯示 <description>。這個標記不支援 HTML 標記。<snippet> 具有 maxLines 屬性，一個整數可以指定要顯示的行數上限。

<description>

顯示在說明框中的使用者提供內容。

<description> 元素的支援內容已從「Google 地球」4.3 版變更為「5.0 版」。以下列出各個版本的專屬資訊，以及兩者的常見資訊。

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() 和提示()等函式。但會將其寫入系統控制台，其他錯誤和例外狀況也會寫入系統控制台。

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 檔案，並且具有 .jpeg 或 .kmz 副檔名，則 Google 地球會在使用者點選檔案時直接載入。如果網址的結尾是 Google 地球無法辨識的擴充功能 (例如 .html)，系統會將網址傳送到瀏覽器。

href 可以是片段網址，也就是有 # 符號，後面接著 KML 識別碼的網址。當使用者點選包含片段網址的連結時，根據預設，瀏覽器會呼叫 ID 與片段相符的功能。如果「地圖項目」包含 LookAt 或相機元素，系統就會從指定的視角檢視該地圖項目。

您可以在片段網址附加下列三個字串中的其中一個，藉此進一步指定行為：

;flyto (預設) - 飛往功能
;balloon - 開啟這項功能的氣球，但不會飛向功能
;balloonFlyto - 開啟這項功能的氣球，飛向這項功能

舉例來說，下列程式碼表示開啟檔案 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 屬性並非以 .map 或 .kmz 結尾，因此 type 屬性用於 <a> 元素內，但必須以 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>

您可以定義一個或多個樣式和樣式的樣式，以自訂任何由「地標」或「幾何圖形」幾何圖形所衍生出的元素。(請參閱 <BalloonStyle>、<ListStyle>、<StyleSelector>、和 <ColorStyle> 衍生的樣式)。定義為 <Document> 子項的樣式稱為「共用樣式」。共用樣式必須具有已定義的 id。這個 ID 是由 <Document> 中的一個或多個特徵參照。如果在共用架構中以「樣式」定義樣式元素，也就是資料夾、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:導覽>

<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。

「流暢」FlyTos 允許不中斷 (或不限) 的不間斷航班。一系列順暢的 FlyTo 系列，將以零的速度開始和結束，而且在各個時間點都不會變慢。一系列光滑的 FlyTos 因下列任何元素而中斷：
- <gx:flyToMode>bounce</gx:flyToMode>
- <gx:Wait>
這表示在上述任一元素之前，流暢的 FlyTo 處理速率將為零。一系列順暢的 FlyTo 並不會因 <gx:AnimatedUpdate> 元素而中斷。

跳出每個 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>
<AbstractView>

<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>

說明

「資料夾」可用來安排其他「階層」項目 (「資料夾」、「地標」、「NetworkLinks」或「疊加層」)。僅可看見該地圖項目及其所有上階的特徵。

範例

<?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> 衍生的所有元素

<幾何圖形>

語法

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

說明

這是抽像元素，無法直接在 KML 檔案中使用。可為所有衍生的幾何圖形物件提供預留位置物件。

擴充

<物件>

擴充者

<點>
<LineString>
<線性方向>
<多邊形>
<多重幾何圖形>
<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>

指定系統如何解讀 <海拔高度>。可能的值包括：

clampToGround - (預設) 表示忽略高度規格，並重疊在地形上。
絕對 - 設定疊加層相對於海平面的高度，無論元素之下的地形實際海拔高度為何。例如，若您使用絕對高度模式將疊加層的高度設定為 10 公尺，當下方的地形也高於海平面 10 公尺時，疊加層將顯示為地面。如果地形距離海平面 3 公尺，在地形上方會出現 7 公尺的疊加層。

<gx:heightMode>

Google 擴充功能命名空間中的 KML 擴充功能，可讓海拔高度相對高於海底。可能的值如下：

relativeToSeaFloor - 將 <height> 解譯為海平面上方的公尺。如果點位於陸上而非海平面，系統會將 <海拔高度> 解讀為地面上方。
clampToSeaFloor - 系統會忽略 <Elevation> 規格，疊加層會重疊於海平面上。如果點位於地上 (而非大海)，疊加層會固定在地面上。

<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>

擴充

<功能>
<重疊>

包含

<文件>
<資料夾>

<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>

圖示專用的元素

<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>

包含

<區域疊加層>
<螢幕重疊廣告>
<圖示樣式>

<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 值是圖示的一小部分，像素的值表示以像素表示的 x 值。insetPixels 值表示從圖示右側邊緣縮排。
yunits - 指定 y 值的單位。fraction 值表示 y 值為圖示的一小部分。像素的值表示以 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>

擴充

<顏色樣式>

包含

<樣式>

包含

<href> 作為 <Icon> 的子項

<kml>

語法

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

說明

KML 檔案的根元素。此元素為必填欄位。其以檔案開頭的 XML 宣告為依據。提示屬性可用來當做 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>

說明

指定地圖項目的 <name> 在 3D 檢視器中如何繪製。您可以為標籤 (名稱) 指定自訂色彩、色彩模式和縮放比例。

注意：<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>

擴充

<顏色樣式>

包含

<樣式>

<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>

擴充

<物件>

包含

<區域疊加層>

<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 地球」中，具有 <ElevationMode> 的 clampToGround 路徑的多邊形會跟隨常駐航線；但是，如果 <高度模式> 為 clampToGround 的 LinearRing 會跟隨大圓線。

LinearRing 專屬的元素

<gx:heightOffset>

Google 擴充功能命名空間中的 KML 擴充功能，可用來修改高度值的顯示方式。此偏移可讓您將整個 LinearRing 上下移動，而不修改構成 LinearRing 的所有個別座標值。(雖然 LinearRing 使用高度偏移值顯示，但是原始高度值會保留在 KML 檔案中)。單位為公尺。

<extrude>

布林值。指定是否要將 LinearRing 連接至地面。因此，海拔高度模式必須是 relativeToGround、relativeToSeaFloor 或絕對。只有 LinearRing 的頂點會擴開，而不是幾何圖形的中心。頂點會朝著地球球中心延伸。

<tessellate>

布林值。指定是否允許 LinearRing 追蹤地形。必須啟用 clampToGround 或是 clampToSeaFloor，才能啟用 <ElevationMode> 的值。非常大的 LinearRings 應該啟用紋路，讓它們跟隨地球的彎曲度 (否則可能會被進入地下隱形)。

<altitudeMode>

指定 <座標 s 元素中的 海拔高度 元件的解讀方式。可能的值包括：

clampToGround - (預設) 表示忽略高度規格 (例如，<協調中心 s>代碼)。
relativeToGround - 設定元素相對於特定位置的實際地面高度的高度。例如，如果一個位置的地面高度剛好落在海平面，而該點的海拔高度設定為 9 公尺，則使用此模式時，圖示地標海拔高度的高度為 9 公尺。但是，如果將相同座標設為地面高度為海拔 10 公尺的位置，則座標座標為 19 公尺。這個模式的常見用途是放置電話桿或滑雪纜車。
絕對 - 設定座標相對於海平面的高度，不論元素下方地形的實際海拔高度為何。舉例來說，如果您使用絕對的高度模式將座標設為 10 公尺，當下方的地形也高於海平面 10 公尺時，點地標圖示將顯示為地面。如果地形比海平面高 3 公尺，地標上方將比平地高 7 公尺。飛機通常用於這個模式。

<gx:heightMode>

Google 擴充功能命名空間中的 KML 擴充功能，可讓海拔高度相對高於海底。可能的值如下：

relativeToSeaFloor - 將 <height> 解譯為海平面上方的公尺。如果點位於陸上而非海平面，系統會將 <海拔高度> 解讀為地面上方。
clampToSeaFloor - 系統會忽略 <height> 規格，並將該點放置在海平面上。如果該點位於陸上而非海上，則該點會置於地面上。

<座標> (必填)

4 個以上的元組，每個包含由經度、緯度和高度的浮點值。海拔高度是選用元件。請勿在元組內加入空格。最後一個座標必須與第一個座標相同。座標僅以小數表示。

<SimpleField type="string" name="string">: 自訂欄位的宣告，且必須同時指定這個欄位的「類型」和「名稱」。如果省略 type 或 name，系統會忽略這個欄位。type 可以是以下其中一種：

string

int

Uint

short

UShort

浮動

雙精度值

bool; <顯示名稱>

用於向 Google 地球使用者顯示欄位名稱時使用的名稱 (如果有的話)。請使用 [CDATA] 元素來逸出標準 HTML 標記。